We are slowly increasing our SMS traffic through the RingCentral A2P 10DLC , moving it incrementally from another provider. Today we had our first ERROR reported in the metrics (graph) given in the RingCentral Developer Portal. It seems that currently we have no way to see the error detail of this delivery error.
While I know we can persist the SMS MessageID on our side and then query the delivery detail, we currently do not do that because other providers give access to this detail via reports.
Can you please tell me how we can get access to this error detail without querying by MessageID?
You can read the A2P message store using a batch id to fetch the report for a particular batch. However, you have to save the batch id somewhere in your database after sending a batch (right now we don't have yet an API for querying history batches). You can see the error code of each message which failed. However, if a failure is not identified, the errorCode will be omitted. We are still improving the error list and will add more error codes and detect more failure situations.
/restapi/v1.0/account/~/a2p-sms/messages?batchId=batchId
// Response { "records": [ { "id": "52511", "from": "+16505550100", "to":["+1650111222], "createdAt": "2020-10-14T21:47:51.436491Z", "lastUpdatedAt": "2020-10-14T21:47:53.032416Z", "messageStatus": "Delivered", "cost": 0.007, "segmentCount": 1 }, { "id": "52494", "from": "+16505550100", "to":["+1650222333], "createdAt": "2020-10-14T20:21:23.979729Z", "lastUpdatedAt": "2020-10-14T20:21:25.254851Z", "messageStatus": "Delivered", "cost": 0.007, "segmentCount": 1 }, { "id": "52485", "from": "+16505550100", "to":["+1650333444], "createdAt": "2020-10-14T20:19:56.505461Z", "lastUpdatedAt": "2020-10-14T22:20:01.728022Z", "messageStatus": "DeliveryFailed", "errorCode": "SMS-CAR-104", "cost": 0.007, "segmentCount": 1 }, { "id": "52484", "from": "+16505550100", "to":["+1650444555], "createdAt": "2020-10-14T20:19:18.415601Z", "lastUpdatedAt": "2020-10-14T20:19:18.668841Z", "messageStatus": "SendingFailed" } ], "paging": { "pageToken": "pgt1", "perPage": 3, "firstPageToken": "fpgt1", "previousPageToken": "lpgt1", "nextPageToken": "npgt1" } }
As you can see, some message failed in sending but does not have the error code in the response. This is because we have not implemented to return error for invalid recipient's number yet. We will improve that in the next releases.
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