DID Best Practices

From CDYNE Wiki
Revision as of 15:19, 25 September 2012 by imported>Nfesette
Jump to navigation Jump to search

Send or receive text messages from your website or application with SMS-enabled phone numbers (DIDs): 10-digit phone numbers used for two-way text messaging. Each account license key is assigned one or more DIDs for sending and receiving text messages. CDYNE recommends sending no more than 500 MT messages per DID per day. Add DIDs for higher daily throughput needs, or use short codes for high volume needs.

SimpleSMSSend Method

SimpleSMSSend is recommended for sending single, immediate text messages. The API will default to sending from DIDs assigned to the license key that is passed.

  • When a license key is passed to SMS Notify! API, it will automatically send messages from the DIDs assigned to that license key. For license keys with more than one DID, SMS Notify! API will automatically balance the outgoing messages between assigned DIDs.
  • Additional SMS Notify! API license keys may be generated at no additional cost and assigned to each DID on your account. This allows you to pass a designated license key to control which DID sends the text message.

AdvancedSMSSend Method

AdvancedSMSSend is recommended for sending scheduled text messages and allows multiple numbers with one message, or multiple numbers with individual messages. If a DID is not declared in the “AssignedDID” parameter, SMS Notify! will automatically send from the DIDs assigned to the license key that is passed.

PostBackURL System

Know when your SMS was sent or received. 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

Automated bulk sending or marketing text messages are not allowed with DIDs. Other volume limitations include:

  • Send MT SMS at a rate of 1 message every 2 seconds per DID (This throttle is imposed at server level, anything faster will get auto-queued)
  • Maximum daily volume per DID should be 500 MT messages per day (not limited by CDYNE servers, you will to program this limitation)
  • No restrictions on MO messages

Short codes should be used for projects that require high volume messaging.

Coverage & Area Codes

SMS Notify! will send messages to the U.S. and Canada only, or worldwide. The turnaround time to obtain account DIDs vary by coverage and whether or not you request an area code specific DID.

SMS to U.S. and Canada: all U.S. and Canadian carriers are supported.

  • Random U.S. DIDs are available immediately
  • Area code requests take 5 – 7 business days

SMS Worldwide: supports carriers worldwide (including all U.S. and Canadian carriers).

  • Random DIDs are available in 1 – 2 business days
  • U.S. area code requests take 5 – 7 business days
  • Canada area code requests take 14 – 18 business days.* Only 2-way traffic allowed on Canadian DIDs

Phone Number Format

USA and Canada

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


  • (1 + 757 + 544 + 9510) = 17575449510


  • 0 + 11 + Country Code + Phone number

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.