RCS Mobile Originated (MO) Callback Events

RCS Mobile Originated (MO) Callback Events refer to messages or actions initiated by the end user from their device and sent to the customer callback URL. These events represent incoming messages or user interactions that originate from the user's handset.

Field Descriptions

The following list describes the callback payload:

Field	Type	Description	Example
`type`	string	Type of event (e.g., USER_MESSAGE, SUBSCRIBE, UNSUBSCRIBE)	SUBSCRIBE
`eventId`	string	Unique identifier for the event.	Mx0LmVQ9KHQq2JheUakGyWpA
`from`	string	Sender's identifier (usually a phone number).	91767XXXXX
`to`	string	Recipient or service identifier.	mmx_traffic
`sentAt`	string	ISO 8601 timestamp indicating when the event occurred.	2025-06-18T13:37:02.385Z
`messageId`	string	Unique identifier for the message.	f2b6058d-f38f-4b3f-8864-a5d7698cfb57

Keyword Behavior

Keyword	Meaning	Expected Behaviour
`START/SUBSCRIBE`	User Opt-In	User gives consent to start receiving messages from the brand.
`STOP/UNSUBSCRIBE`	User Opt-Out	User revokes consent; agent must stop all future messaging. Brand is a business entity. Agent is associated to brand. For example, one brand can have multiple agents.

Sample Payloads

UNSUBSCRIBE Event:

{ 
  "type": "UNSUBSCRIBE", 
  "from": "917673XXXXXX", 
  "to": "mmx_traffic", 
  "sentAt": "2025-06-18T13:37:40.631Z", 
  "messageId": "b1641ff6-a2c8-4e01-a54a-2bXXXXXXX9cf" 
}

USER_MESSAGE Event (STOP):

{ 
  "type": "USER_MESSAGE", 
  "eventId": "MxRyZhJhOhTcimpjoAVrYiWQ", 
  "from": "91767XXXXX", 
  "to": "mmx_traffic", 
  "sentAt": "2025-06-18T13:37:40.683Z", 
  "messageId": "47a6fd7c-163c-4024-ad8e-e2XXXXXXX74b", 
  "userMessage": { 
    "type": "TEXT", 
    "text": "STOP" 
  }

SUBSCRIBE Event:

{ 
  "type": "SUBSCRIBE", 
  "from": "917673XXXXX", 
  "to": "mmx_traffic", 
  "sentAt": "2025-06-18T13:37:02.367Z", 
  "messageId": "5ffc6b3b-9511-4530-82d2-4154XXXXXXX7" 
}

USER_MESSAGE Event (START):

{ 
  "type": "USER_MESSAGE", 
  "eventId": "Mx0LmVQ9KHQq2JheUakGyWpA", 
  "from": "91767XXXXX", 
  "to": "mmx_traffic", 
  "sentAt": "2025-06-18T13:37:02.385Z", 
  "messageId": "f2b6058d-f38f-4b3f-8864-a5dXXXXXXX76", 
  "userMessage": { 
    "type": "TEXT", 
    "text": "START" 
  } 
}

MO Callback against Suggestions

Open_URL

{
  "type": "USER_MESSAGE",
  "eventId": "Mx0C-L1TP3TeOpiziWA1vLw",
  "from": "9176XXXXXXXX",
  "to": "HXAP1837361844IN",
  "sentAt": "2025-12-12T11:27:18.302Z",
  "messageId": "615188bf-c96c-4007-bdf2-d64fXXXXX2e2",
  "userMessage": {
    "type": "RESPONSE",
    "response": {
      "text": "Book Now!",
      "postbackData": "Book_flight",
      "type": "ACTION"
    }
  }
}

SHARE_LOCATION

{
  "type": "USER_MESSAGE",
  "eventId": "MxdjZk9JwzQg-JV4bFLWhLuw",
  "from": "9176XXXXXXXX",
  "to": "HXAP18XXXXX374IN",
  "sentAt": "2025-12-12T11:28:05.984Z",
  "messageId": "057672f8-2a53-42d7-827a-0c4XXXXX924f",
  "userMessage": {
    "type": "RESPONSE",
    "response": {
      "text": "Locate on map",
      "postbackData": "postback_data_1234",
      "type": "ACTION"
    }
  }
}

ASK LOCATION

{
  "type": "USER_MESSAGE",
  "eventId": "MxjgcY8RN1Sla42UA76e8SYw",
  "from": "9176XXXXXXXX",
  "to": "HXAP1837XXXXX36N",
  "sentAt": "2025-12-12T11:28:44.000Z",
  "messageId": "bdb5b780-3610-4493-97d0-0da7XXXXX2fe",
  "userMessage": {
    "type": "RESPONSE",
    "response": {
      "text": "Share your location",
      "postbackData": "postback_data_1234",
      "type": "ACTION"
    }
  }
}

USER_SHARED LOCATION

{
  "type": "USER_MESSAGE",
  "eventId": "Mxl82OWDxLRsK0D00KypigDA",
  "from": "917XXXXXXXXX",
  "to": "HXAP18XXXXXX44IN",
  "sentAt": "2025-12-12T11:28:58.336Z",
  "messageId": "e6521f3e-8001-46c4-b493-55bbXXXXXXXX",
  "userMessage": {
    "type": "LOCATION",
    "location": {
      "latitude": 18.5935474,
      "longitude": 73.8945065
    }
  }
}

CALENDER_EVENT

{
 "type": "USER_MESSAGE",
 "eventId": "MxJLVekUq-TrmI68NLCdvm2A",
 "from": "91XXXXXXXX72",
 "to": "mmx_traffic",
 "sentAt": "2025-07-16T06:01:20.650Z",
 "messageId": "86931714-9f78-414e-8124-11358XXXXXee",
 "userMessage": {
  "type": "RESPONSE",
  "response": {
   "text": "Check your calender",
   "postbackData": "postback_data_1234",
   "type": "ACTION"
  }
 }
}

DAIL_ACTION

{
  "type": "USER_MESSAGE",
  "eventId": "Mxh5H5dAFfSGCm1uNpESzUFQ",
  "from": "91XXXXXXXX76",
  "to": "HXAP1XXXXX8344IN",
  "sentAt": "2025-12-12T11:30:52.827Z",
  "messageId": "22c341c8-f627-44db-85ea-5eccb48a4a0e",
  "userMessage": {
    "type": "RESPONSE",
    "response": {
      "text": "Customer Support",
      "postbackData": "postback_data_1234",
      "type": "ACTION"
    }
  }
}

SUGGESTED_REPLY

{
  "type": "USER_MESSAGE",
  "eventId": "MxFyYfvwWKTZ2vaxSxptzhbQ",
  "from": "91XXXXXXXXX7",
  "to": "HXAP1837361844IN",
  "sentAt": "2025-12-12T11:36:12.157Z",
  "messageId": "a3ff292e-039f-4612-b94f-efbXXXXXXXX4",
  "userMessage": {
    "type": "RESPONSE",
    "response": {
      "text": "Avail-Offer",
      "postbackData": "flight_offer",
      "type": "REPLY"
    }
  }
}

Updated about 4 hours ago