Incoming events

This page describes the incoming events you can receive from RCS through the CM.com Messaging API.

For the generic behaviour of incoming events across all channels, see Incoming events.

Supported Events

Type	Description
SuggestionClick	User taps a suggested action/reply
IsTyping	User is typing within a conversation with the agent.

Custom Objects

SuggestionClick The object contains the postbackdata and the button label

SuggestionClick - Suggested action

When a user taps a suggested action, your agent receives an event containing the action's postback data. The messageContext is defined by the reference in the provided MT. This is mandatory; otherwise, we cannot link the incoming message to the outgoing message.

SuggestionClick allows you to track suggested actions, not suggested replies. Suggested replies refer to incoming messages, while suggested actions include:

• Opening a URL
• Dialing a number
• Sending an agenda message
• Sending a location message

Example of a request you can receive:

{
  "reference": "a73bc8c0-ecd6-4b7b-a7de-b6b8e527bf73",
  "messageContext": "your_reference",
  "from": {
    "number": "003161234678"
  },
  "to": {
    "number": "00cm.com_agent"
  },
  "event": {
    "type": "SuggestionClick",
    "custom": {
      "postbackdata": "Call us",
      "label": "Call us"
    }
  },
  "groupings": [
    "",
    "",
    ""
  ],
  "timeUtc": "2025-10-23T12:14:17",
  "channel": "RCS"
}

SuggestionClick - Suggested replies

Type	Description
SuggestionClick	User taps a suggested reply

When a user taps a suggested reply, your agent receives an event containing the reply's postback data. The messageContext is defined by the reference in the provided MT. This is mandatory; otherwise, we cannot link the incoming message to the outgoing message.

Example of a request you can receive:

{
  "reference": "a73bc8c0-ecd6-4b7b-a7de-b6b8e527bf73",
  "messageContext": "your_reference",
  "from": {
    "number": "003161234678"
  },
  "to": {
    "number": "00cm.com_agent"
  },
  "event": {
    "type": "SuggestionClick",
    "custom": {
      "postbackdata": "Call us"
    }
  },
  "groupings": [
    "",
    "",
    ""
  ],
  "timeUtc": "2025-10-23T12:14:17",
  "channel": "RCS"
}

Remarks

• Please note that not all countries are supported. Contact us to inquire about availability.
• To receive incoming events, an event webhook must be configured. Please provide us with the URL so we can set this up for you.