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.
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?
Unfortunately, the current RC app does not support other URL schemes than the followings. (other URL schemes on the dev guide doc are outdated).
rcapp://r/dialer?number=<phone number>
rcapp://r/call?number=<phone number>
That's sad, but okay.
But I will still try to find the solution to this problem. When I open sms conversation in web application, the link is as follows: https://app.devtest.ringcentral.com/sms/<sms_conversation_id>
Is there any way to get this <sms_conversation_id>?
Unfortunately, the id that can be used with that link is an internal id to the RC app. It's not the SMS conversation id you get from the message storage API.
A new Community is coming to RingCentral!
Posts are currently read-only as we transition into our new platform.We thank you for your patience
during this downtime.
Try Workflow Builder
Did you know you can easily automate tasks like responding to SMS, team messages, and more? Plus it's included with RingCentral Video and RingEX plans!Try RingCentral Workflow Builder
