Suggested replies/actions messages

You can send suggestions in the form of suggestion chip lists, with a maximum of 11 suggestions per (text) message. Each suggestion has a maximum of 25 characters. Suggested replies/actions are also supported in rich messages.

Suggestions come in two types: suggested replies and suggested actions.

Suggested Replies

Suggested replies guide users through conversations by providing responses.

Suggested Actions

Suggested actions guide users through conversations by leveraging the built-in functionality of their devices. Available actions:

• Dial a phone number
• View a location on a map
• Open a URL
• Open a URL with webview
• Create a calendar event

Dial a Number

The Dial action guides the user to dial a phone number specified by you.

Phone number format:

• Can only include digits (0-9), plus sign (+), asterisk (*), and number sign (#)
• E.164 international format (e.g., +14155555555) is supported but not required
• Both +14155555555 and 1011 are valid entries

View a Location

The View location action displays a location in the user's default map app.

Location specification:

• By latitude and longitude, or
• By query based on the user's current location

You can also set a custom label for the pin that displays in the map app.

Open a URL

The Open URL action guides users to a web page specified by you. By default, the web page opens in the user's browser.

Open a URL with Webview

The Open URL with webview action loads the specified web page inside the messaging app using the rendering engine of the user's default browser. This allows users to interact with the web page without leaving the RCS for Business conversation. If the user's device doesn't support webviews, the web page opens in the user's browser instead.

Create a Calendar Event

The Create calendar event action opens the user's calendar app and begins creating a new event with the specified information.

Event parameters:

• Title: Required (maximum 100 characters)
• Description: Optional (maximum 500 characters)

Suggested replies/actions message example

{
    "messages": {
        "msg": [
            {
                "from": "RCS Sender Name",
                "allowedChannels": [
                    "RCS"
                ],
                "body": {
                    "type": "auto",
                    "content": ""
                },
                "to": [
                    {
                        "number": "0031612345678"
                    }
                ],
                "richContent": {
                    "conversation": [
                        {
                            "text": "A RCS text message"
                        }
                    ],
                    "suggestions": [
                        {
                            "action": "Openurl",
                            "label": "Go to website",
                            "url": "https://www.cm.com",
                            "postbackdata": "visit-cm"
                        },
                        {
                            "action": "Reply",
                            "label": "Email me",
                            "postbackdata": "EMAIL"
                        },
                        {
                            "action": "Reply",
                            "label": "Send me an sms",
                            "postbackdata": "SMS"
                        }
                    ]
                }
            }
        ]
    }
}