Skip to main content
Question

How to deeplink to the conversation after sending SMS?


Hello,


I'm in the process of developing a mobile application with RingCentral integration, and I've encountered a challenge that I hope you can assist me with.


Within my application, I've successfully created an interface that permits users to send SMS messages. These messages are transmitted through the RingCentral API. My next goal is to extend this functionality by adding a deep link from my application to the RingCentral app. Ideally, upon sending an SMS message from my app, the user should be redirected to the corresponding conversation in the RingCentral app.


In my research, I came across this deep link schema: `/chat/r?groupid=<groupid>`, which seems to facilitate the exact redirection I desire. However, I am struggling to understand how to retrieve the required `groupid` variable.


To send an SMS, I'm already using the RingCentral API which provides me with a `conversationId`. I initially thought this ID would correspond to the `groupid`, but it appears that's not the case.


Could you kindly provide guidance on how to obtain the `groupid` for a conversation, or if there's an alternative method to achieve the same result? Any relevant documentation, sample code, or step-by-step instructions would be greatly appreciated.


Thank you in advance for your assistance.

4 replies

PhongVu
Community Manager
Forum|alt.badge.img
  • Community Manager
  • 2275 replies
  • May 10, 2023

First of all, SMS is standard and it is plain text. It does not support deep link.

When you send an SMS text message with some number in the message, if the number is long enough to be a phone number, most smart phones and SMS applications will guess that it's a phone number and let the receiver click the number to dial. No need to add the href="tel:..." URI scheme to the message. Similar for links, you can send the entire link such as "ringcentral.com" and the receiver can click on it as most SMS apps recognize it as a link. No need to send a hyperlink e.g. <a href="ringcentral.com">RingCentral</a> because all the text will be displayed. As far as I know, most SMS apps do not recognize custom URL scheme.

Secondly, "rcapp://chat/r?groupid=<chat id>" is RingCentral custom URL scheme. It would work with Web browser only (but currently it is not supported by the RC app). Just in case you still want to know where to get the "chat id", you can call these APIs to list all chats, conversations or teams in your RingCentral Team Messaging

https://developers.ringcentral.com/api-reference/Chats/listGlipChatsNew

https://developers.ringcentral.com/api-reference/Conversations/listGlipConversationsNew

https://developers.ringcentral.com/api-reference/Teams/listGlipTeamsNew

You will find the id in each record returned in the response.

Lastly, the conversationId of SMS which is returned from the SMS API is different from the id in Team Messaging. It is the conversation id of the SMS conversation, NOT the Team Messaging conversation.


Can I deeplink to the SMS conversation?


ByrneReese
Community Manager
Forum|alt.badge.img+3
  • Product Manager
  • 185 replies
  • January 21, 2025

@vadympolishchuk  You cannot deeplink to an existing conversation, but these two new URI schemes were recently added: 

  • Open new text dialog in RC desktop app: rcapp://r/sms?type=new
  • Open the text conversation in RC desktop app, with a number pre-populated: rcapp://r/sms?type=new&number=<phone number>

PhongVu
Community Manager
Forum|alt.badge.img
  • Community Manager
  • 2275 replies
  • January 22, 2025

We also support with message content

rcapp://r/sms?type=new&number=<phone number>&content=Hello from click to text"


Reply


Cookie policy

We use cookies to enhance and personalize your experience. If you accept you agree to our full cookie policy. Learn more about our cookies.

 
Cookie settings