Rich card messages
Rich cards combine media, text, and interactive suggestions into a single message.
Rich Cards Requirement
Card Contents
A rich card can contain the following elements:
- Media (image, GIF, or video)
- Title text
- Description text
- Suggestions (suggested replies and suggested actions, maximum 4)
All fields are optional, but at least one of the first three elements must be included in the rich card.
Card Orientation
Card orientation can be set to either "vertical" or "horizontal".
Media
Supported Image Types:
- JPEG/JPG
- GIF
- PNG
Supported Video Types:
- H.263
- M4V
- MP4
- MPEG
- MPEG-4
- WebM
Card Height
Rich cards expand vertically to fit their contents:
- Minimum height: 112 DP
- Maximum height: 344 DP
If card contents aren't large enough to fill the minimum card height, the card expands and fills the extra height with whitespace.
Media Height
Media in rich cards must fit one of three heights:
- Short: 112 DP
- Medium: 168 DP
- Tall: 264 DP
If the media doesn't fit the dimensions within the card given the selected height, the media preview is adjusted by zooming and cropping the media.
Rich Card Types
The following rich card types are supported, the suggested actions/replies can be combined:
Rich card message example
{
"messages": {
"msg": [
{
"from": "RCS Sender Name",
"allowedChannels": [
"RCS"
],
"body": {
"content": ""
},
"to": [
{
"number": "0031612345678"
}
],
"richContent": {
"conversation": [
{
"header": "Headers are written in bold",
"text": "This text is not bold",
"cardOrientation": "HORIZONTAL",
"thumbnailAlignment": "RIGHT",
"media": {
"mediaHeight": "small",
"mediaName": "imagetest.jpg",
"mediaUri": "https://www.cm.com/cdn/web/opengraph/cm-default-og.jpg",
"mimeType": "image/jpg"
}
}
]
}
}
]
}
}
Rich card without media example
Add buttons to your RCS message to suggest actions for your recipient. You can include buttons that directly open links to your website or offer suggested replies. Suggested action buttons cannot exceed 25 characters.
{
"messages": {
"msg": [
{
"from": "RCS Sender Name",
"to": [
{
"number": "0031612345678"
}
],
"allowedChannels": [
"RCS"
],
"body": {
"content": ""
},
"richContent": {
"conversation": [
{
"header": "CM.com wants to reach out to you.",
"text": "We hope you like it!",
"suggestions": [
{
"action": "Openurl",
"label": "Go to website",
"url": "https://www.cm.com",
"postbackdata": "Click on website"
},
{
"action": "Reply",
"label": "Email me"
},
{
"action": "Reply",
"label": "Send me an sms"
}
]
}
]
}
}
]
}
}
Rich card with suggested replies example
Add buttons to your RCS message to suggest actions for your recipient. You can include buttons that offer suggested replies. Suggested action buttons cannot exceed 25 characters.
{
"messages": {
"msg": [
{
"from": "RCS Sender Name",
"to": [
{
"number": "0031612345678"
}
],
"body": {
"content": ""
},
"allowedChannels": [
"RCS"
],
"richContent": {
"conversation": [
{
"header": "CM.com wants to reach out to you.",
"text": "We hope you like it!",
"suggestions": [
{
"action": "Reply",
"label": "Email me"
},
{
"action": "Reply",
"label": "Send me an sms"
}
]
}
]
}
}
]
}
}
Rich card with dial button(s) example
{
"messages": {
"msg": [
{
"from": "RCS Sender Name",
"to": [
{
"number": "0031612345678"
}
],
"body": {
"content": ""
},
"allowedChannels": [
"RCS"
],
"richContent": {
"conversation": [
{
"header": "CM.com wants to reach out to you.",
"text": "We hope you like it!",
"suggestions": [
{
"action": "Dial",
"label": "Call us",
"dial": {
"PhoneNumber": "+310612345"
}
}
]
}
]
}
}
]
}
}
Rich card with location example
Share any location with a location action. When clicked, this will open the user's navigation app with a pin at the specified location. Suggested action buttons cannot exceed 25 characters.
{
"messages": {
"msg": [
{
"from": "RCS Sender Name",
"to": [
{
"number": "0031612345678"
}
],
"body": {
"content": ""
},
"allowedChannels": [
"RCS"
],
"richContent": {
"conversation": [
{
"header": "CM.com wants to reach out to you.",
"text": "We hope you like it!",
"suggestions": [
{
"action": "viewLocation",
"viewLocation": {
"latitude": "51.603802",
"longitude": "4.770821",
"label": "CM HQ"
},
"label": "Open in maps"
}
]
}
]
}
}
]
}
}
Rich card with agenda example
Send your recipient a calendar event. When clicked, this will open the user's calendar app to add a new appointment. Action buttons cannot exceed 25 characters.
Not available in all countries!
{
"messages": {
"msg": [
{
"from": "RCS Sender Name",
"to": [
{
"number": "0031612345678"
}
],
"body": {
"content": ""
},
"allowedChannels": [
"RCS"
],
"richContent": {
"conversation": [
{
"header": "CM.com wants to reach out to you.",
"text": "We hope you like it!",
"suggestions": [
{
"action": "CreateCalendarEvent",
"label": "Add to calendar",
"calendar": {
"startTime": "2025-02-05T00:00:00Z",
"endTime": "2025-02-08T00:00:00Z",
"description": "Calendar demo",
"title": "Demo"
}
}
]
}
]
}
}
]
}
}
Rich card with OpenUrl example
Add buttons to your RCS message to suggest actions for your recipient. You can include buttons that directly open links to your website. Suggested action buttons cannot exceed 25 characters.
{
"messages": {
"msg": [
{
"from": "RCS Sender Name",
"to": [
{
"number": "0031612345678"
}
],
"body": {
"content": ""
},
"allowedChannels": [
"RCS"
],
"richContent": {
"conversation": [
{
"header": "CM.com wants to reach out to you.",
"text": "We hope you like it!",
"suggestions": [
{
"action": "Openurl",
"label": "Go to website",
"url": "https://www.cm.com",
"postbackdata": "Click on website"
}
]
}
]
}
}
]
}
}
Rich card with OpenUrl Web view example
WebviewMode can be "full", "half" or "tall".
Not available in all countries!
{
"messages": {
"msg": [
{
"from": "RCS Sender Name",
"to": [
{
"number": "0031612345678"
}
],
"body": {
"content": ""
},
"allowedChannels": [
"RCS"
],
"richContent": {
"conversation": [
{
"header": "CM.com wants to reach out to you.",
"text": "We hope you like it!",
"suggestions": [
{
"action": "Openurl",
"label": "Go to website",
"url": "https://www.cm.com",
"openUrlProperties": {
"application": "WEBVIEW",
"webviewMode": "tall"
}
},
{
"action": "Reply",
"label": "Email me"
},
{
"action": "Reply",
"label": "Send me an sms"
}
]
}
]
}
}
]
}
}