Princip

Události

Procházejte události, které Emailit zaznamenává pro váš workspace, ve webovém rozhraní nebo přes Events API a použijte je k doplnění nebo sesouhlasení webhooků.

Aktualizováno 1. 10. 2026

Událost je záznam o tom, že se ve vašem workspace něco stalo: e-mail byl doručen, někdo klikl na odkaz, na vaši příchozí subdoménu dorazila zpráva, vznikl kontakt. Emailit ukládá každou událost, zobrazuje je ve webovém rozhraní a sestavuje z nich každý požadavek webhooku. Tato stránka vysvětluje, jak události procházet a číst přes API.

Co událost obsahuje

Pole	Popis
`id`	ID události začínající na `evt_`. V požadavcích webhooků se jmenuje `event_id`.
`type`	Co se stalo, například `email.delivered` nebo `contact.created`. Viz Typy událostí.
`data.object`	Zdroj, kterého se událost týká, například e-mail, proklik, doména nebo kontakt, ve stavu z okamžiku události.
`created_at`	Kdy byla událost zaznamenána.

JSON

{
  "object": "event",
  "id": "evt_2xGk7Nq1VbD5sR8tLmW3eYhC6aP",
  "type": "email.delivered",
  "data": {
    "object": {
      "id": "em_2xGk7Lr3XcB8pQ1wYzK4dTfG9hJ",
      "object": "email",
      "from": "billing@acme.com",
      "to": "ada@example.com",
      "subject": "Your receipt #1042",
      "status": "delivered",
      "meta": { "order_id": "1042" },
      "updated_at": "2026-10-01T09:14:03.512000+00:00",
      "created_at": "2026-10-01T09:14:01.207000+00:00"
    }
  },
  "created_at": "2026-10-01T09:14:03.540000+00:00"
}

Události a webhooky

Události jsou zdrojem požadavků webhooků. Když Emailit zaznamená událost, zařadí do fronty požadavek pro každý zapnutý webhook, který odebírá daný typ události a jehož filtr obsahu odpovídá. Událost se uloží bez ohledu na to, jestli ji nějaký webhook dostane.

Z toho plynou dva důsledky:

Webhook dostává jen události, které nastanou, dokud existuje a je zapnutý. Události zaznamenané v době, kdy byl webhook vypnutý, nebo před jeho vytvořením se mu dodatečně neodesílají.
Seznam událostí můžete použít k doplnění mezer. Po výpadku nebo období, kdy byl webhook vypnutý, načtěte přes API události z tohoto časového okna a zpracujte ty, které váš webhook zmeškal. Duplicity odstraňujte podle ID události, což je stejné ID evt_, které webhooky používají jako event_id.

Procházejte události ve webovém rozhraní

Otevřete Email APIEvents. Tabulka zobrazuje u každé události Event type, ID a čas Created, od nejnovějších.

Ve výchozím stavu stránka zobrazuje poslední 2 dny. Pokud chcete jít dál do minulosti v rámci doby uchovávání, přidejte filtr Created.
Filtrem Type zobrazíte jen jeden druh událostí, například jen email.bounced.
Výběrem události zobrazíte její čas Created, Type a celý Payload jako JSON s tlačítkem pro zkopírování.

Čtěte události přes API

Oba endpointy potřebují API klíč s oprávněním Full Access.

Výpis událostí

Výpis událostí vrací události od nejnovějších.

Parametr dotazu	Popis
`type`	Jeden typ, nebo několik typů oddělených čárkami, například `email.bounced,email.complained`.
`include_data`	`true`, pokud chcete u každé události i `data`. Výchozí hodnota je `false`, která vrací jen `id`, `type` a `created_at`.
`page`, `limit`	Číslo stránky a velikost stránky. `limit` je od 1 do 100, výchozí hodnota je 100.
`created_at.after`, `created_at.before`	Filtry podle data. Viz Filtrování.

Terminal

curl -G https://api.emailit.com/v2/events \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "type=email.bounced,email.complained" \
  --data-urlencode "created_at.after=2026-09-28T00:00:00Z" \
  --data-urlencode "include_data=true"

JSON

{
  "data": [
    {
      "object": "event",
      "id": "evt_2xGkB3n8WqZ5cT1vRmK7pLsD4hY",
      "type": "email.bounced",
      "data": { "object": { "id": "em_2xGkA9m1PdX6bR3sQnJ8tKfW2eV", "object": "email", "status": "bounced" } },
      "created_at": "2026-09-30T17:02:41.118000+00:00"
    }
  ],
  "next_page_url": "/v2/events?page=2&limit=100&type=email.bounced%2Cemail.complained&include_data=true",
  "previous_page_url": null
}

Rychlost tohoto endpointu zajišťují dva limity:

Výchozí okno. Bez filtru created_at pokrývá výpis poslední 2 dny. Starší události načtete s created_at.after.
Hloubka stránkování. Offset (page - 1) × limit nesmí být větší než 2 500. Hlubší stránky vracejí 422 s kódem events_offset_too_large. Místo dalšího stránkování požadavek zužte pomocí type nebo rozsahu created_at.

Načtení události

Načtení události vrací jednu událost podle jejího ID evt_, vždy s data.

Terminal

curl https://api.emailit.com/v2/events/evt_2xGk7Nq1VbD5sR8tLmW3eYhC6aP \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Dohledejte zmeškané události webhooků

Zvolte časové okno. Poznamenejte si, kdy váš endpoint začal selhávat nebo kdy byl webhook vypnut, a kdy byl problém odstraněn.
Vypište události. Zavolejte GET /v2/events s created_at.after a created_at.before nastavenými na toto okno, s hodnotami type, které váš webhook zpracovává, a s include_data=true. Pokračujte podle next_page_url, dokud není null. Pokud narazíte na events_offset_too_large, rozdělte okno na kratší úseky.
Zpracujte, co jste ještě neviděli. Přeskočte události, jejichž ID už máte uložené jako zpracované, a ostatní zpracujte stejným kódem, jaký používá váš webhook.

U požadavků, které byly zařazeny do fronty, ale selhaly, je jednodušší použít u webhooku Retry failed, pokud jsou chyby mladší než 7 dní.

Uchovávání

Události se řídí dobou uchovávání Logy, stejně jako logy požadavků a požadavky webhooků:

	Pay as you go	Pro	Business	Custom
Uchovávání logů požadavků	7 dní	30 dní	30 dní	Flexibilní

Typy událostí

Events API