HOW SMS NOTIFY! API HANDLES INVALID PHONE NUMBERS
What happens when a user tries to send SMS text messages to an invalid phone number? Fortunately, 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.
The correct format to send U.S. and Canadian numbers is a string such as 7575551234. The International phone number format is a string that includes 011 + country code + 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.
So when will SMS Notify! API return a “PhoneNumberInvalid” error?
One example is when a phone number contains a character plus six numbers – such as when the letter “o” takes the place of the number zero. A second example is a series of fives, such as 555-555-5555. The image below shows how SMS Notify! will handle these.
When an error occurs due to an invalid phone number, the notification will not be sent to the intended recipient. However, the account will still be charged for the transaction. The charge takes place because a request was sent to CDYNE and a response was received from CDYNE servers.
What happens if I send a landline phone number to SMS Notify! API?
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 numbers. Ask about discounts when used in conjunction with SMS Notify! or Phone Notify! APIs.
Sign up for a free trial key to test the Web Services for free!