From CDYNE Wiki
Revision as of 10:09, 28 November 2011 by imported>Nfesette (LabTech Notes)
Jump to navigation Jump to search



May 7, 2010 SMS Notify!
August 4, 2010 Postal Address Verification
October 28, 2010 Death Index release on Windows Azure DataMarket
December 2010 Death Index


Due to recent changes to CDYNE’s free Web Services, we regret to inform you that CDYNE has discontinued our free profanity filter service, and do not currently support it. We apologize for the inconvenience and would like to refer you to for your profanity filter needs.

Additionally, the Profanity service has been redirected. Please make sure you change the API URL to Please note that “ws” is now “wsf.”


Case LabTech Avectra Beeswax M2M Datasmart
Service Phone Notify! and Deprecated SMS Notify! Deprecated PAV Deprecated SMS Notify! SMS Notify!
Pricing Phone Notify! current/regular pricing. Deprecated SMS Notify! at new (cheaper) API pricing. Deprecated PAV at new (cheaper) API pricing. Deprecated SMS Notify! at deprecated API pricing. SMS Notify! current/regular pricing.

LabTech Notes

LabTech software already has Phone and SMS Notify! integrated/programmed into their software. LabTech customers sign up for a CDYNE account in order to receive a license key for use.

  • LabTech SMS Notify! Deprecated keys does not support international text messaging. LabTech will have to upgrade in order to support this feature.
  • LabTech uses the deprecated version of SMS Notify! API. There is no deprecated version of Phone Notify. CDYNE honors the upgraded (cheaper) SMS Notify pricing (which automatically updates when DEV adds a deprecated key to LabTech SMS account signups).
  • To issue TKU - assign the customer the SMS Notify Deprecated Version key (bottom selection in the drop down menu) in the Trial LicenseKey navigation pane. Adding the deprecated key is the same process as issuing any other user a Trial LicenseKey.
  • To issue account key – Post request in Redmine under technical support and assign to DEV. They will add the deprecated key to their account, which will include correct pricing.

Simply change the 17575449510 to your cell phone number to get a test message.


Calling via REST (POST/GET)

WCF Help page: REST Help Page


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.


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.


Preferred Phone Number Format (USA/Canada)

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


  • (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 and

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.


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:

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


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.

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.


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.