Aller au contenu principal

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

info

This can be done also programmatically from WebhooksEndpoint

On your Callbell dashboard navigate to the "API Settings" section and click on the "Webhooks" tab:

webhook_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:

webhook_create

info

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:

webhook_edit

attention

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.

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.