Skip to content
Last updated

An API that notifies when a customer has replied to an MMS message through the XML or JSON API.

The MMS MO postback API notifies you that a customer has replied to your message, or interacted with one of your keywords.

MMS MO Information

To receive MMS MO postback you need to work with your Sinch Account Manager to provision with your account. Once the MMS MO postback is enabled you will start receiving postbacks for each MMS MO received on the MMS MO Keyword or Short Code.

The MMS MO

This postback notifies you when an MMS MO is received.

VariableDescription
codeN401
originMMS_MO
fromThe phone number, including the country code of the sender
toThe recipient shortcode, 10DLC, or Toll-Free number
keywordIf a keyword was recognized in the first word of the subject or the,first word body of the message and it matched to a MMS Inbox Keyword,campaign that keyword will be passed in this node
tracking-idA tracking ID, Sinch has assigned this message
operator-idThe operator-id of the sender’s carrier
timestampThe timestamp that our system received the MMS MO
message-subjectThe subject sent in the MMS MO
contentContains the file nodes sent in the MMS MO
fileA 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

MMS MO Example

MMS MO

<postback>
    <origin>MMS_MO</origin>
    <code>N401</code>
    <from>14082257140</from>
    <to>28444</to>
    <keyword>all</keyword>
    <tracking-id>MMS_MO_iLnCRrL6</tracking-id>
    <operator-id>31002</operator-id>
    <timestamp>2014-02-03T11:19:49-05:00</timestamp>
    <message-subject></message-subject>
    <content>
        <file>URL of Content Here</file>
        <file>URL of Content Here</file>
        <file>URL of Content Here</file>
    </content>
</postback>
curl -X POST \
     -H "content-type: application/json" -d '
      {
          "origin":"{Origin}",
          "code":"{Status code}",
          "from":"{Sender phone number with country code}",
          "to":"{Receiver number}",
          "message-subject":"{Subject}"
          "tracking-id":"{Tracking id}",
          "timestamp":"{Timestamp}",
          "content":[
              {
                  "file":"{File URL}"
              },
              {
                  "file":"{File URL}"
              },
              ...
          ]
      }’ \
  "{Postback Endpoint URL}"