Přeskočit na obsah

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.

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.
Ukázka doručení
  1. Breezaroconversation.started
  2. Podepsaný JSON POST
  3. Váš HTTPS endpoint200 OK
Zobrazit payload a hlavičky

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 podpisu

  • webhook-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

  • Návštěvník odešle formulář

    Předejte poptávku nebo požadavek na podporu do svého systému včetně identifikace formuláře a vyplněných odpovědí. U endpointu vyberte událost form.submitted a určete, zda se má týkat konkrétních formulářů, nebo všech. Návštěvníci vyplňují formuláře ve webovém widgetu.

    form.submitted

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.

Jedna událost, dva pokusy

conversation.started
  1. Pokus 1

    HTTP 503

    Čeká na další pokus

  2. Pokus 2

    HTTP 204

    Doručeno

Ilustrační průběh. Dashboard u každého doručení zobrazuje poslední odpověď a celkový počet pokusů.
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í.
Pravidla doručení a opakování

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