With Messages v2.2, you can now receive a POST notification of Delivery Receipts (DLRs) for outbound SMS messages sent from your Flowroute long code and toll-free phone numbers. To configure DLR Callback for your account, see Set a Callback URL For Your Account. For more granular control, Flowroute has also released a number-specific messaging callback service in beta. To configure DLR Callback for an individual long code or toll-free phone number, see Set a Callback URL for Your Phone Number.
- You can only send an SMS from a phone number registered on your Flowroute account.
- You are allowed to send 5 SMS per second.
- Flowroute cannot guarantee delivery to any phone number not enabled for SMS.
Upon successful configuration, Flowroute will start posting your SMS delivery receipts to your DLR Callback URL. The HTTP status code in the response header is 200 OK and the response body contains a detailed delivery receipt object in JSON format. You typically receive two delivery reports for every SMS that you send: Level 1 and Level 2. Learn more about the two types in Delivery Receipts. If you do not receive the POST notifications, check that your callback service and DLR Callback URL are set up correctly.
Delivery receipt object composed of the following:
Different attributes of a delivery receipt object:
body string- The content of your outbound SMS.
level integer- This can be 1 for a Level 1 or External Short Messaging Entity (ESME) to carrier delivery or 2 for any message processing thereafter.
status string- Status of the message.
status_code string- Applicable delivery receipt status code. See Delivery Receipt Response Codes for a list of the different responses that you can get.
status_code_description string- Corresponding explanation for the status_code of your delivery receipt.
timestamp datetime - Date and time, to the second, on which the message was sent. This field displays date and time in UTC following the complete date plus hours, minutes and seconds ISO 8601 format.
ID of the SMS message with the mdr2 prefix.
Links object pointing to the related outbound SMS Message Detail Record (MDR).
related string- URL of the message detail record for the sent SMS.
This will always be delivery_receipt.