Webhooks
Events
Webhook event types and when they fire.
Available events
| Entity | Operation | Trigger |
|---|---|---|
messages | insert | A new message is created (incoming or outgoing) |
messages | update | A message status changes (sent, delivered, read, failed) |
conversations | insert | A new conversation is created |
conversations | update | A conversation is updated (closed, reopened, assigned) |
Message events
messages / insert
Fired when:
- An incoming WhatsApp message is received
- An outgoing message is sent (by a human agent or AI agent)
messages / update
Fired when:
- A message status changes:
sent→delivered→read - A message fails to send
Conversation events
conversations / insert
Fired when:
- A new conversation starts (first message from a new contact)
- A conversation is created manually
conversations / update
Fired when:
- A conversation is closed (24-hour window expires)
- A conversation is reopened (new template sent)
- An agent is assigned or unassigned