Webhook Events

Receive real-time notifications whenever important events occur in your chatbot automation system.

What Are Webhooks?

Webhooks allow your application to automatically receive updates when specific actions happen inside the platform.

Instead of constantly checking for updates, the platform sends event data directly to your configured endpoint.

How Webhooks Work

1. An event occurs

2. The platform generates event data

3. A POST request is sent to your webhook URL

4. Your application processes the event

Configure a Webhook

Navigate to:

Settings → Developer → Webhooks

Settings → Developer → Webhooks

Settings → Developer → Webhooks

Add:

• Webhook URL

• Event subscriptions

• Security settings

Supported Events

Message Events

• message.received

• message.sent

• message.delivered

• message.read

• message.failed

Contact Events

• contact.created

• contact.updated

• contact.deleted

Automation Events

• automation.started

• automation.completed

• automation.failed

Chatbot Events

• chatbot.session_started

• chatbot.session_ended

• chatbot.handover_requested

Example Webhook Payload

{  "event": "message.received",  "timestamp": "2026-06-07T12:00:00Z",  "data": {    "contact_id": "12345",    "message": "Hello"  }}

{  "event": "message.received",  "timestamp": "2026-06-07T12:00:00Z",  "data": {    "contact_id": "12345",    "message": "Hello"  }}

{  "event": "message.received",  "timestamp": "2026-06-07T12:00:00Z",  "data": {    "contact_id": "12345",    "message": "Hello"  }}

Webhook Security

To verify incoming requests:

• Validate webhook signatures

• Use HTTPS endpoints

• Reject unknown IPs if necessary

• Store webhook secrets securely

Delivery & Retries

If your endpoint fails to respond:

• Automatic retry attempts are made

• Failed deliveries are logged

• Retry intervals increase progressively

Testing Webhooks

You can send test events from the Developer Dashboard to verify your endpoint configuration before going live.