Postback Functionality V2

When the MMS is sent we will generate a Postback notification. When we receive an MMS delivery receipt we will generate another Postback notification. Not all carriers provide MMS delivery receipts.

MMS Success/Failure Status Codes

Postback CodePostback Status
N101Sent
N102Delivered
N103Expired
E101Failed
E102Rejected
N013Transcoding Successful
E011Content validation failures
E012Transcoding failed for audio
E013Transcoding failed for video

MMS Postback Nodes

Postback ParameterPostback Parameter Description
originMMS_MT=Postback generated for MMS MT transaction; SMS_MT=Postback generated for SMS MT transaction;
codePostback Notification code to identify the postback.
sent-asValue is “SMS” if the MMS is sent/delivered as Fallback SMS. Value is “MMS” if the MMS is sent/delivered as MMS
statusStatus of the MMS MT/SMS MT transaction. Example: Sent, Delivered, Failed, Rejected, Expired.
status-detailsStatus Details of the MMS MT/SMS MT transaction. Example: Message Sent, Message Delivered, Message Failed, Message Rejected, Message Expired.
toPhone number (with country code) where the message was sent.
fromShort code used to send the message.
timestampTimestamp for the MMS MT Transaction
operator-idCarrier ID for the Phone Number.
operator-nameCarrier Name for the Phone Number.
tracking-idTracking ID generated in the API Response passed back in the postback to link API Request to Postback.
campaign-refMessaging Campaign Reference ID from the API Request
from-maskSender Mask for the Shortcode used to send the message. Sent in the postback only if it exists.
mms-idThe mms template id value of the template that will be created.

POSTBACK: N101 Example (MMS MT Sent)

MMS
{
    "origin":"MMS_MT",
    "code":"N101",
    "sent-as":"MMS",
    "status":"Sent",
    "status-details":"Message Sent",
    "mms-id":"MMS ID",
    "from":"SHORT CODE",
    "to":"PHONE NUMBER",
    "tracking-id":"TRACKING ID",
    "operator-id":"CARRIER ID",
    "operator-name":"CARRIER NAME",
    "timestamp":"SENT TIMESTAMP",
}

Fallback SMS
{
    "origin":"MMS_MT",
    "code":"N101",
    "sent-as":"SMS",
    "status":"Sent",
    "status-details":"Message Sent",
    "mms-id":"MMS ID",
    "from":"SHORT CODE",
    "to":"PHONE NUMBER",
    "tracking-id":"TRACKING ID",
    "operator-id":"CARRIER ID",
    "operator-name":"CARRIER NAME",
    "timestamp":"SENT TIMESTAMP",
}

 

POSTBACK: N102 Example (MMS MT/ Fallback SMS Delivered)

MMS
{
    "origin":"MMS_MT",
    "code":"N102",
    "sent-as":"MMS", 
    "status":"Delivered",
    "status-details":"Message Delivered",
    "mms-id":"MMS ID",
    "from":"SHORTCODE",
    "to":"PHONE NUMBER",
    "tracking-id":"TRACKING ID",
    "operator-id":"CARRIER ID",
    "operator-name":"CARRIER NAME",
    "timestamp":"DELIVERED TIMESTAMP",
    "handset":"HANDSET ID"
}

Fallback SMS
{
    "origin":"MMS_MT",
    "code":"N102",
    "sent-as":"SMS", 
    "status":"Delivered",
    "status-details":"Message Delivered",
    "mms-id":"MMS ID",
    "from":"SHORTCODE",
    "to":"PHONE NUMBER",
    "tracking-id":"TRACKING ID",
    "operator-id":"CARRIER ID",
    "operator-name":"CARRIER NAME",
    "timestamp":"DELIVERED TIMESTAMP",
    "handset":"HANDSET ID"
}

POSTBACK: N103 Example (MMS MT Expired)

{
    "origin":"MMS_MT",
    "code":"N103",
    "sent-as":"MMS",
    "status":"Expired",
    "status-details":"Message Expired",
    "mms-id":"MMS ID",
    "from":"SHORTCODE",
    "to":"PHONE NUMBER",
    "tracking-id":"TRACKING ID",
    "operator-id":"CARRIER ID",
    "operator-name":"CARRIER NAME",
    "timestamp":"EXPIRED TIMESTAMP"
}

POSTBACK: E101 Example (MMS MT Sending Failed)

MMS is too BIG (Fallback SMS is disabled)
{
    "origin":"MMS_MT",
    "code":"E101",
    "sent-as":"MMS",
    "status":"Failed",
    "status-details":"MMS is too big",
    "mms-id":"MMS ID",
    "from":"SHORTCODE",
    "to":"PHONE NUMBER",
    "tracking-id":"TRACKING ID",
    "operator-id":"CARRIER ID",
    "operator-name":"CARRIER NAME",
    "timestamp":"FAILURE TIMESTAMP",
}

No way to send SMS OR MMS
{
    "origin":"MMS_MT",
    "code":"E101",
    "sent-as":"MMS",
    "status":"Failed",
    "status-details":"No way to send MMS or SMS",
    "mms-id":"MMS ID",
    "from":"SHORTCODE",
    "to":"PHONE NUMBER",
    "tracking-id":"TRACKING ID",
    "operator-id":"CARRIER ID",
    "operator-name":"CARRIER NAME",
    "timestamp":"FAILURE TIMESTAMP",
}

Internal Routing Error
{
    "origin":"MMS_MT",
    "code":"E101",
    "sent-as":"MMS",
    "status":"Failed",
    "status-details":"Internal Routing Error",
    "mms-id":"MMS ID",
    "from":"SHORTCODE",
    "to":"PHONE NUMBER",
    "tracking-id":"TRACKING ID",
    "operator-id":"CARRIER ID",
    "operator-name":"CARRIER NAME",
    "timestamp":"FAILURE TIMESTAMP",
}

Content Validation Failed
{
    "origin":"MMS_MT",
    "code":"E101",
    "sent-as":"MMS",
    "status":"Failed",
    "status-details":"Content Validation Failed",
    "mms-id":"MMS ID",
    "from":"SHORTCODE",
    "to":"PHONE NUMBER",
    "tracking-id":"TRACKING ID",
    "operator-id":"CARRIER ID",
    "operator-name":"CARRIER NAME",
    "timestamp":"FAILURE TIMESTAMP",
}

{
    "origin":"MMS_MT",
    "code":"E101",
    "sent-as":"MMS",
    "status":"Failed",
    "status-details":"Audio or Video Transcoding Failed",
    "mms-id":"MMS ID",
    "from":"SHORTCODE",
    "to":"PHONE NUMBER",
    "tracking-id":"TRACKING ID",
    "operator-id":"CARRIER ID",
    "operator-name":"CARRIER NAME",
    "timestamp":"FAILURE TIMESTAMP",
}

 

POSTBACK:E102 (MMS MT Rejections)

Rejected:
{
    "origin":"MMS_MT",
    "code":"E102",
    "sent-as":"MMS",
    "status":"Rejected",
    "status-details":"Message Rejected", 
    "mms-id":"MMS ID",
    "from":"SHORTCODE",
    "to":"PHONE NUMBER",
    "tracking-id":"TRACKING ID",
    "operator-id":"CARRIER ID",
    "operator-name":"CARRIER NAME",
    "timestamp":"FAILURE TIMESTAMP",
}

Unreachable:
{
    "origin":"MMS_MT",
    "code":"E102",
    "sent-as":"MMS",
    "status":"Rejected",
    "status-details":"Network Unreachable", 
    "mms-id":"MMS ID",
    "from":"SHORTCODE",
    "to":"PHONE NUMBER",
    "tracking-id":"TRACKING ID",
    "operator-id":"CARRIER ID",
    "operator-name":"CARRIER NAME",
    "timestamp":"FAILURE TIMESTAMP",
}

Not Supported:
{
    "origin":"MMS_MT",
    "code":"E102",
    "sent-as":"MMS",
    "status":"Rejected",
    "status-details":"Message Not Supported", 
    "mms-id":"MMS ID",
    "from":"SHORTCODE",
    "to":"PHONE NUMBER",
    "tracking-id":"TRACKING ID",
    "operator-id":"CARRIER ID",
    "operator-name":"CARRIER NAME",
    "timestamp":"FAILURE TIMESTAMP",
}

 

POSTBACK: N013 Example

{
    "mms-id":"MMS ID OF NEW MMS TEMPLATE CREATED",
    "tracking-id":"TRACKING ID OF REQUEST",
    "timestamp":"TIMESTAMP TRANSCODED"
}

POSTBACK: E011 Example

{
    "tracking-id":"TRACKING ID OF REQUEST",
    "content-type":"CONTENT TYPE", 
    "content-name":"CONTENT FILE URL PROVIDED IN THE REQUEST",
    "error-info":"Transcoding failed for audio"
}

POSTBACK: E012 Example

{
    "tracking-id":"TRACKING ID OF REQUEST",
    "audio-name":"AUDIO FILE URL PROVIDED IN THE REQUEST",
    "error-info":"Transcoding failed for audio"
}

 

POSTBACK: E013 Example

{
    "tracking-id":"TRACKING ID OF REQUEST",
    "audio-name":"VIDEO FILE URL PROVIDED IN THE REQUEST",
    "error-info":"Transcoding failed for video"
}

 

POSTBACK: N201 Example (SMS MT Sent)

{
  "origin":"SMS_MT",
  "code":"N201",
  "sent-as":"SMS",
  "status":"Sent",
  "from":"SHORTCODE",
  "to":"PHONE NUMBER",
  "tracking-id":"TRACKING ID",
  "operator-id":"CARRIER ID",
  "operator-name":"CARRIER NAME",
  "timestamp":"SENT TIMESTAMP"
}

POSTBACK: N202 Example (SMS MT Delivered)

{
  "origin":"SMS_MT",
  "code":"N202",
  "sent-as":"SMS",
  "status":"Delivered",
  "from":"SHORTCODE",
  "to":"PHONE NUMBER",
  "tracking-id":"TRACKING ID",
  "operator-id":"CARRIER ID",
  "operator-name":"CARRIER NAME",
  "timestamp":"SENT TIMESTAMP"
}

POSTBACK: E201 Example (SMS MT Failed)

{
  "origin":"SMS_MT",
  "code":"E201",
  "sent-as":"SMS",
  "status":"Failed",
  "from":"SHORTCODE",
  "to":"PHONE NUMBER",
  "tracking-id":"TRACKING ID",
  "operator-id":"CARRIER ID",
  "operator-name":"CARRIER NAME",
  "timestamp":"SENT TIMESTAMP"
}

 

POSTBACK: E202 Example (SMS MT Rejected)

{
  "origin":"SMS_MT",
  "code":"E202",
  "sent-as":"SMS",
  "status":"Rejected",
  "from":"SHORTCODE",
  "to":"PHONE NUMBER",
  "tracking-id":"TRACKING ID",
  "operator-id":"CARRIER ID",
  "operator-name":"CARRIER NAME",
  "timestamp":"SENT TIMESTAMP"
}
Go to Top