RCS Mobile Originated (MO) Events

RCS Mobile Originated (MO) 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.

Keyword Behavior

Keyword	Meaning	Expected Behaviour
`START`	User Opt-In	User gives consent to start receiving messages from the brand.
`STOP`	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-2b9cf36a5154" 
}

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-e274bed208f4", 
  "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-4154166365f7" 
}

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-a5d7698cfb57", 
  "userMessage": { 
    "type": "TEXT", 
    "text": "START" 
  } 
}

Field Descriptions

The following list describes the 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
`userMessage`	object	Contains user message details such as type and text.	{ "type": "TEXT", "text": "START" }