● Run · Integrations
Webhooks
Zapier, Make, n8n, your CRM.
Console → Webhooks: add an https endpoint, pick events and optionally one client. Every request is signed and failed deliveries are retried.
01Add an endpoint
Console → Webhooks → add an https endpoint, pick events and optionally one client. The signing secret is shown once; New secret replaces it.
02Events
| Event | When | data |
|---|---|---|
booking.created | the agent or the console booked | code, service, starts_at, ends_at, timezone, caller_name, caller_phone, note, source, conversation_id |
booking.cancelled | a booking was cancelled (phone, console or portal) | the same |
message.created | a caller left a message | id, caller_name, caller_phone, reason, urgent, conversation_id |
call.completed | a finished call was synced from ElevenLabs | conversation_id, started_at, duration_secs, caller, title, summary, sentiment, outcome, reason, transferred |
Body:
{ "id": "evt_…", "type": "booking.created", "created": 1793000000, "client_id": "…", "data": { … } }
03Checking the signature
Every request carries the header x-answerbell-signature: t=<unix>,v1=<hex>.
- Compute HMAC-SHA256 of
<t>.<raw body>with the endpoint's secret. - Compare it with
v1in constant time. - Refuse a
tolder than five minutes. - Ignore repeats by
id.
04Delivery and retries
A 2xx answer within 10 seconds counts as delivered; otherwise the event is retried after 1, 5, 30, 120 and 720 minutes, then marked failed (the Status page and Today warn). Endpoints must be https on a public address; redirects are not followed.
Personal data
Payloads contain callers' names and numbers: send them only where you are allowed to keep them.