Skip to main content

What is an RCS Deeplink?

An RCS deeplink is a special URL that starts an RCS conversation when opened in RCS enabled Android phone. The phone needs Google Messages to be installed and a minimum OS version of messages.android_20241029_00. The URL by itself will not open due to browser security measures and so it needs to be embedded in a HTML button or link, or else rendered as QR code. An optional message body and fallback phone number may be passed as a query string and path parameter respectively in the URL. The fallback phone number can used as an alternative channel of communication in the case where RCS is not enabled on the device.

Example Usage

With Fallback Phone Number and Message Body

Request

curl -L 'https://api.telnyx.com/v2/messages/rcs/deeplinks/:agent_id?phone_number=%2B15554443333&body=hello%20world' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Response

{
"data": {
"url": "sms:+18445550001?service_id=agent_id%40rbm.goog&body=hello%20world"
}
}

Without Fallback Phone Number and Message Body

curl -L 'https://api.telnyx.com/v2/messages/rcs/deeplinks/:agent_id' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Response

{
"data": {
"url": "sms:agent_id%40rbm.goog"
}
}

Further Reading

https://developers.google.com/business-communications/rcs-business-messaging/guides/build/deeplinks

https://www.gsma.com/solutions-and-impact/technologies/networks/wp-content/uploads/2024/06/RCC.07-v14.0.pdf#page=167