Skip to content
MMS/
/
MM7_DeliveryReport
Last updated

MM7_DeliveryReport

Receive delivery reports for sent MT. Get delivery report for previously sent MMS messages.

Receive Delivery Reports for previously submitted MT

Sinch sends delivery reports using the MM7 Delivery Report message type, DeliveryReportReq. The delivery report indicates the current state of the original submit request message. We will send a delivery report to your platform only when the appropriate information is available. If the delivery report message is accepted or rejected then respond with an DeliveryReportRsp, including a status that indicates why the delivery report was accepted/rejected. For information about the status codes returned for Delivery Reports, please see our Delivery Report Statuses documentation.

MM7_DeliveryReport.REQ

MM7 delivery report request elements

ElementDescriptionReturned
TransactionIDThis identifies the DeliveryReportReq/DeliveryReportRsp pair. It's Sinch generated ID.Always
DeliveryReportReqIdentifies the message as an MM7 Delivery Report.Always
MM7VersionIdentifies the MM7 Version. (Supported versions are ver-5.3.0 and ver-6.8.0)Always
RecipientThe mobile phone number of the end user. This must be a valid mobile number in international format without a leading + symbol; for example, 12515550123 (US) and 447700900750 (UK).Always
SenderYour shortcode. This should match the same information that's linked in the MT configuration, and generally to the service you are providing.Always
MessageIDSinch generated ID linked to the submitted message. This ID was returned to your system in the initial response (SubmitRsp) to your MT MMS request.Always
DateThe date and time of the submission of the multimedia message (timestamp). Value is in UTC.Always
MMStatusA code that indicates whether the MT message was delivered successful or failed. For information about the status codes returned for Delivery Reports, please see our Delivery Report Statuses documentation.Always
UACapabilitiesAlso known as MMS User Agent capabilities. This describes the capabilities of the MMS User agent of the mobile handset.Only when provided by mobile operator

See the Unsupported MM7 SOAP Elements document for more information.

Example Request

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns=
"http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4">
<soap-env:Header>
   <TransactionID soap-env:mustUnderstand="1">10000001</TransactionID>
</soap-env:Header>
<soap-env:Body>
   <DeliveryReportReq>
      <MM7Version>6.8.0</MM7Version>
      <MessageID>369500617770864640</MessageID>
      <Recipient>
         <Number>16175550123</Number>
      </Recipient>
      <Sender>
         <Number>111122</Number>
      </Sender>
      <Date>2015-03-16T14:03:51.749Z</Date>
      <MMStatus>Retrieved</MMStatus>
      <StatusText>Success</StatusText>
      <UACapabilities UAProf="Samsung Galaxy" />
   </DeliveryReportReq>
</soap-env:Body>
</soap-env:Envelope>

MM7_DeliveryReport.RES

MM7 delivery report response elements

Your system should respond to the delivery report request with a delivery report response containing the elements described in the following table.

ElementDescription
TransactionIDIdentifies the DeliveryReportReq/DeliveryReportRsp pair. It's part of the SOAP header. The value that was provided with the deliveryReportReq is returned.
DeliveryReportRspIdentifies the message as an MM7 Delivery Report Response.
MM7VersionIdentifies the MM7 Version.(Supported versions are ver-5.3.0 and ver-6.8.0)
StatusCodeA code that indicates whether you received the MO message request successfully. The status code for successful deliver is 1000. See all MMS status codes.
StatusTextDescription of the status code.

Example Response

<?xml version="1.0" encoding="UTF-8" ?>
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi=
"http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap-env:Header>
   <TransactionID xmlns="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4" soap-env:mustUnderstand="1">1000001</TransactionID>
</soap-env:Header>
<soap-env:Body>
   <DeliveryReportRsp xmlns="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4">
      <MM7Version>6.8.0</MM7Version>
      <Status>
         <StatusCode>1000</StatusCode>
         <StatusText>Successfully Received MMS.</StatusText>
      </Status>
   </DeliveryReportRsp>
</soap-env:Body>
</soap-env:Envelope>

Delivery Report Full Example

Request

POST / HTTP/1.1
SOAPAction: "http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4"
Content-Type: multipart/related; type="text/xml";
Host: api.Mblox.com
Content-Length: 2546
x-mblox-operator-id: 0001890
Connection: Keep-Alive

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns=
"http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4">
<soap-env:Header>
   <TransactionID soap-env:mustUnderstand="1">10000001</TransactionID>
</soap-env:Header>
<soap-env:Body>
   <DeliveryReportReq>
      <MM7Version>6.8.0</MM7Version>
      <MessageID>369500617770864640</MessageID>
      <Recipient>
         <Number>16175550123</Number>
      </Recipient>
      <Sender>
         <Number>111122</Number>
      </Sender>
      <Date>2015-03-16T14:03:51.749Z</Date>
      <MMStatus>Retrieved</MMStatus>
      <StatusText>Success</StatusText>
      <UACapabilities UAProf="Samsung Galaxy" />
   </DeliveryReportReq>
</soap-env:Body>
</soap-env:Envelope>

Response

HTTP/1.1 200 OK
Server: Apache
Content-Type: text/xml; charset=utf-8
Content-Length: 539
Date: Mon, 16 Mar 2015 14:03:32 GMT

<?xml version="1.0" encoding="UTF-8" ?>
<soap-env:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi=
"http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap-env:Header>
   <TransactionID xmlns="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4" soap-env:mustUnderstand="1">1000001</TransactionID>
</soap-env:Header>
<soap-env:Body>
   <DeliveryReportRsp xmlns="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4">
      <MM7Version>6.8.0</MM7Version>
      <Status>
         <StatusCode>1000</StatusCode>
         <StatusText>Successfully Received MMS.</StatusText>
      </Status>
   </DeliveryReportRsp>
</soap-env:Body>
</soap-env:Envelope>
Previous page
Next page