SMS Notify!

From CDYNE Wiki for Web Services
Revision as of 19:50, 28 February 2012 by Nfesette (Talk | contribs)
Jump to: navigation, search

CDYNE SMS Notify! API is a two-way SMS Web Service that sends and receives text messages world-wide through secure gateways. Click here for SMS Notify! product details.

  • 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

Contents

DEVELOPER RESOURCES

SMS Notify! 2.0 Specification Sheet

SMS Notify! 2.0 API - WCF/SOAP/REST Service

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

Examples

3rd Party Tutorials

  • 3rd party C# .NET Simple Send SMS tutorial can be found here > Video and Source

Calling via REST (POST/GET)

WCF Help page: REST Help Page


LICENSE KEYS AND PRICING

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 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.

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.

GENERAL TECHNICAL INFORMATION

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 CDYNE SMS International coverage PDF by region, country, and network name.

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 five to seven business days to be assigned to your account license key. Canadian DIDs will take 14 - 18 business days. When placing an order for DIDs, it is necessary that you specify if you require international capability.

PostBackURLs

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

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.

Using shared numbers, the PostbackURL must be assigned using either the SimpleSMSSend with Postback operation or the AdvancedSMSSend operation. DID users may assign a PostBackURL to a 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:

Character Description
[ left square bracket
\ back slash
] right square bracket
^ caret
` grave accent
{ left curly brace
| pipe or vertical bar
} right curly brace
~ tilde
DEL Delete

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.

Security

CDYNE does offer 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.

HIPAA Compliance with SMS Notify! API

You will be required to use HTTPS to provide a secure channel for SMS messaging to be HIPAA compliant. Also, all messages cannot include credit card information or personal health record information.

CDYNE SMS Notify! was built in WCF (Windows Communication Foundation). WCF uses Message and Transport Security protocols to ensure the protection of information. The xml (including all fields) is protected by these protocols, and it allows for end-to-end security. http://msdn.microsoft.com/en-us/library/ms733137.aspx

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 & 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.

Personal tools
Toolbox





Trial Key