Emailit
Dokumentace Webhooky

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

  1. Ve své aplikaci vytvoříte webhook endpoint, který přijímá POST požadavky
  2. URL zaregistrujete v Emailit dashboardu nebo přes API
  3. Když nastane odebíraná událost, Emailit pošle POST požadavek na vaši URL s daty události
  4. 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": {
      ...
    }
  }
}

PolePopis
event_idJedinečný identifikátor této události
typeTyp události (např. email.delivered, contact.created)
data.objectObjekt 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

NextTypy událostí