Events
message.received
Fires when an inbound message arrives from a contact to one of your phone numbers.
WEBHOOK
Fires when a contact sends a message to one of your phone numbers. This is the primary event for building two-way messaging flows. If this is the first message in a new thread,
conversation.created fires alongside it.
Common use case
Usemessage.received to drive inbound message handling, auto-reply bots, support ticket creation, or forwarding to a human agent. To reply, call POST /accounts/{account_id}/messages with the same conversation.id.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
The ID of the account in which this event occurred
The data associated with the event
The timestamp when this event occurred, in ISO8601 format
The type of the event. Always message.received for this event.
Allowed value:
"message.received"Response
200
Return a 200 status to indicate that the data was received successfully