MMS MO Postback V2

Synopsis

The MMS MO postback API notifies you that a customer has replied to your number. To receive MMS MO postback you need to work with your account manager to provision your account. Once the MMS MO postback is enabled you will start receiving postbacks for each MMS MO received.This postback notifies you when an MMS MO is received.

MMS MO Postback Nodes

Postback Parameter	Postback Parameter Description
code	N401
origin	MMS_MO
from	The phone number including the country code of the sender.
to	The shortcode, 10DLC or a TFN recipient.
message-subject	The subject field of the MMS if it exists. Subjects are optional.
tracking-id	The transaction ID for the MMS MO that occurred.
timestamp	The timestamp of the MMS MO received by our server.
content	Contains the file nodes sent in the MMS MO.
file	A series of sub-nodes that contains a single URL to a picture, video, audio or text file sent in the MMS MO within each node. The URL points to the location of the content on our servers. For those developing the back-end handling of the postback URL, you may choose to download/store these content files for whatever purpose you see fit. You may also choose to store the URLs for download at a future time. The file will be removed based on the terms of your contract.

POSTBACK: N401 Request

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MO",
          "code":"N401",
          "from":"SENDER_PHONE_NUMBER_WITH_COUNTRY_CODE",
          "to":"RECEIVER_NUMBER",
          "message-subject":"SUBJECT"
          "tracking-id":"TRACKING_ID",
          "timestamp":"RECEIVED_TIMESTAMP",
          "content":[
              {
                  "file":"FILE_URL"
              },
              ...
          ]
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: N401 Examples (MMS MO Received)

VIDEO ONLY (Verizon - iPhone7)
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MO",
          "code":"N401",
          "from":"10000000000",
          "to":"00000",
          "message-subject":"Test34324",
          "tracking-id":"MMSMOT0OTq6AK",
          "timestamp":"2021-02-03T18:27:54.235957+00:00",
          "content":[
              {
                  "file":https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/T0OTq6AK\/0.smil"
              },
              {
                  "file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/IMG-0381s.3gp"
              }
          ]
      }’ \
  "POSTBACK_ENDPOINT_URL"

IMAGE + TEXT (Verizon - iPhone7)
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MO",
          "code":"N401",
          "from":"10000000000",
          "to":"00000",
          "message-subject":"Test34324",
          "tracking-id":"MMSMOkZyVKAlH",
          "timestamp":"2021-02-03T17:56:45.341093+00:00",
          "content":[
              {
                  "file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/kZyVKAlH\/0.smil"
              },
              {
                  "file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/kZyVKAlH\/IMG_5294.JPG"
              },
              {
                  "file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/kZyVKAlH\/text_1.txt"
              }
          ]
      }’ \
  "POSTBACK_ENDPOINT_URL"

VIDEO + TEXT (Sprint - Google Pixel3)
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MO",
          "code":"N401",
          "from":"10000000000",
          "to":"00000",
          "message-subject":"",
          "tracking-id":"MMSMOpwSgxEQA",
          "timestamp":"2021-02-03T18:39:15.999458+00:00",
          "content":[
              {
                  "file":https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/smil.smil"
              },
              {
                  "file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/text0000021.txt"
              },
              {
                  "file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/video0000001.mp4”
              }
          ]
      }’ \
  "POSTBACK_ENDPOINT_URL"

VIDEO + IMAGE + TEXT (AT&T - Moto)
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MO",
          "code":"N401",
          "from":"10000000000",
          "to":"00000",
          "message-subject":"",
          "tracking-id":"MMSMOHQfFewB0",
          "timestamp":"2021-02-03T18:39:46.022285+00:00",
          "content":[
              {
                  "file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/IMG_20210203_133922_01.jpg"
              },
              {
                  "file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/smil.xml"
              },
              {
                  "file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/text000003.txt"
              },
              {
                  "file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/video000000.mp4"
              }
          ]
      }’ \
  "POSTBACK_ENDPOINT_URL"

AUDIO + TEXT (AT&T - Moto)
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MO",
          "code":"N401",
          "from":"10000000000",
          "to":"00000",
          "message-subject":"",
          "tracking-id":"MMSMORSiyTycm",
          "timestamp":"2021-02-03T19:07:05.469904+00:00",
          "content":[
              {
                  "file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/recording000000.mp3"
              },
              {
                  "file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/smil.xml"
              },
              {
                  "file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/text000002.txt"
              }
          ]
      }’ \
  "POSTBACK_ENDPOINT_URL"

AUDIO + VIDEO + TEXT + IMAGE 
curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"MMS_MO",
          "code":"N401",
          "from":"10000000000",
          "to":"00000",
          "message-subject":"",
          "tracking-id":"MMSMO6Cd3B8I9",
          "timestamp":"2021-02-03T19:10:45.301647+00:00",
          "content":[
              {
                   "file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/image000002.jpg"
              },
              {
                  "file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/recording000000.mp3"
              },
              {
                  "file":"https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/smil.xml"
              },
              {
                  "file":https:\/\/fake-d2c-url.com\/mmsmo\/xxxxxxxxxxxx\/text000004.txt"
              },
              {
                 "file":"https:\/\/fake-d2c-url.com\/xxxxxxxxxxxx\/video000001.mp4"
              }
          ]
      }’ \
  "POSTBACK_ENDPOINT_URL"