Message Origination

Message Origination (MO) webhooks are triggered whenever an inbound message is received by your Voxtelesys account. These callbacks provide detailed information about the incoming message, including the sender, recipient, and message content.

Note that only billable suggestion events will trigger MO webhooks. These include REPLY and REQUEST_LOCATION.

MO Webhook Payload

Parameter	Type	Required	Description	Example
type	string	true	Always MO	MO
direction	string	true	Always Inbound	Inbound
channel	string	true	Always rcs	rcs
message_id	string	true	ID of message	4de1d075-2a7e-404e-abac-3f80560db42f
to	string	false	The sender the message was sent to	exampleSender
from	string	false	The phone number the message was sent from (E164 format with no plus)	1987654321
event_meta	object	true	Event specific metadata	{ "type": "TEXT", "text": "Hello", "callback_data": "exampleCallback" }
event_meta.type	string	true	The type of inbound message (can be TEXT, SUGGESTION, or LOCATION)	TEXT
event_meta.text	string	false	The text of the message	Hello
event_meta.callback_data	string	false	User input callback data (used by the LOCATION and SUGGESTION types)	exampleCallback
event_meta.longitude	string	false	The longitude of the sender (used only by the LOCATION type)	0
event_meta.latitude	string	false	The latitude of the sender (used only by the LOCATION type)	0
error	object	true	The message error, if applicable	{ "code": "0", "description": "None" }
error.code	string	true	Detailed error code	0
error.description	string	true	Detailed error description	no error
time	string	true	The time of the message was received in ISO 8601 format	2025-12-08T15:30:00Z
api_version	string	true	The version of the API the message was sent on	1