Pošlete události z chatu do svých systémů.

Vyberete události, které potřebujete. Breezaro odešle podepsaný JSON na vaši HTTPS adresu, kde s ním může pracovat CRM, automatizace nebo vaše vlastní služba.

Prohlédnout tarifyPřečíst návod k webhookům

K dispozici v tarifu Standard a vyšším nebo během aktivní zkušební doby, pokud jsou webhooky pro vašeho asistenta zapnuté. Počet endpointů závisí na tarifu.

BreezaroPodepsaný JSON POSTVáš HTTPS endpoint
Ilustrační payload conversation.started
{
  "id": "evt_2b6f7e3a-9c9b-4a91-8ce1-7b6dcd6db8a2",
  "type": "conversation.started",
  "createdAt": "2026-07-29T14:03:11.482Z",
  "apiVersion": "2026-07-29",
  "data": {
    "conversation": {
      "id": "sample-conversation",
      "source": "widget"
    },
    "startedAt": "2026-07-29T14:03:11.482Z",
    "visitor": { "language": "en" }
  }
}
Hlavičky podpisuwebhook-id · webhook-timestamp · webhook-signature

Vyberte to, co váš postup opravdu potřebuje.

Každý endpoint přihlásíte jen k událostem, které má váš systém zpracovat. Událost nese typ, id, čas a vlastní data.

Událost uvádí zdroj, například webový widget, WhatsApp, Messenger nebo Instagram. Dostupné události závisí na kanálu a provedené akci.

  • Začne konverzace nebo se uloží zpráva

    Reagujte na nové konverzace a zprávy návštěvníka, asistenta či operátora. U připojeného kanálu uložení odpovědi bota ještě nepotvrzuje její doručení návštěvníkovi.

    conversation.startedmessage.created

  • Asistent požádá o člověka nebo operátor převezme chat

    Sledujte žádost asistenta o operátora i skutečné převzetí. Operátor může konverzaci převzít také bez předchozí žádosti.

    handover.requestedhandover.claimed

  • Dokončí se vlastní akce

    Akce pro čtení mohou běžet ve widgetu i v připojeném kanálu. Potvrzené akce měnící data zatím běží jen ve webovém widgetu. Událost obsahuje výsledek a omezené vstupní argumenty, nikoli odpověď vašeho API.

    custom_action.readcustom_action.executed

  • Návštěvník ověří svoji identitu

    Událost o ověření můžete využít k aktualizaci záznamu zákazníka. Může obsahovat kontaktní údaje; dostupná pole se liší podle způsobu ověření a kanálu.

    visitor.verified

Od vybrané události k vašemu endpointu.

Webhooky nastavíte v dashboardu a před zapojením do automatizace otestujete stejnou cestu doručení, kterou používají skutečné události.

Přečíst návod k nastavení a payloadu

  1. Přidejte HTTPS endpoint

    Zadejte přijímací URL a vyberte alespoň jeden typ události. Výběr můžete později změnit.

  2. Odešlete vzorky

    Dashboard zařadí do fronty vzorek každé vybrané události. Každý nese test: true, takže ho lze v cílovém systému oddělit od ostrého provozu.

  3. Ověřte podpis

    Než události začnete důvěřovat, ověřte webhook-id, webhook-timestamp a webhook-signature nad přesným tělem požadavku.

  4. Sledujte doručení

    V dashboardu uvidíte poslední stavy, kódy odpovědí a počet pokusů. Dokončené doručení můžete zopakovat, dokud je jeho payload uchovaný.

Uvidíte, zda endpoint odpověděl, nebo selhal.

Události se řadí do fronty a odesílají na pozadí. Váš endpoint potvrdí úspěch odpovědí 2xx; výsledek doručení najdete v dashboardu.

Opakovatelné chyby zkoušíme znovu
Při opakovatelné chybě Breezaro provede až osm pokusů s narůstajícími rozestupy. Endpoint má na odpověď deset sekund.
Zkontrolujte nebo opakujte doručení
Záznamy o doručení zůstávají 30 dní, těla payloadů sedm dní. Po 20 po sobě neúspěšných událostech se endpoint vypne a v dashboardu se zobrazí upozornění.
Počítejte s duplicitami a zaplněnou frontou
Události mohou dorazit opakovaně nebo v jiném pořadí. Deduplikujte je podle id. Pokud má endpoint už 1 000 čekajících doručení, další události se pro něj zahazují, dokud se fronta neuvolní.

Jak webhooky souvisejí s vlastními akcemi?

Obě funkce propojují konverzaci s vašimi systémy, každá jiným způsobem.

Prozkoumat Vlastní akce
Zavolá webhook moje API pro rezervace či objednávky?
Webhook oznamuje, co se v Breezaru stalo. Vlastní akce umožňují asistentovi během konverzace volat API, například vyhledat objednávku nebo po potvrzení založit rezervaci.
Přicházejí stejné události ze všech kanálů?
Události o konverzacích a zprávách mohou přijít z webového widgetu i připojených kanálů. Některé typy se podle kanálu liší: potvrzené Vlastní akce měnící data dnes běží pouze ve webovém widgetu.
Musím provozovat vlastní server?
Můžete použít automatizační nástroj s HTTPS webhookovou URL. Pokud tento nástroj podpis neověřuje, chraňte URL jako tajemství. U citlivé návazné akce použijte vlastní přijímač, který podpis ověří.
Který tarif webhooky obsahuje?
Tarif Standard a vyšší i aktivní zkušební doba splňují podmínky, pokud jsou webhooky pro asistenta zapnuté. Tarif určuje počet endpointů. Doručení webhooků nečerpá kredity chatu.

Zapojte události z konverzací.

Začněte jednou událostí a jedním endpointem. Další přidejte podle toho, co váš postup skutečně využije.

Prohlédnout tarify