Guía práctica
Ejecuciones y estadísticas de las automatizaciones
Sigue las ejecuciones de una automatización, lee la vista general y las estadísticas por paso, cancela ejecuciones, depura las ejecuciones fallidas y obtén las ejecuciones y las estadísticas con la API.
Cada vez que se activa un disparador, la automatización crea una ejecución. Esta página muestra dónde ver las ejecuciones y sus resultados, qué significan las estadísticas de cada paso, cómo cancelar una ejecución, cómo averiguar por qué ha fallado una ejecución y cómo hacer lo mismo con la API.
Pestaña Overview
Abre una automatización desde Email MarketingAutomations. La pestaña Overview muestra:
- Los recuentos Total executions, Completed, Failed y Running.
- Un diagrama del flujo de solo lectura. Selecciona cualquier paso para ver sus Stats.
- Edit, que abre el editor mientras la automatización está en borrador o en pausa.
Mientras la automatización está en marcha, las cifras se actualizan cada 10 segundos.
Estadísticas por paso
Las Stats de cada paso cuentan cuántas ejecuciones han llegado a él y qué ha pasado allí. Lo que ves depende del paso:
| Paso | Estadísticas |
|---|---|
| Send email | Un embudo de Accepted, Delivered, Opened y Clicked, cada uno como proporción de los emails aceptados, más los recuentos de Bounced, Failed, Complained y Unsubscribed. Los recuentos siguen cada email después de que el paso lo envíe. |
| Condition (If/Else) | Matched (la ejecución tomó Yes) y Not matched (tomó No). |
| Webhook | 2xx Success, 4xx Client Error, 5xx Server Error, Timeout y Network Error. |
| Random split (API) | Ejecuciones por variante. |
| Cualquier otro paso | Ejecuciones por estado, como Completed, Waiting, Skipped y Failed. |
Opened y Clicked cuentan cuando el dominio de envío hace seguimiento de las cargas y los clics. Los emails de marketing omitidos porque el contacto se ha dado de baja tienen el resultado skipped. Los resultados de un paso Wait until son matched y timeout, y los de un Goal, reached y not_reached.
Pestaña Runs
La pestaña Runs lista todas las ejecuciones, de más reciente a más antigua, con su Status, el Event que la inició, el Contact, una Note que explica por qué se detuvo una ejecución cancelada, cuándo empezó (Started) y cuándo terminó (Completed), y la Duration. Puedes filtrar por estado, evento o fecha de creación.
Selecciona una ejecución para ver sus detalles: su estado, las horas de inicio y fin, qué está esperando y cada paso por el que ha pasado, en orden, con el estado, el resultado y la duración del paso. Despliega Output data en un paso para ver lo que devolvió, como el ID del email que envió, la rama que tomó una condición o el error que lo hizo fallar.
| Estado de la ejecución | Significado |
|---|---|
| Running | Está recorriendo sus pasos o esperando en un paso Time delay o Wait until. |
| Completed | Ha llegado al final de su recorrido o a un paso End automation, o ha pasado a otra automatización. |
| Failed | Ha fallado un paso, o el espacio de trabajo no tenía créditos suficientes para iniciar la ejecución. |
| Canceled | Se ha detenido antes de tiempo. La Note indica el motivo: Met an exit condition, Left the audience, Canceled by a user, Removed with the API, Removed by another automation, Automation stopped o Contact deleted. |
Los pasos omitidos porque la ejecución saltó a un objetivo aparecen como skipped.
Cancelar una ejecución
Para sacar a un contacto de una automatización, abre su ejecución en la pestaña Runs y selecciona Cancel run. Sus pasos en espera se cancelan y no se ejecuta ningún paso más. Las ejecuciones canceladas no se pueden reanudar; un disparador nuevo inicia una ejecución nueva.
Con la API:
- Cancelar una ejecución:
POST /v2/automations/{id}/runs/{run_id}/cancel, con unreasonopcional. - Quitar un contacto de una automatización:
POST /v2/automations/{id}/exitconcontact_idoemailcancela todas las ejecuciones de ese contacto en la automatización, por ejemplo desde tu tienda cuando se paga un pedido. - Listar las ejecuciones de un contacto:
GET /v2/automations/runs?email=…muestra en qué automatizaciones está un contacto.
Para hacerlo automáticamente, usa en su lugar condiciones de salida.
Depurar una ejecución fallida
-
Busca las ejecuciones fallidas. En la pestaña Runs, filtra por Status
failed. -
Abre una ejecución. El paso que ha fallado aparece marcado en rojo.
-
Lee el error. Despliega Output data en el paso fallido. El campo
errorindica qué ha ido mal, por ejemplosend_email: Sending domain is not verified or not found. Para los errores habituales y cómo solucionarlos, consulta Cuando falla un paso. -
Corrige la causa. Si es un ajuste del paso, selecciona Pause, corrige el paso en la pestaña Editor, selecciona Save y después Start. Si es un problema del espacio de trabajo, como falta de créditos o un dominio sin verificar, corrígelo en Workspace o Email API.
Una ejecución fallida sin pasos suele haber fallado porque el espacio de trabajo no tenía los 3 créditos necesarios para iniciarla. Con la API, su meta muestra "failure_reason": "insufficient_credits". Recarga créditos o activa la recarga automática para que las ejecuciones no fallen.
Las ejecuciones fallidas no se reintentan. Los disparadores nuevos inician ejecuciones nuevas como de costumbre. Para volver a ejecutar la automatización para un contacto o email que ha fallado, vuelve a activar su disparador, por ejemplo quitando el contacto de la lista y añadiéndolo de nuevo.
Una ejecución que se queda en Running mucho tiempo suele estar en un paso Time delay o Wait until. Ábrela para ver en qué paso está y qué está esperando.
Usar la API
Listar ejecuciones devuelve las ejecuciones de una automatización, de más reciente a más antigua. Filtra con filter[status] (running, completed, failed o canceled) y filter[contact_id], y pagina con page y per_page (hasta 100):
curl -G "https://api.emailit.com/v2/automations/aut_3Mv8Xq2nKp5Lt/runs" \
--data-urlencode "filter[status]=failed" \
--data-urlencode "per_page=25" \
-H "Authorization: Bearer $EMAILIT_API_KEY"{
"data": [
{
"id": "aur_7Kp2Vx9mQt4Lw",
"automation_id": "aut_3Mv8Xq2nKp5Lt",
"contact_id": "con_2kq8Vt4xLm7Rz",
"email_id": null,
"event_id": null,
"event": "contact.added_to_audience",
"payload": { "object": { "id": "sub_7Rt2vX9kLm3Qp", "object": "subscriber" } },
"meta": { "source_event_id": "evt_2Hn6Wq8rTc3Mz" },
"status": "failed",
"cancel_reason": null,
"started_at": "2026-10-01T09:30:00Z",
"completed_at": "2026-10-01T09:30:02Z",
"created_at": "2026-10-01T09:30:00Z",
"updated_at": "2026-10-01T09:30:02Z"
}
],
"total_records": 1,
"per_page": 25,
"current_page": 1,
"total_pages": 1
}Obtener una ejecución añade run_steps, con el step_id, la step_key, la action, el status, el outcome, los data (la salida, incluido cualquier error), started_at y completed_at de cada paso, y waits, los pasos Wait until y Goal en los que la ejecución espera o ha esperado, con lo que esperan (kind, event), su status y su timeout_at.
Obtener estadísticas devuelve las estadísticas de todos los pasos, indexadas por clave de paso. Acótalas con since y until (ISO 8601) o con run_ids[]. Obtener estadísticas de un paso devuelve las estadísticas de un solo paso:
{
"data": {
"send_email-1": {
"total": 120,
"by_status": { "completed": 118, "failed": 2 },
"by_outcome": { "accepted": 5, "delivered": 58, "loaded": 43, "clicked": 9, "bounced": 3, "error": 2 },
"funnel": { "accepted": 115, "delivered": 110, "loaded": 52, "clicked": 9, "bounced": 3, "failed": 0, "complained": 0, "unsubscribed": 0 }
}
}
}by_status cuenta cómo terminó el paso en cada ejecución. by_outcome cuenta sus resultados, como el último estado del email que envió o matched y not_matched en una condición. funnel aparece en los pasos Send email.