SMS Delivery Receipt Postback

From CDYNE Wiki
Jump to navigation Jump to search

SMS Delivery Receipt POST

If you assign a PostbackURL to your account DIDs, the PostBack will allow you to capture the data in the fields listed below. Please note that data is posted to the headers.

PostBackURL data is posted behind the scenes, and is not visible on your webpage. Code samples are provided below on how to grab this data to store in a database. CDYNE recommends that the data returned to be stored within your systems for reporting and reference information.

Fields

DeliveryReceipt

DeliveryReceipt=1 is posted when a Delivery Receipt is received.

MessageID

A unique identifier that matches the initial MessageID from your Outgoing SMS.

ReferenceID

This is populated if you set a ReferenceID in your outgoing request.

FromPhoneNumber

This is the number that sent your outgoing message.

ToPhoneNumber

This is the number you sent the SMS to.

DeliveryReceiptMessage

This is the Delivery Receipt.

Code

This is the err code parsed from the Delivery Receipt.

BackupMessageID

This is the new MessageID of a backup DID message being sent when a short code message fails. Parameter is only present when a short code message is being sent via a DID as a backup.

Example Packet

POST /cdynepostback.aspx HTTP/1.1
User-Agent: CDYNE SMSv2
Content-Type: application/x-www-form-urlencoded
Host: cdyne.com
Content-Length: 289
Expect: 100-continue
Connection: Keep-Alive

DeliveryReceipt=1&MessageID=f880e00b-3a14-484c-80e7-ca6aa29a2f7a&ReferenceID=&FromPhoneNumber=74121&ToPhoneNumber=17572373369&DeliveryReceiptMessage=sm: msg: id:18579674100201040 sub:001 dlvrd:001 submit date:1209281334 done
date:1209281334 stat:DELIVERED TO CARRIER err:003 text:&Code=003