# Spuštění a statistiky automatizací

> Sledujte spuštění automatizace, čtěte přehled a statistiky jednotlivých kroků, laďte neúspěšná spuštění a načítejte spuštění a statistiky přes API.

Pokaždé, když se aktivuje spouštěč, automatizace vytvoří spuštění. Tato stránka ukazuje, kde najdete spuštění a jejich výsledky, co znamenají statistiky jednotlivých kroků, jak zjistit, proč spuštění selhalo, a jak stejná data načíst přes API.

## Karta Overview

Otevřete automatizaci v **Email Marketing → Automations**. Karta **Overview** ukazuje:

- Počty **Total executions**, **Completed**, **Failed** a **Running**.
- Diagram postupu jen pro čtení. Když vyberete libovolný krok, zobrazí se jeho **Stats**.
- Tlačítko **Edit**, které otevře editor, dokud je automatizace koncept nebo je pozastavená.

Dokud automatizace běží, čísla se obnovují každých 10 sekund.

## Statistiky kroků

**Stats** každého kroku počítají, kolik spuštění se ke kroku dostalo a co se v něm stalo. Co uvidíte, závisí na kroku:

| Krok | Statistiky |
| --- | --- |
| **Send email** | Trychtýř **Accepted**, **Delivered**, **Opened** a **Clicked**, každý jako podíl z přijatých e-mailů, a k tomu počty **Bounced**, **Failed**, **Complained** a **Unsubscribed**. Počty sledují každý e-mail i poté, co ho krok odeslal. |
| **Condition (If/Else)** | **Matched** (spuštění pokračovalo větví **Yes**) a **Not matched** (pokračovalo větví **No**). |
| Call webhook (API) | **2xx Success**, **4xx Client Error**, **5xx Server Error**, **Timeout** a **Network Error**. |
| Random split (API) | Počet spuštění pro každou variantu. |
| Všechny ostatní kroky | Počet spuštění podle stavu, například **Completed**, **Waiting** a **Failed**. |

U e-mailů z automatizací se načtení a prokliky neměří, takže **Opened** a **Clicked** u nich zůstávají na 0. Viz [Send email](/cs/docs/automations/steps/#send-email).

## Karta Runs

Karta **Runs** uvádí všechna spuštění od nejnovějšího. U každého ukazuje sloupec **Status**, ve sloupci **Event** událost, která spuštění zahájila, ve sloupcích **Started** a **Completed** časy zahájení a dokončení a ve sloupci **Duration** dobu trvání. Filtrovat můžete podle stavu, události nebo data vytvoření.

Když vyberete spuštění, zobrazí se jeho detail: stav, čas zahájení a ukončení a v pořadí všechny kroky, kterými prošlo, se stavem a dobou trvání každého kroku. Když u kroku rozbalíte **Output data**, uvidíte, co krok vrátil, například ID e-mailu, který odeslal, větev, kterou zvolila podmínka, nebo chybu, kvůli které krok selhal.

| Stav spuštění | Význam |
| --- | --- |
| **Running** | Prochází kroky, nebo čeká v kroku **Wait**. |
| **Completed** | Všechny kroky na jeho cestě skončily. |
| **Failed** | Některý krok selhal, nebo workspace neměl dost kreditů na zahájení spuštění. |
| **Canceled** | Automatizace byla zastavena přes API, zatímco spuštění probíhalo. |

## Odlaďte neúspěšné spuštění

1. **Najděte neúspěšná spuštění.** Na kartě **Runs** vyfiltrujte **Status** `failed`.

2. **Otevřete spuštění.** Krok, který selhal, je označený červeně.

3. **Přečtěte si chybu.** Rozbalte **Output data** u kroku, který selhal. Pole `error` uvádí, co se pokazilo, například `send_email: Sending domain is not verified or not found`. Časté chyby a jejich řešení najdete v části [Když krok selže](/cs/docs/automations/steps/#when-a-step-fails).

4. **Odstraňte příčinu.** Pokud jde o nastavení kroku, vyberte **Pause**, opravte krok na kartě **Editor**, vyberte **Save** a pak **Start**. Pokud jde o problém workspace, například chybějící kredity nebo neověřenou doménu, vyřešte ho v sekci **Workspace** nebo **Email API**.

Spuštění, které selhalo bez jediného kroku, obvykle selhalo proto, že workspace neměl 3 kredity potřebné k jeho zahájení. V API pak jeho `meta` obsahuje `"failure_reason": "insufficient_credits"`. [Dokupte kredity](/cs/docs/billing/credits/), nebo zapněte [automatické dobíjení](/cs/docs/billing/auto-refill/), aby spuštění neselhávala.

Neúspěšná spuštění se neopakují. Nové aktivace spouštěčů zahajují nová spuštění jako obvykle. Pokud chcete automatizaci znovu spustit pro kontakt nebo e-mail, u kterého selhala, vyvolejte jeho spouštěč znovu, například tak, že kontakt ze seznamu kontaktů odeberete a znovu ho přidáte.

Spuštění, které zůstává dlouho ve stavu **Running**, obvykle čeká v kroku **Wait**. Otevřete ho a uvidíte, na kterém kroku je.

## Práce s API

[Výpis spuštění](/cs/docs/api-reference/automations/runs/) vrací spuštění automatizace od nejnovějšího. Filtrujte parametrem `filter[status]` (`running`, `completed`, `failed` nebo `canceled`) a stránkujte parametry `page` a `per_page` (až 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
}
```

[Načtení spuštění](/cs/docs/api-reference/automations/run/) navíc vrací `run_steps`, kde má každý krok pole `step_id`, `status`, `data` (výstup včetně případného `error`), `started_at` a `completed_at`.

[Načtení statistik](/cs/docs/api-reference/automations/stats/) vrací statistiky všech kroků podle klíče kroku. Zúžit je můžete parametry `since` a `until` (ISO 8601) nebo `run_ids[]`. [Načtení statistik kroků](/cs/docs/api-reference/automations/step-stats/) vrací statistiky jednoho kroku:

```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` počítá, jak krok v jednotlivých spuštěních skončil. `by_outcome` počítá jeho výsledky, například poslední stav e-mailu, který odeslal, nebo `matched` a `not_matched` u podmínky. `funnel` se uvádí u kroků **Send email**.

## Související

  - [Kroky](/cs/docs/automations/steps/): Nastavení kroků a časté chyby.
  - [Přehled automatizací](/cs/docs/automations/): Stavy, kredity a API.

---
Zdroj: https://emailit.com/cs/docs/automations/runs/