RCS Business Messaging

RCS Business Messaging is an alternative to SMS. To deliver the messages, telecom operators are used, allowing you to send rich content instead of simple text messages. Unfortunately, RCS Business Messaging is not yet available in every country. If you are interested in learning more and want access to resources to assist with the setup, please contact us via our RCS Business Messaging product page.

Text message

You can send text messages over RCS Business Messaging using the conversation bubble by simply adding a text object containing your message. You can also add a fallback option in case your recipient is not RCS-capable; they will then receive an SMS message with fallback text.

Message text example

{
   "messages":{
      "authentication":{
         "productToken":"your product token"
      },
      "msg":[
         {
            "from":"RCS Sender Name",
            "allowedChannels":[
               "RCS",
               "SMS"
            ],
            "body":{
               "type":"auto",
               "content":"Fallback Text"
            },
            "to":[
               {
                  "number":"0031612345678"
               }
            ],
            "richContent":{
               "conversation":[
                  {
                     "text":"A RCS text message"
                  }
               ]
            }
         }
      ]
   }
}

Media message

One of the rich features that RCS Business Messaging provides is the media message. You can send a message with an image, PDF, or video of your choice.

Message image example

{
   "messages":{
      "authentication":{
         "productToken":"your product token"
      },
      "msg":[
         {
            "from":"RCS Sender Name",
            "allowedChannels":[
               "RCS"
            ],
            "body":{
               "content":"Fallback Text"
            },
            "to":[
               {
                  "number":"0031612345678"
               }
            ],
            "richContent":{
               "conversation":[
                  {
                     "media":{
                        "mediaName":"conversational-commerce",
                        "mediaUri":"https://www.cm.com/cdn/web/nl-nl/blog/conversational-commerce.jpg",
                        "mimeType":"image/jpeg"
                     }
                  }
               ]
            }
         }
      ]
   }
}

Message PDF example

{
   "messages":{
      "authentication":{
         "productToken":"your product token"
      },
      "msg":[
         {
            "from":"RCS Sender Name",
            "allowedChannels":[
               "RCS"
            ],
            "body":{
               "content":"Message"
            },
            "to":[
               {
                  "Number":"0031612345678"
               }
            ],
            "richContent":{
               "conversation":[
                  {
                     "media":{
                        "mediaName":"test pdf",
                        "mediaUri":"https://pdfobject.com/pdf/sample.pdf",
                        "mimeType":"application/pdf"
                     }
                  }
               ]
            }
         }
      ]
   }
}

Message video example

{
   "messages":{
      "authentication":{
         "productToken":"your product token"
      },
      "msg":[
         {
            "from":"RCS Sender Name",
            "allowedChannels":[
               "RCS"
            ],
            "body":{
               "content":"Message"
            },
            "to":[
               {
                  "Number":"0031612345678"
               }
            ],
            "richContent":{
               "conversation":[
                  {
                     "media":{
                        "mediaName":"testvideo.mp4",
                        "mediaUri":"https://drive.google.com/u/0/uc?id=1yT3WYhFeyT_gQtdggGfvDynxkpmIOnWS&export=download",
                        "mimeType":"video/mp4"
                     }
                  }
               ]
            }
         }
      ]
   }
}

Reply and open link message

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.

Message example

{
	"messages": {
		"authentication": {
			"productToken": "your product token"
		},
		"msg": [{
			"from": "RCS Sender Name",
			"to": [{
				"number": "0031612345678"
			}],
			"body": {
				"content": "Fallback."
			},
			"allowedChannels": ["RCS"],
			"richContent": {
				"conversation": [{
					"text": "We hope you like it!"
				}],
				"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"
					}
				]
			}
		}]
	}
}

Location message

Share any location with a location action. When clicked, this will open the user's navigation app with a pin at the specified location.

Message example

{
	"messages": {
		"authentication": {
			"productToken": "your product token"
		},
		"msg": [{
			"from": "RCS Sender Name",
			"to": [{
				"number": "0031612345678"
			}],
			"body": {
				"content": "Fallback."
			},
			"allowedChannels": ["RCS"],
			"richContent": {
				"conversation": [{
					"text": "We hope you like it!"
				}],
				"suggestions": [{
					"action": "viewLocation",
					"viewLocation": {
						"latitude": "51.603802",
						"longitude": "4.770821",
						"label": "CM HQ"
					},
					"label": "Open in maps"
				}]
			}
		}]
	}
}

Dial message

If you want to share a quick dial button with the recipient, you can send a dial action.

Dial message example

{
	"messages": {
		"authentication": {
			"productToken": "your product token"
		},
		"msg": [{
			"from": "RCS Sender Name",
			"to": [{
				"number": "0031612345678"
			}],
			"body": {
				"content": "Fallback."
			},
			"allowedChannels": ["RCS"],
			"richContent": {
				"conversation": [{
					"text": "We hope you like it!"
				}],
				"suggestions": [{
					"action": "Dial",
					"label": "Call us",
					"dial": {
						"PhoneNumber": "+310612345"
					}

				}]
			}
		}]
	}
}

Agenda message

Send your recipient a calendar event. When clicked, this will open the user's calendar app to add a new appointment.*

*only available with some operators.

Agenda message example**

{
	"messages": {
		"authentication": {
			"productToken": "your product token"
		},
		"msg": [{
			"from": "RCS Sender Name",
			"to": [{
				"number": "0031612345678"
			}],
			"body": {
				"content": "Fallback."
			},
			"allowedChannels": ["RCS"],
			"richContent": {
				"conversation": [{
					"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"
                    }
                }]
			}
		}]
	}
}

Media with buttons message

Enhance your RCS messaging by combining media messages with action buttons, allowing recipients to engage with images or videos while performing tasks like visiting a website or sending a quick response.

Message example

{
	"messages": {
		"authentication": {
			"productToken": "your product token"
		},
		"msg": [{
			"from": "RCS Sender Name",
			"to": [{
				"number": "0031612345678"
			}],
			"body": {
				"content": "Fallback."
			},
			"allowedChannels": ["RCS"],
			"richContent": {
				"conversation": [{
					"header": "CM.com wants to reach out to you.",
					"text": "How do you want to be contacted?",
					"media": {
						"mediaName": "conversational-commerce",
						"mediaUri": "https://www.cm.com/cdn/web/nl-nl/blog/conversational-commerce.jpg",
						"mimeType": "image/jpeg"
					},
					"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"
						}
					]
				}]
			}
		}]
	}
}

Carousel message

One of the most significant and unique features that RCS Business Messaging offers is the RCS carousel message. In an RCS carousel message, you can line up to ten rich cards side by side. Each card can contain a header, text, image, and button.

Message example

{
	"messages": {
		"authentication": {
			"productToken": "your product token"
		},
		"msg": [{
			"body": {
				"content": "Fallback Text"
			},
			"to": [{
				"number": "0031612345678"
			}],
			"from": "RCS Sender Name",
			"allowedChannels": ["RCS"],
			"richContent": {
				"conversation": [{
					"carousel": {
						"cards": [{
								"header": "CM.com - Be part of it.",
								"text": "Want to know more about CM.com?",
								"media": {
									"mediaName": "cm-tablet.jpg",
									"mediaUri": "https://www.cm.com/cdn/web/blog/featured/cm-tablet.jpg",
									"mimeType": "image/jpeg"
								},
								"suggestions": [{
									"action": "OPENURL",
									"label": "Visit CM.com",
									"url": "https://www.cm.com/",
									"postbackdata": "visit-cm"
								}]
							},
							{
								"header": "CM.com - Customer Satisfaction",
								"text": "17 Ways To Enhance Your Customer Satisfaction",
								"media": {
									"mediaName": "customer-contact-channels.png",
									"mediaUri": "https://www.cm.com/cdn/web/blog/content/customer-contact-channels.png",
									"mimeType": "image/png"
								},
								"suggestions": [{
									"action": "OPENURL",
									"label": "Visit CM.com - CCC",
									"url": "https://www.cm.com/blog/17-ways-business-messaging-enhances-your-customer-satisfaction/",
									"postbackdata": "visit-cm"
								}]
							}
						]
					}

				}]
			}
		}]
	}
}