Webhook Events
Receive real-time notifications when chat messages are sent or contact forms submitted
Configure a webhook URL in your domain settings to receive HTTP POST notifications when events occur.
Setup
Go to your domain's Overview page and set the Webhook URL field. The URL must be publicly accessible and accept POST requests.
Event: message
Fired after each chat message exchange (user message + AI response).
{
"event": "message",
"domainId": "uuid",
"conversationId": "uuid",
"userMessage": "What are your shipping rates?",
"assistantMessage": "We offer free shipping on orders over 500 DKK...",
"timestamp": "2026-04-17T12:00:00.000Z"
}
Event: ticket
Fired when a visitor submits the contact form.
{
"event": "ticket",
"domainId": "uuid",
"ticketId": "uuid",
"name": "John Doe",
"email": "john@example.com",
"phone": "+45 12 34 56 78",
"message": "I need help with a custom order",
"conversationId": "uuid",
"pageUrl": "https://example.com/products",
"timestamp": "2026-04-17T12:05:00.000Z"
}
Security
- Webhooks are sent via HTTPS only
- Requests include a
Content-Type: application/jsonheader - Failed deliveries are not retried (fire-and-forget)
- The webhook URL is validated against SSRF attacks (private IPs blocked)
💡
Use a service like webhook.site to test your webhook endpoint during development.
Common Integrations
| Service | How to integrate |
|---|---|
| Slack | Create an incoming webhook and forward the payload |
| Zapier | Use a Zapier webhook trigger URL |
| HubSpot | Forward ticket events to the HubSpot contacts API |
| Custom CRM | Build an endpoint that processes the JSON payload |