If you requested a delivery receipt upon submitting your MMS, Vibes will send your endpoint DeliveryReportReq
when the delivery receipt information is available.
Blank responses
The MO and delivery receipt responses can support blank responses. For a client who is new to MM7 and SOAP format, this allows an easier integration by accepting a response with HTTP 200 and a response text of blank.
Request
The elements of a request are as follows:
Element | Required? | Version | Description |
---|---|---|---|
| Yes | Both | The |
| Yes | Both | FOR MM7 5.5.0: FOR MM7 6.8.0: |
| Yes | Both | The |
| Yes | Both | The recipient address for the MMS. The |
| Yes | Both | The source address for the MMS. The |
| Yes | Both | The date and time the report was generated. Format is the XML date/time format: yyyy-MM-dd'T'HH:mm:ssZ. |
| Yes | Both | When requesting a delivery receipt for MMS, you will receive a response with one of five MM7 MMStatuses:
|
| No | 6.8.0 | Not supported. |
| No | Both | If message delivery was not successful, you may also receive
See our delivery receipt responses appendix for a list of possible error codes. |
| No | 6.8.0 | Not supported. |
| No | 6.8.0 | Not supported. |
| No | 6.8.0 | Not supported. |
| No | 6.8.0 | If supported by the carrier, it is set within the |
| No | 6.8.0 | If supported by the carrier, it is set within the |
Examples
Vibes supports MM7 protocol for multiple versions of MM7, so be sure you’re referencing the correct MM7 version before you get started.
Status: Retrieved
****
****
****
****
CHOOSE YOUR MM7 VERSION BY SELECTING THE CORRESPONDING TAB ABOVE
****
****
****
****
<?xml version="1.0" encoding="utf-16"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header>
<mm7:TransactionID SOAP-ENV:mustUnderstand="1" xmlns:mm7="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-5-MM7-1-2">bddf328cc0e36a25</mm7:TransactionID>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<mm7:DeliveryReportReq xmlns:mm7="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-5-MM7-1-2">
<mm7:MM7Version>5.3.0</mm7:MM7Version>
<mm7:MessageID>b26bc7214535794d71f36ee31496284e900-7ffa</mm7:MessageID>
<mm7:Recipient>
<mm7:Number>+13127536330</mm7:Number>
</mm7:Recipient>
<mm7:Sender>
<mm7:Shortcode>63901</mm7:Shortcode>
</mm7:Sender>
<mm7:Date>2014-10-30T21:07:54Z</mm7:Date>
<mm7:MMStatus>Retrieved</mm7:MMStatus>
</mm7:DeliveryReportReq>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
<?xml version="1.0" encoding="utf-16"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header>
<mm7:TransactionID SOAP-ENV:mustUnderstand="1" xmlns:mm7="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4">bddf328cc0e36a25</mm7:TransactionID>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<mm7:DeliveryReportReq xmlns:mm7="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4">
<mm7:MM7Version>6.8.0</mm7:MM7Version>
<mm7:MessageID>b26bc7214535794d71f36ee31496284e900-7ffa</mm7:MessageID>
<mm7:Recipient>
<mm7:Number>+13127536330</mm7:Number>
</mm7:Recipient>
<mm7:Sender>
<mm7:Shortcode>63901</mm7:Shortcode>
</mm7:Sender>
<mm7:Date>2014-10-30T21:07:54Z</mm7:Date>
<mm7:MMStatus>Retrieved</mm7:MMStatus>
</mm7:DeliveryReportReq>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Status: Rejected
****
****
****
****
CHOOSE YOUR MM7 VERSION BY SELECTING THE CORRESPONDING TAB ABOVE
****
****
****
****
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header>
<TransactionID
xmlns="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4" soapenv:mustUnderstand="1">80e7e98c-b665-49d0-98b5-747392493acaD-1
</TransactionID>
</soapenv:Header>
<soapenv:Body
xmlns:ns2="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4">
<ns2:DeliveryReportReq
xmlns="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4">
<ns2:MM7Version>5.3.0</ns2:MM7Version>
<ns2:MessageID>12345a-b665-49d0-98b5-747392493aca</ns2:MessageID>
<ns2:Recipient>
<ns2:Number>+15125551212</ns2:Number>
</ns2:Recipient>
<ns2:Sender>
<ns2:ShortCode>12345</ns2:ShortCode>
</ns2:Sender>
<ns2:Date>2023-07-11T15:29:00.000-05:00</ns2:Date>
<ns2:MMStatus>Rejected</ns2:MMStatus>
<ns2:statusText>Error #301 - Invalid Content Type - The message or content type is not a supported type or maximum size exceeded. [ref: 2004]</ns2:statusText>
</ns2:DeliveryReportReq>
</soapenv:Body>
</soapenv:Envelope>
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header>
<TransactionID
xmlns="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4" soapenv:mustUnderstand="1">80e7e98c-b665-49d0-98b5-747392493acaD-1
</TransactionID>
</soapenv:Header>
<soapenv:Body
xmlns:ns2="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4">
<ns2:DeliveryReportReq
xmlns="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4">
<ns2:MM7Version>6.8.0</ns2:MM7Version>
<ns2:MessageID>12345a-b665-49d0-98b5-747392493aca</ns2:MessageID>
<ns2:Recipient>
<ns2:Number>+15125551212</ns2:Number>
</ns2:Recipient>
<ns2:Sender>
<ns2:ShortCode>12345</ns2:ShortCode>
</ns2:Sender>
<ns2:Date>2023-07-11T15:29:00.000-05:00</ns2:Date>
<ns2:MMStatus>Rejected</ns2:MMStatus>
<ns2:statusText>Error #301 - Invalid Content Type - The message or content type is not a supported type or maximum size exceeded. [ref: 2004]</ns2:statusText>
</ns2:DeliveryReportReq>
</soapenv:Body>
</soapenv:Envelope>
See our response codes appendix for more information. If you still need assistance with a unsuccessful delivery receipt from our Customer Care team, be sure to include the <statusText>
in your message.
Response
Your system's response should include the following elements and attributes.
Element | Required? | Description |
---|---|---|
| Yes | The |
| No | FOR MM7 5.5.0: FOR MM7 6.8.0: |
| Yes | A numeric code indicating the result of the request. View status codes here. |
| Yes | A free-text description of the result of the request. |
| No | Optional free text that may be included to further describe the result of the request. |
Example
****
****
****
****
CHOOSE YOUR MM7 VERSION BY SELECTING THE CORRESPONDING TAB ABOVE
****
****
****
****
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header>
<TransactionID xmlns="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-5-MM7-1-2">fa74d713-e27a-425c-aeec</TransactionID>
</soapenv:Header>
<soapenv:Body xmlns:ns3="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-5-MM7-1-2">
<ns3:DeliveryReportRsp xmlns="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-5-MM7-1-2">
<ns3:Status>
<ns3:StatusCode>1000</ns3:StatusCode>
<ns3:StatusText>Success</ns3:StatusText>
</ns3:Status>
</ns3:DeliveryReportRsp>
</soapenv:Body>
</soapenv:Envelope>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header>
<TransactionID xmlns="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4">fa74d713-e27a-425c-aeec</TransactionID>
</soapenv:Header>
<soapenv:Body xmlns:ns3="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4">
<ns3:DeliveryReportRsp xmlns="http://www.3gpp.org/ftp/Specs/archive/23_series/23.140/schema/REL-6-MM7-1-4">
<ns3:Status>
<ns3:StatusCode>1000</ns3:StatusCode>
<ns3:StatusText>Success</ns3:StatusText>
</ns3:Status>
</ns3:DeliveryReportRsp>
</soapenv:Body>
</soapenv:Envelope>