SMS MT Postback V2

Synopsis

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

SMS MT Success/Failure Status Codes

Postback Code	Postback Status
N201	Sent
N202	Delivered
E201	Failed
E202	Rejected

SMS MT Postback Nodes

Postback Parameter	Postback Parameter Description
origin	SMS_MT
code	Postback Notification code to identify the postback.
sent-as	SMS
status	Status of the SMS MT transaction. Example: Sent, Delivered, Failed, Rejected.
to	Destination phone number with country code.
from	The shortcode or longcode sender.
timestamp	The timestamp of the SMS MT transaction.
operator-id	Carrier ID for the Phone Number.
operator-name	Carrier Name for the Phone Number.
tracking-id	Tracking ID generated in the API Response passed back in the postback to link API Request to Postback.
campaign-ref	Messaging Campaign Reference ID from the API Request.
from-mask	Sender Mask for the Shortcode used to send the message. Sent in the postback only if it exists.

POSTBACK: N201/N202/E201/E202 Request

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"SMS_MT",
          "code":"STATUS_CODE",
          "sent-as":"SMS",
          "status":"STATUS",
          "from":"SENDER_NUMBER",
          "to":"RECEIVER_PHONE_NUMBER_WITH_COUNTRY_CODE",
          "tracking-id":"TRACKING_ID",
          "operator-id":"CARRIER_ID",
          "operator-name":"CARRIER_NAME",
          "timestamp":"SENT_TIMESTAMP"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: N201 Example (SMS MT Sent)

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"SMS_MT",
          "code":"N201",
          "sent-as":"SMS",
          "status":"Sent",
          "from":"000000",
          "to":"10000000000",
          "tracking-id":"xxxxxxxxxxxx",
          "operator-id":"0001470",
          "operator-name":"AT&T",
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: N202 Example (SMS MT Delivered)

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"SMS_MT",
          "code":"N202",
          "sent-as":"SMS",
          "status":"Delivered",
          "from":"000000",
          "to":"10000000000",
          "tracking-id":"xxxxxxxxxxxx",
          "operator-id":"0001470",
          "operator-name":"AT&T",
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: E201 Example (SMS MT Failed)

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"SMS_MT",
          "code":"E201",
          "sent-as":"SMS",
          "status":"Failed",
          "from":"00000",
          "to":"10000000000",
          "tracking-id":"xxxxxxxxxxxx",
          "operator-id":"0001470",
          "operator-name":"AT&T",
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"

POSTBACK: E202 Example (SMS MT Rejected)

curl -X POST \ 
     -H "content-type: application/json" -d '
      {
          "origin":"SMS_MT",
          "code":"E202",
          "sent-as":"SMS",
          "status":"Rejected",
          "from":"000000",
          "to":"10000000000",
          "tracking-id":"xxxxxxxxxxxx",
          "operator-id":"0001470",
          "operator-name":"AT&T",
          "timestamp":"2021-01-26T18:00:07.990498+00:00"
      }’ \
  "POSTBACK_ENDPOINT_URL"