Understand what an SMS delivery receipt (DLR) tells you and what to check when one does not arrive.
What a delivery receipt means
A successful send-SMS response means that cloudnumbering accepted the message for sending. It does not confirm delivery to the handset. A delivery receipt reports the final outcome for the message: delivered or rejected. cloudnumbering does not send intermediate status callbacks on the current outbound path.
To receive receipts, include a public HTTPS callback URL as dlrUrl when you send the SMS, and save the message SID from the send response so you can match it to the receipt.
For the callback payload, receiver implementation, and duplicate handling, see Process SMS delivery receipts in the developer documentation.
Note: Delivery-receipt callbacks are not signed, and cloudnumbering does not publish a retry schedule or delivery guarantee. Do not use a callback by itself to authorise a sensitive action.
Troubleshooting
No delivery receipt arrives
Check that the original request included dlrUrl, that the endpoint is publicly reachable over HTTPS, and that your server accepted the request. A receipt is available only after cloudnumbering receives a status update from the delivery network.
I cannot match the receipt to my message
Match the receipt's sid to result.sid from the send-SMS response.
The receipt says rejected
Check the destination number and sender, then follow Troubleshooting SMS. Keep the message SID and request ID, when available, for support.
Comments
0 comments
Please sign in to leave a comment.