# Ejecuciones y estadísticas de las automatizaciones

> Sigue las ejecuciones de una automatización, lee la vista general y las estadísticas por paso, 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 averiguar por qué ha fallado una ejecución y cómo leer los mismos datos con la API.

## Pestaña Overview

Abre una automatización desde **Email Marketing → Automations**. 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**). |
| Call webhook (API) | **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** y **Failed**. |

En los emails de las automatizaciones no se hace seguimiento de cargas ni clics, así que **Opened** y **Clicked** se quedan en 0. Consulta [Send email](/es/docs/automations/steps/#send-email).

## 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ó, 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, y cada paso por el que ha pasado, en orden, con el estado 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 **Wait**. |
| **Completed** | Todos los pasos de su recorrido han terminado. |
| **Failed** | Ha fallado un paso, o el espacio de trabajo no tenía créditos suficientes para iniciar la ejecución. |
| **Canceled** | La automatización se detuvo con la API mientras la ejecución estaba en curso. |

## Depurar una ejecución fallida

1. **Busca las ejecuciones fallidas.** En la pestaña **Runs**, filtra por **Status** `failed`.

2. **Abre una ejecución.** El paso que ha fallado aparece marcado en rojo.

3. **Lee el error.** Despliega **Output data** en el paso fallido. El campo `error` indica qué ha ido mal, por ejemplo `send_email: Sending domain is not verified or not found`. Para los errores habituales y cómo solucionarlos, consulta [Cuando falla un paso](/es/docs/automations/steps/#when-a-step-fails).

4. **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](/es/docs/billing/credits/) o activa la [recarga automática](/es/docs/billing/auto-refill/) 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 **Wait**. Ábrela para ver en qué paso está.

## Usar la API

[Listar ejecuciones](/es/docs/api-reference/automations/runs/) 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 pagina con `page` y `per_page` (hasta 100):

```bash
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"
```

```json
{
  "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",
      "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](/es/docs/api-reference/automations/run/) añade `run_steps`, con el `step_id`, el `status`, los `data` (la salida, incluido cualquier `error`), `started_at` y `completed_at` de cada paso.

[Obtener estadísticas](/es/docs/api-reference/automations/stats/) 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](/es/docs/api-reference/automations/step-stats/) devuelve las estadísticas de un solo paso:

```json
{
  "data": {
    "send_email-1": {
      "total": 120,
      "by_status": { "completed": 118, "failed": 2 },
      "by_outcome": { "delivered": 110, "bounced": 3, "accepted": 5, "error": 2 },
      "funnel": { "accepted": 115, "delivered": 110, "loaded": 0, "clicked": 0, "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**.

## Ver también

  - [Pasos](/es/docs/automations/steps/): Ajustes de los pasos y errores habituales.
  - [Descripción general de las automatizaciones](/es/docs/automations/): Estados, créditos y la API.

---
Fuente: https://emailit.com/es/docs/automations/runs/