RCS

An alternative for SMS, is RCS. To deliver the message also telecom operators are being used, though now you can send rich content instead of pure text messages. Unfortunately RCS is not yet available in each country. When you would be interested to learn more, and get access to resources to assist with the set-up please contact us via our RCS Business Messaging product page.

Text message

You can send text messages over RCS using the Conversation bubble just by simply adding an text object containing your message.
You can also add an fallback in case your recipient is not RCS capable they will then receive an SMS message
with "Fallback test"

Message example

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

Media message

One of the Rich features that RCS provides is the Media message, you can send an Message with an image, PDF or video of choice.

Message Image example

{
   "messages":{
      "authentication":{
         "productToken":"your product token"
      },
      "msg":[
         {
            "from":"RCS Sender Name",
            "allowedChannels":[
               "RCS"
            ],
            "body":{
               "content":"Fallback Text"
            },
            "to":[
               {
                  "number":"00316012345678"
               }
            ],
            "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":"00316012345678"
               }
            ],
            "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":"00316012345678"
               }
            ],
            "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 add buttons that will directly open links to your website or give suggested replies

Message example

{
	"messages": {
		"authentication": {
			"productToken": "your product token"
		},
		"msg": [{
			"from": "RCS Sender Name",
			"to": [{
				"number": "00316012345678"
			}],
			"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 navigation app of your user with a pin at the specified location.

Message example

{
	"messages": {
		"authentication": {
			"productToken": "your product token"
		},
		"msg": [{
			"from": "RCS Sender Name",
			"to": [{
				"number": "00316012345678"
			}],
			"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 to the recipient, you can send a dial action.

Message example

{
	"messages": {
		"authentication": {
			"productToken": "your product token"
		},
		"msg": [{
			"from": "RCS Sender Name",
			"to": [{
				"number": "00316012345678"
			}],
			"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 calender event, when clicked this will open the calendar app of the user to add a new apppointment*

*only available with some operators.

Agenda Message example

{
	"messages": {
		"authentication": {
			"productToken": "your product token"
		},
		"msg": [{
			"from": "RCS Sender Name",
			"to": [{
				"number": "00316012345678"
			}],
			"body": {
				"content": "Fallback."
			},
			"allowedChannels": ["RCS"],
			"richContent": {
				"conversation": [{
					"text": "We hope you like it!"
				}],
				"suggestions": [{
					"action": "CreateCalendarEvent",
					"label": "Add to calendar",
					"calendar": {
						"startTime": "2018-02-05T00:00:00",
						"endTime": "2018-02-08T00:00:00",
						"description": "Calendar demo",
						"title": "Demo"
					}
				}]
			}
		}]
	}
}

Media with buttons message

Combine media messages with action buttons

Message example

{
	"messages": {
		"authentication": {
			"productToken": "your product token"
		},
		"msg": [{
			"from": "RCS Sender Name",
			"to": [{
				"number": "00316012345678"
			}],
			"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 biggest and unique features that RCS has to offer 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 an header, text, image and button.

Message example

{
	"messages": {
		"authentication": {
			"productToken": "your product token"
		},
		"msg": [{
			"body": {
				"content": "Fallback Text"
			},
			"to": [{
				"number": "00316012345678"
			}],
			"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"
								}]
							}
						]
					}

				}]
			}
		}]
	}
}