RCS Suggestions

The RCS Suggestions are interactive User Interface elements that allow you to respond quickly or trigger specific actions. They can represent either reply options or action buttons within an RCS message. This can be positioned in different locations depending on the intended end user experience:

• Within a card:

When suggestions are part of a card, the suggestions[] array should be defined inside the content object, as shown in the example above.

• As a floating chip list:

If suggestions need to appear as floating chips, the suggestions[] array should be added at the top (main) level of the payload.

• Both card-level and floating suggestions:

If both types are required, both approaches can be implemented simultaneously. Refer to the example above for guidance.

The Reply Suggestions allow you to respond quickly by selecting one of the predefined options.

Suggestions and Actions Field Reference

Reply

Action

OpenUrlAction

DialAction

View Location

LatLong

CalendarEventAction

Reply Suggestion

{
  "reply": {
    "text": "Yes",
    "postbackData": "user_said_yes",
    "buttonId": "btn_yes"
  }
}

Action Suggestion

{
  "action": {
    "text": "Call Support",
    "postbackData": "call_support",
    "dialAction": {
      "phoneNumber": "+1800123456"
    }
  }
}

Action Types

The following are the action types supported:

Open URL Action

{
  "openUrlAction": {
    "url": "https://www.airindia.com/in/en/book.html",
    "application": "WEBVIEW", //OPEN_URL_APPLICATION_UNSPECIFIED, WEBVIEW, BROWSER
     "webviewViewMode": "FULL"    //   WEBVIEW_VIEW_MODE_UNSPECIFIED, FULL, HALF, TALL            
  }
}

Dial Action

{
  "dialAction": {
    "phoneNumber": "+1234567890"
  }
}

View Location Action

{
  "viewLocationAction": {
    "latLong": {
      "latitude": 40.7128,
      "longitude": -74.0060
    },
    "label": "New York Office"
  }
}

Calendar Event Action

{
  "createCalendarEventAction": {
    "startTime": "2024-01-15T10:00:00Z",
    "endTime": "2024-01-15T11:00:00Z",
    "title": "Meeting Title",
    "description": "Meeting description"
  }
}

Ask Location Action

{
  "askLocationAction": {}
}