Přejít na obsah
Dokumentace

Princip

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 20. 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. Log událostí obsahuje také události workspace a vlastní události, které odesíláte sami. 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. Karta Log zobrazuje u každé události Event type, ID a čas Created, od nejnovějších. Tečka před typem je zelená u událostí workspace, fialová u vlastních událostí a šedá u systémových událostí.

  • 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.
  • Volbou Scope zobrazíte jen systémové události, události workspace nebo vlastní události.
  • Výběrem události zobrazíte její čas Created, Type a celý Payload jako JSON s tlačítkem pro zkopírování. U událostí workspace a vlastních událostí stránka ukazuje také vlastnosti, kontakt, stránku, ze které událost přišla, a kampaň.
  • Send event ručně zaznamená událost workspace nebo vlastní událost, například pro otestování webhooku, v tarifech Pro, Business a Custom. Karty Workspace events a Tracking popisuje stránka Sledování událostí.

Č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.
scope system, workspace nebo custom, případně několik hodnot oddělených čárkami.
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ů

  1. Zvolte časové okno. Poznamenejte si, kdy váš endpoint začal selhávat nebo kdy byl webhook vypnut, a kdy byl problém odstraněn.

  2. 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.

  3. 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 goProBusinessCustom
Uchovávání logů požadavků7 dní30 dní30 dníFlexibilní

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.