# Automatizace

> Automatizace provádějí kroky, například odeslání e-mailu, čekání nebo úpravu kontaktu, když se aktivuje spouštěč. Seznamte se s kontexty, stavy, spuštěními, kredity a API.

Automatizace je workflow, které se spouští samo: když se aktivuje spouštěč, například když se kontakt přidá do seznamu kontaktů nebo když se e-mail nedoručí, Emailit zahájí spuštění, které projde kroky, jež jste propojili, například odešle e-mail, den počká nebo upraví kontakt. Automatizace používejte pro uvítací e-maily, onboardingové sekvence, narozeninové e-maily, přeposílání a upozornění.

> **Automatizace jsou v betaverzi:** Automatizace fungují v každém workspace, ale některé možnosti se ještě dokončují. Kde se webové rozhraní a API liší, tyto stránky to uvádějí.

## Jak to funguje

1. **Aktivuje se spouštěč.** Každá automatizace začíná jedním spouštěčem, například **Added to audience**. Volitelné filtry ho zužují.
2. **Emailit zahájí spuštění** pro kontakt nebo e-mail, který ho vyvolal, a účtuje 3 kredity.
3. **Spuštění prochází kroky** napojené na spouštěč, jeden po druhém. Kroky **Wait** spuštění pozastaví a kroky **Condition** ho pošlou do větve **Yes**, nebo **No**.
4. **Spuštění skončí**, když dojde k poslednímu kroku své větve, nebo selže, pokud selže některý krok.

Postup sestavíte na plátně ve webovém rozhraní, nebo ho pošlete do API jako seznam kroků a propojení. Viz [Spouštěče](/cs/docs/automations/triggers/) a [Kroky](/cs/docs/automations/steps/).

## Kontexty

Každá automatizace má kontext, který určuje, čeho se spuštění týká a které spouštěče a kroky jsou k dispozici. Zvolíte ho při vytváření automatizace a později ho nelze změnit.

| Kontext | Označení | Každé spuštění se týká | Vhodné pro | Spouštěče |
| --- | --- | --- | --- | --- |
| **Contact** | Easy | Jednoho kontaktu | Uvítací série, onboarding, opětovné zapojení | Členství v seznamu kontaktů, změny kontaktu, výročí dat |
| **Email** | Medium | Jednoho e-mailu | Zpracování odpovědí, automatické přeposílání, upozornění na nedoručení | Události e-mailů, například doručení, nedoručení nebo přijetí |
| **Event** | Advanced | Jednoho volání API | Postupy řízené přes API, vlastní integrace | Ruční spouštěč, který voláte přes API |

Ve webovém rozhraní má kontext **Event** označení **Soon** a zatím ho nelze vybrat. Automatizace v kontextu Event můžete vytvořit přes API.

## Vytvořte automatizaci

1. **Začněte.** Otevřete **Email Marketing → Automations** a vyberte **New automation**.

2. **Zvolte kontext.** Vyberte **Contact**, nebo **Email**.

3. **Zvolte šablonu.** Vyberte jeden z [připravených receptů](/cs/docs/automations/recipes/), nebo **Start from scratch** pro prázdné plátno jen se spouštěčem.

4. **Pojmenujte ji.** Do pole **Name** zadejte název, volitelně vyplňte **Description** a vyberte **Create**. Automatizace se otevře jako koncept.

5. **Sestavte postup.** Na kartě **Editor** vyberte spouštěč a jednotlivé kroky a nastavte je. Další kroky přidáte tlačítky plus. Vyberte **Save**.

6. **Zapněte ji.** Vyberte **Start**. Od této chvíle každý odpovídající spouštěč zahájí spuštění.

Stránka se seznamem má karty pro automatizace **Contact**, **Email** a **Event** a u každé ukazuje **Name**, **Status**, čas **Last triggered** a datum **Created**.

## Stavy

| Stav | Spouštěče zahajují spuštění | Lze upravovat ve webovém rozhraní | Jak se do stavu dostat |
| --- | --- | --- | --- |
| **Draft** | Ne | Ano | Každá nová automatizace začíná jako koncept. |
| **Running** | Ano | Ne | Vyberte **Start** u konceptu nebo pozastavené automatizace. |
| **Paused** | Ne | Ano | Vyberte **Pause** u běžící automatizace. **Start** ji obnoví. |
| **Stopped** | Ne | Ne | Jen přes endpoint API [stop](/cs/docs/api-reference/automations/stop/), který také zruší všechna probíhající spuštění. |

Pozastavení zabrání zahájení nových spuštění, ale už probíhající spuštění pokračují, včetně těch, která čekají v kroku **Wait**. **Delete** v nabídce v horní části automatizace ji odstraní v jakémkoli stavu.

### Pravidla úprav

Karta **Editor** je dostupná, jen když je automatizace konceptem nebo je pozastavená. U běžící automatizace karta ukazuje **Pause to edit**.

**Save** zkontroluje celý postup a zvýrazní kroky, které vyžadují pozornost, například krok **Send email** bez šablony nebo čekání delší než 30 dní. Opravte je a před výběrem **Start** automatizaci znovu uložte: zapnutí kontroly znovu nespustí.

## Spuštění

Spuštění je jeden průchod automatizací pro jeden kontakt, e-mail nebo volání API. Každé spuštění má stav:

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

Ve výchozím stavu každý spouštěč zahájí nové spuštění, i když stejný kontakt nebo e-mail už jedno probíhající spuštění má. Stejná událost nikdy nezahájí dvě spuštění jedné automatizace. Historii spuštění a ladění popisuje stránka [Spuštění a statistiky automatizací](/cs/docs/automations/runs/).

## Kredity

| Akce | Kredity |
| --- | --- |
| Každé spuštění | 3, účtují se při zahájení spuštění |
| Každý e-mail odeslaný krokem **Send email** | 1 |
| Každý e-mail odeslaný krokem **Forward email** | 1 |

Pokud workspace v okamžiku aktivace spouštěče nemá 3 kredity, spuštění se vytvoří ve stavu **Failed** s důvodem `insufficient_credits` v poli `meta`. Pokud kredity dojdou uprostřed spuštění, krok **Send email** nebo **Forward email** selže. Viz [Kredity](/cs/docs/billing/credits/).

## Práce s API

[API automatizací](/cs/docs/api-reference/automations/) spravuje automatizace a čte jejich spuštění. Potřebuje API klíč s oprávněním **Full Access**.

| Endpoint | K čemu slouží |
| --- | --- |
| [Vytvoření](/cs/docs/api-reference/automations/create/), [úprava](/cs/docs/api-reference/automations/update/), [načtení](/cs/docs/api-reference/automations/get/), [výpis](/cs/docs/api-reference/automations/list/) a [smazání](/cs/docs/api-reference/automations/delete/) | Správa automatizací. Kroky a propojení se posílají společně. |
| [Zapnutí](/cs/docs/api-reference/automations/start/), [pozastavení](/cs/docs/api-reference/automations/pause/) a [zastavení](/cs/docs/api-reference/automations/stop/) | Změna stavu. |
| [Ruční spuštění](/cs/docs/api-reference/automations/trigger/) | Aktivuje spouštěč **Manual**, volitelně s `payload`. Automatizace musí běžet. Je to možné jen přes API. |
| [Výpis spuštění](/cs/docs/api-reference/automations/runs/), [načtení spuštění](/cs/docs/api-reference/automations/run/), [statistiky](/cs/docs/api-reference/automations/stats/) a [statistiky kroků](/cs/docs/api-reference/automations/step-stats/) | Čtení historie spuštění a výsledků jednotlivých kroků. |

API také přijímá `settings` automatizace, které webové rozhraní zatím neukazuje:

| Nastavení | Výchozí hodnota | Účinek |
| --- | --- | --- |
| `allow_reentry` | `true` | S hodnotou `false` se přeskočí nová spuštění pro kontakt nebo e-mail, který už má probíhající spuštění. |
| `max_concurrent_runs` | `0` (bez limitu) | Přeskakuje nová spuštění, dokud jich probíhá tento počet. |
| `cooldown_seconds` | `0` | Přeskočí nová spuštění pro kontakt nebo e-mail, pro který začalo spuštění během posledních tolika sekund. |
| `on_step_failure` | `stop` | `stop` při selhání kroku ukončí spuštění jako neúspěšné. `skip` nechá spuštění pokračovat. |

Přeskočená spuštění se nevytvoří a nespotřebují kredity.

```bash
curl https://api.emailit.com/v2/automations \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "context": "contact",
    "name": "Welcome email",
    "settings": { "allow_reentry": false },
    "steps": [
      { "key": "trigger-1", "type": "trigger", "trigger": "contact.added_to_audience", "config": { "audience_id": "aud_5hJ2kL8mNp4Qr" } },
      { "key": "send_email-1", "type": "action", "action": "send_email", "config": { "type": "template", "template_id": "welcome" } }
    ],
    "connections": [
      { "from": "trigger-1", "to": "send_email-1", "branch": "default" }
    ]
  }'
```

Automatizace se vytvoří jako koncept. Zapnete ji endpointem [Zapnutí automatizace](/cs/docs/api-reference/automations/start/).

## Další kroky

  - [Spouštěče](/cs/docs/automations/triggers/): Všechny spouštěče a jejich možnosti.
  - [Kroky](/cs/docs/automations/steps/): Všechny kroky, jejich nastavení a jak fungují větve.
  - [Recepty](/cs/docs/automations/recipes/): Šest připravených šablon.
  - [Spuštění a statistiky](/cs/docs/automations/runs/): Sledujte spuštění a hledejte příčiny selhání.

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