SMS Notify!

Revision as of 14:52, 26 October 2012

Send text messages from your website or application through CDYNE's two-way SMS Gateway. SMS Notify! uses DIDs or short codes assigned to your account license key to send MT text messages and receive MO text messages. Use a Web Services client in any programming language to interact with SMS Notify! API.

• Your server or application makes a CDYNE SMS Notify! API Request
• CDYNE replies with an API response
• CDYNE sends message to appropriate aggregator
• Aggregator delivers message to appropriate carrier
• Carrier acknowledges receipt of message (short codes only)
• Carrier delivers message to cell phone

SMS Notify! Methods

SimpleSMSSend

Send single, immediate text messages from your website or application.

SimpleSMSSendWithPostback

Send single, immediate text messages from your website or application utilizing the PostBackURL feature.

AdvancedSMSSend

Immediately send or schedule a single text message to multiple phone numbers, or individual messages to multiple recipients. The AdvancedSMSSend method includes a PostBackURL parameter.

GetMessageStatus

The GetMessageStatus method uses the MessageID parameter to return the status of a message.

GetMessageStatusByReferenceID

This method returns all messages with a predefined user ReferenceID set in AdvancedSMSSend method.

GetUnreadIncomingMessages

This method returns all unread text message responses attached to a single License Key and marks them as read.

CancelMessage

CancelMessage uses the Message ID to cancel a message scheduled for a later time or date. Does not work if message was already sent out or queued.

SMS Notify! Documentation Links

SMS Notify! Specification Sheet

PDF document containing all SMS Notify! programming methods with request and response descriptions.

WSDL

An XML format document that defines SMS Notify! endpoints.

HTTP Service Operations

Service operations at endpoint http://sms2.cdyne.com/sms.svc

HTTPS Service Operations

Service operations at https://sms2.cdyne.com/sms.svc/SecureREST

Suppported Carriers

PDF doc containing carriers supported worldwide. Includes region, country, network name, network type, and reach.

API Features

PostBackURL

Know when your MT message has been sent or your application has received a MO or response message. CDYNE SMS Notify! API will automatically post information to a URL you specify each time an SMS has been sent or received.

DID System Keywords

SMS Notify! API will automatically respond to select keywords when sending text messages with DIDs.

Short Code System Keywords

SMS Notify! API will automatically respond to select keywords when sending text messages with short codes.

Short Code Incoming Keyword Management

Managing keywords assigned to short codes.

SMS and Special Characters

Unicode is not currently supported, but the following characters can be received on phones that support Unicode.

SMS Error Returns

SMS Notify! API contains a parameter called SMSError, which returns a string indicating errors when sending the text message.

SMS and Invalid Phone Numbers

How SMS Notify! handles invalid phone numbers.

IP Ranges

4.59.146.64-128 and 4.26.64.64-128

SMS Notify! Best Practices

DID Best Practices
Best practices for using SimpleSMSSend and AdvancedSMSSend with DIDs. Includes PostBack data, volume considerations and carrier coverage.

Short Code Best Practices
Best practices for using SimpleSMSSend and AdvancedSMSSend with short codes. Includes PostBack data, volume considerations and carrier coverage.