Smssample

The CDYNE SMS Notify! API is a 2-way International SMS Gateway that sends text messages direct to cellular phone carriers. This SMS API can be easily placed into custom console and web applications with minimal time & money investment.


 * http://sms2.cdyne.com/sms.svc?wsdl
 * SMS Notify! 2.0 Specification Sheet

SMS Notify!
With SMS Notify! you can:


 * Use shared and/or dedicated phone numbers to send and receive SMS messages
 * Send up to 1500 messages per minute with CDYNE shared phone numbers for only 1 cent per transaction
 * Give your application the ability to receive Mobile Originated SMS (incoming SMS) with dedicated phone numbers (DIDs)
 * Integrate telephony features with SMS-enabled phone numbers (when used with Phone Notify services. Please call 1-800-984-3710, inquire or initiate a chat.)
 * Send immediate or schedule SMS messages one at a time, or thousands simultaneously
 * Set up a “StatusPostBackURL” to automatically receive posts to your server when an SMS message has been sent, and when a response is received

Simple Test
Simply change the 17575449510 to your cell phone number to get a test message. http://sms2.cdyne.com/sms.svc/SimpleSMSsend?PhoneNumber=17575449510&Message=TestMessage

Preferred Phone Number Format (USA/Canada)

 * 1 + NPA + NXX + XXXX
 * 1 + (Area Code) + Number

Example
 * (1 + 757 + 544 + 9510) = 17575449510

Preferred Phone Number Format (International)

 * 0 + 11 + Country Code + Phone number

CDYNE SMS Notify! API coverage is worldwide. View the SMS International coverage Excel doc.

IP Ranges
4.59.146.64-128 and 4.26.64.64-128

Dedicated Phone Numbers (DIDs)
Give your application the ability to receive Mobile Originated SMS (incoming SMS) with dedicated phone numbers assigned to your production SMS Notify! license key.


 * SMS-enabled dedicated phone numbers (DIDs) are available for both U.S. and Canadian phone numbers.
 * Throughput for each DID is 1 message per 6 seconds. This cannot be increased due to carrier restrictions.
 * Dedicated SMS-enabled phone numbers (DIDs) are $1 per month per assigned number.

In order to send messages from a DID, the dedicated number must be specified using the AdvancedSMSSend operation. Within that operation is a parameter named AssignedDID where the dedicated number will need to be inputted.

Please call 1-800-984-3710, inquire or initiate a chat to order a dedicated phone number. U.S. DIDs typically take two business days to be assigned to your account license key. Canadian DIDs will take 14 - 18 business days.

PostBackURLs
PostBackURLs allow SMS Notify! API customers to instantly know when a:


 * Text message is sent out
 * When an end user responds to a text message
 * When an end user sends a text message to your DID

This eliminates the need for the customer to constantly query CDYNE servers for responses. PostBackURLs are only sent to the server you specify in the Postback variables - Example: http://www.blanksite.com/incomingsms.aspx.

The PostbackURL must be assigned by CDYNE for customers using shared phone numbers. You can however, forward us the link which you would like to use and we’d be more than happy to assign it to your license key. DID users may assign a PostBackURL to an SMS Notify! license key and/or DID by logging into your account at cdyne.com and doing the following:
 * Select “Manage Services” on the left-hand menu
 * Click open the SMS Notify! module
 * Select “DID,” which will open a new screen listing your
 * Click on the edit button on the right and add the URL.

Please call 1-800-984-3710, inquireor initiate a chatto assign your PostbackURL.

Automated Keyword Management
SMS Notify uses some “Key Words” developers should be aware of. Should an end user respond to one of your messages, and the first word is one of the following, it will cause our system to execute a special command.


 * HELP - When a recipient responds HELP, we will send contact information about the party who initiated the message to the recipient. This allows the recipient to know who is contacting them, and provides them information on how they can contact the sender.
 * STOP, END, CANCEL, UNSUBSCRIBE, or QUIT - This will block the recipient’s number from receiving messages from our system. This is to protect the recipient from unwanted or unsolicited messages.
 * RESUME - This will allow CDYNE to send messages to a recipient who previously sent a STOP, END, CANCEL, UNSUBSCRIBE, or QUIT command.

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


 * NoError
 * STOPfromPhoneNumber
 * LicenseKeyInvalid
 * PhoneNumberInvalid
 * MessageInvalid
 * ScheduledDateTimeIsNotUTC
 * InvalidAssignedDID
 * NotFound (Occurs for Invalid MessageID)
 * InternalError
 * ContactCdyneAccountSuspended

SMS and Special Characters
SMS Notify! supports most special characters, however, there are certain characters which most phones have trouble receiving. Most American and European phones don't support Unicode and thus will not correctly receive messages with certain characters. The following characters can only be received on phones that support Unicode:

Invalid Phone Numbers
CDYNE’s SMS Notify! SMS Gateway API will automatically clean up certain errors for U.S. and Canadian phone numbers. For example, if you were to send a message to “7575449510e,” the API would take out the “e” and send the message to 7575449510. In this example, SMS Notify! API would return a parameter of “NoError” and continue to send the message to the cleaned up phone number.

While the SMS Notify! text message API will clean errors such as extra digits and/or letters, it will not clean numbers if it has been entered incorrectly and is still a valid number. For example if you wanted to send a notification to 7575449510, but instead you had the number as 7575449501 within your script, the message would be sent to 7575449501 as it is a valid number.

CDYNE SMS Notify! API does not do a phone verification check on phone numbers, and it will send all valid numbers out. One work around is to run your phone list through CDYNE Phone Verification API which will return whether a phone number is a landline or cell number. CDYNE Phone Verification API is a cost effective way to distinguish between a landline and cellular or even fake phone number. Ask about discounts when used in conjunction with SMS Notify! or Phone Notify! APIs.

Security
CDYNE does offer [https://sms2.cdyne.com/sms.svc/SecureREST/help SMS Notify! API HTTPS URLs] for added security.

CDYNE currently maintains 3 major server farms, bringing added redundancy to our networks and additional capacity. CDYNE's data centers are engineered with multiple levels of security, uninterruptible power supplies (UPS), redundant HVAC systems, and fire suppression, as well as 24 X 7 monitoring and management. They are protected by 24 hour surveillance with a HID security badge and biometric hand scanners. All server racks have locks on them. CDYNE never mines or sell information that crosses our servers or systems.

100% SLA
Because availability is important for your mission-critical environment, CDYNE's Service Level Agreement (SLA) is designed to protect our clients against unscheduled outages. As the leader in the Web Services industry, CDYNE is the only provider with such an uncompromising SLA, guaranteeing zero downtime of the services you rely on. The SLA provides unsurpassed levels of availability with correspondingly aggressive penalties for failure to comply with the SLA. This 100% uptime assurance is a direct result of CDYNE's relentless pursuit of service excellence.

Opt-in and Opt-out Procedures
CDYNE Corporation is committed to consumer protection and privacy and we do not allow the use of CDYNE SMS Notify API for any type of marketing and/or unsolicited messages. The following is a short guideline for CDYNE SMS Notify API use. It is based on the Mobile Marketing Association’s guidelines for accepted industry practices.


 * At all times, text messages sent from CDYNE SMS Notify API must be in accordance with applicable federal and state laws, rules and regulations.
 * Users of CDYNE SMS Notify API must obtain approval from recipients before sending messages. The following is a list of examples and is not exhaustive. If you have questions about opt-in procedures, please contact CDYNE at 1-800-984-3710, inquire or initiate a chat.
 * Recipient may send a Mobile Originated (MO) message from their handset to the dedicated phone number.
 * Recipient may initiate opt-in from a web interface
 * Recipient may initiate opt-in from a WAP interface
 * Recipient may initiate opt-in from an IVR system
 * Those recipients must be told how to opt-out of the program and/or have the opportunity to cancel text messages at anytime.
 * A recipient can stop participating and receiving messages from any program by sending STOP to the long code used for that program.
 * Users of CDYNE SMS Notify API should record and store all opt-out transactions.
 * All opt-ins and cancellations must be kept on record for at least six months after opt-in/cancellation occurs.
 * Content must be sent to age appropriate customers.
 * Selling mobile opt-in lists is prohibited.

Additionaly, please review the Telephone Consumer Protection Act of 1991 (TCPA), which can be found at the following link(s):

Telemarketing Policy

47 U.S.C. §227

This act outlines prohibition for text calls, including SMS messages sent to wireless phone numbers. While it might be argued that the SMPP protocol is not an automatic telephone dialing system, this is still a legal gray area. The intent of the TCPA was to make sure that consumers expressly consent to automated calls or messages sent to wireless devices given that consumers may be charged to receive such calls or messages. The key again is the notion of “express written consent”, which, in the case of text messaging, means some sort of opt-in proof.

Pricing And Licensing
Pricing

There is a monthly licensing fee of $9.99 for SMS Notify! API. Each outgoing and incoming message is charged as a transaction and will be billed according to monthly volume:


 * Monthly licensing fee of $9.99
 * Outgoing and incoming transactions are only 1 cent each
 * Dedicated SMS-enabled phone numbers (DIDs) are $1 per month per assigned number

Response messaging is charged at the normal transaction rate.

Pricing for all CDYNE Web Services is based off a set monthly maintenance fee and a per-transaction fee. CDYNE does not require a contract and there are absolutely no start-up or cancellation fees. CDYNE services are post-pay. Your credit card will not be charged until one month from sign-up date and will be billed monthly thereafter unless you deactivate or cancel services. Net 30 billing is available upon application approval.  Free Trial License Keys 

CDYNE offers trial license keys for all Web Services so that you may test the APIs for free. Trial keys do not expire, and are limited to approximately 50 transactions. Normal processing time for trial key requests during normal business hours (M-F, 9-6 eastern) typically ranges from ten minutes to two hours.

CDYNE [http://www.cdyne.com/developers/trial-key.aspx?PGID=2E18E28D-40C5-4F86-BDA3-EEAD83BC18A1 SMS Notify! API trial keys] do require a short verification process due to FCC regulations regarding SMS text messaging. At all times, text messages sent from CDYNE SMS Notify! API must be in accordance with applicable federal and state laws, rules and regulations.

Please include the following items in the trial request form for expedited processing:


 * What the services will be used for?
 * Who are the SMS recipients (customers, employees, etc)?
 * What is the content of the message (marketing, notification, etc)?
 * What is the opt-in and opt-out procedure for SMS recipients? (Please provide a url so that the verification department may review the opt-in/opt-out procedures online.)

 Production (Account) License Keys 

Sign up here for a production SMS Notify! license key.

Upon registration, your account will be suspended for verification. This is due to FCC regulations regarding SMS text messaging. At all times, text messages sent from CDYNE SMS Notify! API must be in accordance with applicable federal and state laws, rules and regulations.

You may call 1-800-984-3710 to expedite the verification process over the phone.

Code Samples

 * C#
 * VB
 * PHP
 * VB Script
 * Ruby
 * Ruby On Rails
 * Curl