For many SMS Notify! applications, it is important to know when an MT* message is sent, when a response to that text message is received, or when an MO* message is received by your application. In each scenario, SMS Notify! will alert your application when you use the PostBackURL feature. This can be helpful for storing information in a database, or responding with another message. The PostBackURL is a web page you assign where CDYNE will post back the specific information about the MT or MO SMS messages.
MT (Mobile Terminated) PostBack Fields
If you specify a PostBackURL in your SMS outgoing request, the following fields can be programmed to postback when a message is sent:
- SMSSent - Always set to “1.”
- MessageID – A unique identifier that matches the initial MessageID from your outgoing SMS.
- ReferenceID – This is populated if you set a reference id in your outgoing request.
- FromPhoneNumber – This is the number that sent your outgoing message.
- ToPhoneNumber – This is the number you sent the SMS to.
- SentTime – UTC Date when the message was sent.
MO (Mobile Originated) PostBack Fields
If you specify a PostBackURL in your SMS outgoing request, or CDYNE assigned you an SMS DID – the following fields can be programmed to postback when a response message is returned, or when an MO message is sent to your DID.
- SMSResponse – Always set to “1.”
- MessageID – A unique identifier for this response. This will come as a GUID.
- MatchedMessageID – A GUID that is populated when the response matches a previous message.
- ReferenceID – This is populated if the response matches a previous message and you set the ReferenceID field in your outgoing SMS.
- FromPhoneNumber – This is the number that sent the response.
- ToPhoneNumber – This is the Local SMS Number that received the message. If you have an assigned DID number from CDYNE, this will be that number. Otherwise it will be a random number from our Phone Number pool.
- ResponseReceiveDate – UTC Date when the message came in.
- Message – This is the incoming SMS Text Message body.
Shared Numbers or DIDs – How to Assign the PostBackURL
There are currently two flavors of CDYNE SMS messaging: shared and dedicated phone numbers. With shared numbers, your application can send SMS messages, and receive responses to those messages. Shared numbers cannot receive MO (Mobile Originated) or customer initiated/inbound text message to your application. You’ll need a DID for MO messages.
You can order a DID through a CDYNE Account Representative. When they assign the DID to your SMS license key, they can also assign the PostBackURL at that time. Alternatively, you can log into your account online and specify a URL for each dedicated phone number assigned to your license key as shown in the image below:
By doing so, all messages sent to or from the DID will be captured with the PostBackURL.
When using CDYNE’s bank of shared phone numbers, you can assign the PostBackURL in the SimpleSMSSendWithPostback or AdvancedSMSSend methods. When using a DID, if the PostBackURL is already assigned, you do not have to pass it in the SimpleSMSSendWithPostback or AdvancedSMSSend methods. If you do put in a PostBackURL, it will override the system URL.
* MT (Mobile Terminated) message – an outgoing message sent from your application. It is a text message that terminates on a mobile device.
* MO (Mobile Originated) message – an inbound message sent to your application that is initiated by the customer (rather than a response to an MT message already sent out). It is a text message that originates from a mobile device.