Docs / Developers

Webhooks

Send chatbot events to your own tools in real time.


Webhooks push events from your chatbot to any URL — Zapier, Make, your CRM, or your own backend — the moment they happen.

Setting up a webhook

  1. Open your chatbot and go to the Integration tab.
  2. Add a webhook with a URL and the events you want (comma-separated).
  3. Save. IntegrioChat will POST a JSON payload to your URL for each subscribed event.

Events

  • message.completed — every time the chatbot finishes a reply.
  • conversation.started — when a new visitor opens the chat for the first time.
  • lead.captured — when a visitor submits their name and email.
  • action.executed — when the chatbot runs an action; includes its status (ok, error, or blocked).

Payload

Each delivery is a JSON body with event, chatbotId, sessionId, timestamp, and a data object. Requests are signed with an HMAC so you can verify they came from IntegrioChat.

Tip: alert on blocked actions

Subscribe to action.executed and alert when data.status is blocked or error — so you're notified the moment the identity or confirmation gate refuses something, or an action fails.