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
- Open your chatbot and go to the Integration tab.
- Add a webhook with a URL and the events you want (comma-separated).
- 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, orblocked).
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.
