WebhooksEvents
Events
Every event an endpoint can receive, what fires it and what it carries.
An endpoint receives only the events it subscribes to. Each page below shows when the
event fires and when it does not, every field of its data, and an example. All of them
arrive in the same envelope.
| Event | What happened |
|---|---|
message.received | A customer wrote. |
conversation.started | A new conversation began. |
conversation.handover | The conversation was handed to the team. |
conversation.assigned | The conversation was assigned, or unassigned. |
conversation.resolved | The conversation was resolved or closed. |
contact.created | A contact was added. |
contact.updated | A contact's details changed. |
contact.opted_out | A contact opted out of messages. |
lead.qualified | A conversation became a qualified lead. |
appointment.booked | An appointment was booked. |
appointment.cancelled | An appointment was cancelled. |
flow.completed | An automation finished. |
flow.failed | An automation failed. |
ping | A test from the dashboard. |
ping cannot be subscribed to: it is what Send test posts when no event is chosen.
New event types may be added at any time; an endpoint never receives a type it did not
subscribe to. If your receiver serves several endpoints, acknowledge a type it does not
know with 2xx and ignore it.