Webhooky

Webhooky vám umožňují přijímat HTTP notifikace v reálném čase, když se ve vašem Emailit účtu stane nějaká událost – například když je e-mail doručen, vrácen, nebo když je vytvořen kontakt.

Místo neustálého dotazování API na změny vám webhooky posílají data přímo na váš server ve chvíli, kdy se událost stane. Díky tomu můžete vytvářet reaktivní integrace a pracovní postupy.

Jak to funguje

Ve své aplikaci vytvoříte webhook endpoint, který přijímá POST požadavky
URL zaregistrujete v Emailit dashboardu nebo přes API
Když nastane odebíraná událost, Emailit pošle POST požadavek na vaši URL s daty události
Váš endpoint odpoví stavovým kódem 2xx a potvrdí tak přijetí

Struktura události

Každá webhook událost má konzistentní strukturu:

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.delivered",
  "data": {
    "object": {
      ...
    }
  }
}

Struktura události

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.delivered",
  "data": {
    "object": {
      ...
    }
  }
}

Pole	Popis
`event_id`	Jedinečný identifikátor této události
`type`	Typ události (např. `email.delivered`, `contact.created`)
`data.object`	Objekt zdroje spojený s událostí

Dostupné události

Emailit posílá webhook notifikace pro následující typy zdrojů:

E-maily — události životního cyklu doručování (přijato, doručeno, vráceno atd.)
Domény — vytváření, aktualizace a mazání domén
Publikum — události správy publika
Odběratelé — události životního cyklu odběratelů
Kontakty — události správy kontaktů
Šablony — vytváření, aktualizace a mazání šablon
Potlačení — změny v seznamech potlačení
Ověřování e-mailů — výsledky ověřování
Seznamy ověřování e-mailů — události hromadného ověřování seznamů

Kompletní seznam najdete v Typech událostí.

Další kroky

Typy událostí — Úplný seznam všech dostupných typů událostí
Webhook požadavky — Jak jsou strukturovány HTTP požadavky webhooků
Podpis požadavku — Ověření autenticity webhooků pomocí podpisů

NextTypy událostí