RingCentral deals with different kinds of APIs that offer reliable VoIP calling, web meetings, fax, and more features over cloud communication with reliability, security, and quality.
In this article, we will discuss the different APIs related to SMS and messaging and it’s various status.
As we have already seen in our previous posts, we can start by logging into our RingCentral developer portal, and all we need to do is create a new application by hitting the CreateApp button in the top right:
The following details need to be provided:
- Application Name: The name of your app.
- Organization Name: The name of your organization.
- Description: Any text describing your app and should contain a minimum of 20 characters.
- We have chosen Desktop (Mac/Windows/Other), and authorization includes password flow in the above image. Once the API is created, we can see details like client id, client secret, etc. in the dashboard:
Testing API via Postman
Creates and sends a new message: You can send SMS messages simultaneously to different recipients up to 50 requests per minute.
The API for sending SMS is:
POST https://platform.devtest.ringcentral.com/restapi/v1.0/account/accountId/extension/extensionId/sms
If you see the messageStatus here, it is queued:
If the status for at least one recipient is ‘Queued‘, then ‘Queued‘ value is returned, which means the message hasn’t reached the SMS provider. If the SMS provider is temporarily unavailable, the message will be ‘Queued‘ and the carrier will continue to retry.
Reading the message status: Every message we send has a message id. We can read the message state by using the following API:
GET https://platform.devtest.ringcentral.com/restapi/v1.0/account/~/extension/~/message-store/<message id>
By this time, if you check the message state, it will show ‘Delivered’ as above, which means the message has reached the recipient.
If the mobile phone we are sending is switched off, the carrier will try to deliver within 48 hours, and if unsuccessful, then the message will expire, and in that case, we will get the status as ‘DeliveryFailed‘.
Deleting the message: We can use the same API to delete the message. For example, if we use the DELETE method as follows:
DELETE https://platform.devtest.ringcentral.com/restapi/v1.0/account/~/extension/~/message-store/<message id>
The API has deleted the message from the message store. It will not provide any response.
Now if we do a GET and check the response, we will see: availability is ‘Deleted‘ :
Message availability status. Message in ‘Deleted‘ state is still preserved with all its attachments and can be restored.
Modifying readStatus of message: We can use the same API with the PUT method and modify the readstatus of the message. There are 2 readStatus: Read, Unread
We can modify as below:
PUT https://platform.devtest.ringcentral.com/restapi/v1.0/account/~/extension/~/message-store/<message id>
As we can see above, we have modified the SMS readStatus into unread.
If we go back to the previous API of Reading the message status, GET https://platform.devtest.ringcentral.com/restapi/v1.0/account/~/extension/~/message-store/<message id> and check the readStatus ofthe message, we will get the below:
We can integrate all these features of the API in our application, which can be a web application or an android or even a standalone running in any programming language, such as Java, PHP, javascript, etc. and control all the messaging features in a single place.
Site Title 