Introduction
Callbell API provides HTTP Webhooks for the most common application events:
- Message events
- Message notification status events
- Contact events
- Conversation events
- Agent events
- Team events
How to subscribe to events
This can be done also programmatically from WebhooksEndpoint
On your Callbell dashboard navigate to the "API Settings" section and click on the "Webhooks" tab:
In the URL field add your endpoint URL (e.g. https://myapp.com/callbell_endpoint) and select the events you want to get subscriptions for:
Make sure to also include the protocol (http or https) inside your webhook endpoint:
✅ Good: https://www.myexample.com
❌ Bad: www.example.com
After clicking "Create new webhook" you should receive a success notification. You can always edit back the Webhook events in a later stage:
Callbell doesn't support localhost as webhook URL. If you need to debug a local application use instead a service to expose your local dev environment like Ngrok.
Callbell can sign every webhook request with a secret that belongs to your webhook. See Verifying signatures to turn it on and to check that a request comes from Callbell.
After subscribing to an event, Callbell will perform connection checks periodically. You can answer it back with a status code of 200 and a body with {"status": "ok"}.
If the endpoint does not respond for 10 minutes, we will send the account admin an email. If it does not respond for 6 hours, the webhook subscription will be disabled.