Receiving message statuses

To receive message status customers must provide an HTTPS url.
Once Digital Media Bridge receives a message status update from carriers, it will send a notification at the provided url.

Request will be done using POST method; request contains a JSON formatted body as below:

{
    "msisdn": "+39111222333",
    "delivery_status": "XXXXX",
    "delivery_date": "YYYY-MM-DD HH:mm:ss",
    "uuid": "xxxx-yyyy-zzzz"
}

msisdn is the original recipient number.
delivery_status is the final state of the message received from the carrier. Possible values are:

  • REJECTD: carrier rejected the message at sending stage
  • DELIVRD: message has been delivered to the final destination
  • EXPIRED: carrier could not deliver the message before expiration time
  • UNDELIV: carrier could not deliver the message to the final destination
  • UNKNOWN: msisdn has an ongoing carrier portability change

delivery_date is the date of the event
uuid is the unique message identifier provided by the customer when sending the message, or the one generated by Digital Media Bridge if not provided by the customer.