Is there a way to get notifications of status changes of outbound SMS. As in we have sent an SMS through the API.. can we subscride to a status change event, becuase initially what you get when yuou create the message is 'Queued' is there a way to register (subscribe) to an event/notification that lets you know that the message sent. Looking at the Notifications Types, is it to do with Message Event? as in I would have to subscribe to /restapi/v1.0/account/{accountId}/extension/{extensionId}/message-store?type=SMS&direction=Outbound
to receive status changes on sent messages? would that be correct.
and for Inbound SMS the event is
/restapi/v1.0/account/{accountId}/extension/{extensionId}/message-store/instant?type=SMS
I'm confused as to why inbound SMS wouldn't just be (whats the difference between Message Event and Instant Message Event?)
/restapi/v1.0/account/{accountId}/extension/{extensionId}/message-store?type=SMS&direction=Inbound
and ultimately if I would like to subscribe to any Outbound SMS status changes and any Inbound SMS, can I just do one subscription and 2 event Filters? something like
POST .../restapi/v1.0/subscription
{
"eventFilters": [
"/restapi/v1.0/account/{accountId}/extension/{extensionId}/message-store?type=SMS&direction=Inbound",
"/restapi/v1.0/account/{accountId}/extension/{extensionId}/message-store?type=SMS&direction=Outbound",
],
"deliveryMode": {
"transportType": "WebHook"
}
}
How long do apps typically take to get approved? We've been waiting a few days. Any chance of helping us to get it moving along :) Would like to get some real users up and running.
Thanks!
App client id or app name?
- Appointment Reminder
Approved!
Thank you!
Hei Matt,
You app is a public app and named Appointment reminder. Do you want to check with this customer who is looking for an appointment reminder to see if your app is a fit for his needs.
Thank you. Have replied! Are you able to help us get listed in your App Marketplace? I have added in the info in the developer console a few weeks ago but nothing has progressed. Thanks!
Thanks for replying to the customer question about appointment reminder! I see your request for app gallery listing request. I am not responsible for approving it. But I will ask my colleague to speed up (today is a day off in RingCentral though :( ).
I also want to see a demo of your integration so that I can help you better to reach out to more potential customers. Are you willing to jump on a call some time next week so we can talk more about this?
Absolutely. Can email matthew@appointmentreminder.com for contact info.
The event is for getting notified when something has changed in the user message store such as an inbound message readStatus is set "Read", a message is deleted, an outbound message messageStatus is changed etc. You will only get the message id in the payload and you will have to call the message store using the id to get the changed value.
While the /instant?type=SMS is purely for receiving inbound text message with the text and other properties of the message.
I don't mind too much that the message-store event type just returns the Message id,
I can then make a call to get the full details, but I can't see any mention of a message id in the docs here :
Office API Reference | RingCentral Developers
So I'm a bit confused, just seems to return counts? not message ids?
It has uuid notificationId/ownerId/subscriptionId/accountid/extensionid but no mention of messageId/s
A sample of a new message change to the message store
{ "uuid": "3899647630666415164", "event": "/restapi/v1.0/account/80964xxxx/extension/6228832xxxx/message-store", "timestamp": "2023-02-14T05:09:15.241Z", "subscriptionId": "5a1075c5-6a20-47de-aec2-f88c47688958", "ownerId": "6228832xxxx", "body": { "accountId": 80964xxxx, "extensionId": 6228832xxxx, "lastUpdated": "2023-02-14T05:09:08.435Z", "changes": [ { "type": "SMS", "newCount": 1, "updatedCount": 0, "newMessageIds": [ 1908413703016 ] } ] } }
wow so there is no mention of `newMessageIds` in the docs at all. Does that mean there is an `updateMessageIds` and `deletedMessageIds` array as well? Would be useful if the documentation actually explained this a bit better
I think the message id was added some time ago. However, I just check and there is no message id(s) for updated count. So it's quite useless.
"changes":[{"type":"SMS","newCount":0,"updatedCount":3,"newMessageIds":[]}]
right.. useless is right. Is there any plan to actually correct this API.. as in actually make it of some value.. because at the moment.. getting a webhook that 3 messages have updated but not which messages.. is completely pointless...
So in summary. There is presently no webhook that I can use to notify when an outbound SMS has changed status. The best I could do ATM is to poll for specific messages through the GetMessage endpoint
`/restapi/v1.0/account/accountId/extension/extensionId/message-store/messageId `
I checked with the team internally and they said that the missing of updatedMessageIds[] is expected due to a dependency on other parts of the platform.
So yes, very unfortunately, that we have to poll and check, which is not reliable and efficient.
Let me explore further with the team to see this can be improved in the future.
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