Follow CDYNE Blog on WordPress.com
Header Image -

Category Archives

22 Articles

SMS Notify! API System Keywords

SMS Notify! API is a programming interface that provides connectivity to wireless carriers. It allows developers to build business applications to send and receive text messages using DIDs or short codes. DIDs are SMS-enabled 10-digit phone numbers (e.g., 757-544-9510), and short codes are 5- to 6-digit numbers (e.g. 55512). Here is a PDF document outlining the differences between each method. One important feature of SMS Notify! is the system keywords. When a person begins a text message with a system keyword and sends it to your DID or short code, SMS Notify! will automatically send a text message reply. System keywords and responses vary between DIDs and short codes as outlined below.

DID System Keywords

HELP

System Response:“Business Name”-SMS Notifications.Txt STOP to end.Msg&Data Rates may apply.”Business point of contact.”

  • The default business name is the name used to sign up for the SMS Notify! account. This may be updated by contacting CDYNE.
  • The business point of contact is two forms of contact including any combination of phone number, email, or website.
STOP, END, CANCEL, UNSUBSCRIBE, QUIT

System Response: This provider is now blocked. Text back RESUME to unblock your number.

  • SMS Notify! API will block the recipient’s number from receiving messages until the recipient sends RESUME.
  • CDYNE will log the recipient STOP request including the license key, sending DID, and recipient’s phone number.
  • The STOP response occurs at the license key level. SMS Notify! will only block messages from that same license key to the recipient’s phone number.
  • Other license keys may send to the recipient’s phone number.
RESUME

System Response: OK.

  • This will allow SMS Notify! to send messages to a recipient who previously sent a STOP command.
  • License Key with Assigned DIDs: The recipient can reply RESUME to any DID assigned to the license key that logged the original STOP request.
  • License Key without Assigned DIDs: The recipient must reply RESUME to the original DID assigned to the license key that logged the original STOP request.

Short Code System Keywords

HELP, HLP, AIDE, INFO

System Response:“Business Name”: Reply STOP to cancel. Msg&Data Rates may apply. Msg Freq per acct setup. “Business #.”

  • The default business name and number is the name and number used to sign up for the SMS Notify! account. This may be updated by contacting CDYNE.
  • The HELP response for short codes are at the license key level so you can set up multiple custom HELP responses per short code.
STOP, END, CANCEL, UNSUB, QUIT, ARRET

System Response:“Business Name”: You have opted out and will no longer receive messages from this service. “Business #”

  • SMS Notify! API will block the recipient’s number from receiving messages until the recipient sends RESUME.
  • The STOP response occurs at the license key level. SMS Notify! will only block messages from that same license key to the recipient’s phone number.
  • The reply to French keywords is the standard English reply.
RESUME

System Response: Welcome to “ProgramName”. Reply STOP to cancel. Reply HELP for help or call “ProgramContact”. Msg&Data rates may apply.  Msg freq per acct setup. Pwr’d by CDYNE.

  • Shared short code system messages will contain “Pwr’d by CDYNE.” Dedicated short code messages will not.

Contact CDYNE for more information about short codes.

Test SMS Notify! API for free.

1 view

Receiving SMS Messages with Short Code Keywords

A short code keyword is a unique one-word phrase that identifies a business, product or service. Keywords allow multiple  businesses to run unique campaigns on the same short code. Likewise, a business using a dedicated short code can differentiate communications with multiple keywords. For example, your dentist places a sign in the waiting room that says, “Text SMILE to 55512 to get appointment reminders.” In this example, “SMILE” is the keyword, and “55512” is the short code. By texting SMILE to short code 55512, the patient is opting in to receive appointment reminders. Using the same short code, the dental office may run a separate promotional offer. For example, “Text WHITE to 55512 for $25 off teeth whitening.” In this way, patients choose the interaction they wish to receive from their dentist. Communication with short codes and keywords give businesses great flexibility and responsiveness when engaging their customers, patients, or clients with text messaging. Here are guidelines and rules to consider when using keywords:

Select User Friendly Keywords

Keep it short – A short keyword is easy to remember.

Make it memorable – An easy to remember keyword will generate a better response.

Use a single word – SMS Notify! will match the entire message when checking for incoming keywords. If an incoming keyword is followed by any characters, a match will not be made.

SMS Notify! Incoming Keyword Rules

  • Only 1 instance of keyword per short code
  • Keyword cannot be a system keyword (e.g., STOP, HELP, ect.)
  • Keyword must be at least 3 characters long
  • Keyword cannot be a typical SMS response (e.g., sure, yes, thanks, monday)
  • Keywords are not case sensitive; ‘THIS’ is the same as ‘this’ and ‘ThIs’

Using PostBackURL to Capture Incoming Keywords

Developer’s can set up automated responses to incoming keywords using the SMS Notify! API PostBackURL system. When a keyword is assigned to your short code, CDYNE can also assign a URL or webpage you designate. Set your application to look for the variable SMSResponse=1, which is posted when a message is sent to your short code, or when a response to your outgoing message arrives. PostBackURL data is posted behind the scenes, and is not visible on your webpage. Program your application to capture the PostBackURL variables that are passed to your webpage from SMS Notify! API.

Contact CDYNE for more information about short codes.

Test SMS Notify! API for free.

5 views

Bulk SMS With Short Codes

CDYNE is proud to announce SMS Short Code Service availability. SMS Notify! customers have requested bulk text messaging and can now send up to 35 text messages per second. A short code is a 5- or 6-digit number such as 99431 that is assigned to a business to send text messages over supporting carrier networks. SMS Notify! now supports U.S. and Canadian short codes.

Short codes come in two varieties: random or vanity. A random short code is assigned, and a vanity short code is a number or word you can request for example 77493 for “PRIZE.” They are easy to remember numbers businesses can use to communicate with their customers and clients.

Launching a short code requires access to wireless carrier networks and carrier approval. This includes a carrier application which details the message flow between your business and text message recipients. Short code setup and carrier approval typically takes 8-10 weeks. While setting up short code access, businesses can use SMS-enabled phone numbers (DIDs) to test their applications with SMS Notify! API.

Short codes are an excellent mobile communication tool to reach customers with immediate and relevant information.

Contact CDYNE today for more Short Code Service information.

Or sign up for a free trial license key to test CDYNE Phone Notify! API.

Developers find CDYNE SMS Notify! API integration details on the CDYNE developer’s wiki.

2 views

Is a DID Required When Using CDYNE SMS Notify! API?

One question we often get asked is, “Is a DID required to use your SMS Notify! API?” The short answer is yes. Every SMS Notify! account comes with one dedicated DID, which is an SMS-enabled phone number that allows you to send text messages. DIDs are useful for low volume, person-to-person text messaging, but more importantly they provide two key benefits:

  1. Build your application with the SMS Notify! API while implementing a dedicated short code
  2. Use DIDs as a backup system to short codes when a carrier is not supported

SMS Notify! uses DIDs and short codes to send and receive text messages from and to your application. Dedicated short codes take time for carrier approval and launch, but companies can still build and test their application with SMS Notify! by using DIDs.

DID Text Messaging Best Practices

  1. DIDs are meant for low volume, person-to-person text messaging. The SMS Notify! API throttles outgoing text messages at a rate of 1 message every two seconds per DID.
  2. CDYNE recommends not sending more than 500 outgoing text messages per DID per day. Sending more than this may put you at risk of the carriers flagging your DID traffic. If your volume per DID is higher than 500 per day, please contact CDYNE to add more DIDs to your account to balance the message load.
  3. Marketing messages are not allowed on DIDs. CDYNE offers short code text messaging for marketing messages. Please contact CDYNE for more short code details.

DIDs for Short Code Backup

CDYNE offers DIDs for low-volume, non-marketing messaging  which makes a nice backup to short codes in the case a carrier is not supported on the short code. This is an optional feature that can be set up during the short code sign up process.

Call 1-800-984-3710 for more information or test today for free.

0 views