Short Code Best Practices

From CDYNE Wiki
Revision as of 16:08, 1 October 2012 by imported>Nfesette (→‎Step by Step Message Flow)
Jump to navigation Jump to search

Send or receive text messages from your website or application with short codes. A short code is a special 5-6 digit number (e.g., 75195) that allows consumers to subscribe to mobile messaging campaigns. They are managed by a central issuing registrar in each country. Dedicated short codes can send up to 35 MT messages per second.

SimpleSMSSend Method

SimpleSMSSend is recommended for sending single, immediate text messages.

  • Your short code will be assigned to a unique license key. When this license key is passed using SimpleSMSSend, it will automatically send text messages from the assigned short code.
  • You can also assign a DID to the same license key to enable backup text messaging if the short code sends to an unsupported carrier. When this happens SMS Notify! will send the text message from the DID.

AdvancedSMSSend Method

AdvancedSMSSend is recommended for sending scheduled text messages and allows multiple numbers with one message, or multiple numbers with individual messages.

Step by Step Message Flow

1. Your server or application makes a CDYNE SMS Notify! API Request

2. CDYNE replies with an API response

3. CDYNE sends message to appropriate aggregator

4. Aggregator delivers message to appropriate carrier

5. Carrier acknowledges receipt of message

6. Carrier delivers message to cell phone

7. Carrier sends delivery receipt back

  • If available/supported, carrier relays delivery receipt back to aggregator
  • Aggregator sends CDYNE Delivery Receipt updating status of message
  • CDYNE sends HTTP POST to your PostBackURL with DR information.
  • Example Delivery Receipt Postback:
    • Delivery Receipts are sent through the network with low priority. You may receive them out of order.
    • Not all carriers support the handset delivery receipts. You may or may not receive a delivery receipt indicating delivery to cell phone. However, you should receive a delivery receipt indicating delivery to the carrier.''

PostBackURL System

Know when your SMS was sent or received with the PostBackURL System. CDYNE SMS Notify! API will automatically post information to a URL you specify when text messages are sent or received via DIDs and short codes. PostBackURL data is posted behind the scenes, and is not visible on your webpage. Code samples are provided on how to capture this data to store in a database. CDYNE recommends that the data returned to be stored within your systems for reporting and reference information.

API Throughput

Dedicated short codes send up to 35 messages per second per short code.

Coverage & Area Codes

Short codes are country specific. A U.S. short code will only send messages in the U.S., and a Canadian short code will only send messages in Canada.

SMS and Daylight Savings Time

SMS Notify! recognizes the date and time in UTC (Coordinated Universal Time). When clocks move forward 1 hour in the spring, most time zones will need to remove one hour from their UTC offset. For example, Eastern Standard Time (EST) is UTC -5 hours but Eastern Daylight Time (EDT) is UTC -4 hours.