Webhooks — receive events when chats start, end, or get a message

Developer Updated Jun 8, 2026

If you want to push chat events into Slack, your CRM, or your own database, use webhooks.

Set a webhook

Dashboard → Site → Developer → Webhook URL. Paste an HTTPS URL we'll POST to for every event.

Event payload

{
  "event": "message.created",
  "site_id": "s_8aA2bC3dE4f",
  "conversation_id": "c_FfGgHh",
  "ts": "2026-05-25T18:42:11Z",
  "role": "visitor",
  "text": "Hi, do you ship to Canada?"
}

Events we send

conversation.created
message.created (visitor, ai, or operator)
conversation.closed
operator.joined

Security

Each POST is signed with HMAC-SHA256 in the X-247chat-Signature header. Verify against your webhook secret (also under Developer settings).