Webhook Setup

Webhooks allow your application to receive real-time notifications whenever events occur within the platform.

Instead of constantly checking for updates, your server receives event data automatically.

Common Webhook Events

Message Events

Triggered when:

• A new message is received

• A message is delivered

• A message is read

• A message fails

Contact Events

Triggered when:

• A contact is created

• A contact is updated

• A contact is deleted

Chatbot Events

Triggered when:

• A chatbot is published

• A workflow is updated

• A chatbot is disabled

Creating a Webhook

1. Go to Settings → Webhooks.

2. Click Create Webhook.

3. Enter your endpoint URL.

4. Select event types.

5. Save and activate the webhook.

Example Webhook Payload

{  "event": "message.received",  "timestamp": "2026-06-07T10:30:00Z",  "contact_id": "12345",  "message": {    "text": "Hello"  }}

{  "event": "message.received",  "timestamp": "2026-06-07T10:30:00Z",  "contact_id": "12345",  "message": {    "text": "Hello"  }}

{  "event": "message.received",  "timestamp": "2026-06-07T10:30:00Z",  "contact_id": "12345",  "message": {    "text": "Hello"  }}

Verify Webhook Requests

To ensure requests originate from our platform, validate the webhook signature included in the request headers.

X-Webhook-Signature: abc123xyz

X-Webhook-Signature: abc123xyz

X-Webhook-Signature: abc123xyz

Troubleshooting Webhooks

Check the following if events are not being received:

• Endpoint URL is publicly accessible.

• HTTPS is enabled.

• Server returns a 200 status code.

• Firewall rules allow incoming requests.

• Webhook event types are enabled.