SMS
General Parameters
Parameter | Description | Example | ||||||||||||||
Token and Signature | Used to authenticate your request. They are proxies for your username and password | Use GetParameters to generate token and signature from your username and password. | ||||||||||||||
Recipient | Telephone number in International format. Use Country Code + area code + local number. All numbers in USA MUST START with 1 |
| ||||||||||||||
Message | Text of your message. If sending UNICODE, specify Sixteen in the encoding field. Otherwise use Seven | ASCII: Hi Joe, how are you? UNICODE: Запуск шаттла Endeavour прошел успешно | ||||||||||||||
encoding | Identifies the character set you are sending | Seven, Sixteen or Eight |
The following operations are supported. For a formal definition, please review the Service Description.
-
AddContact
Use this function to add contacts to your Contact List. Mandatory fields are token, signature and mobile. Mobile is the contact's mobile phone. Type is the type of mobile phone, such as iPhone, Blackberry. -
HLR_Lookup
Use this function to verify if the phone is on and report back to you status of the phone. The user will not see this message. This will deduct 0.5 credits from your account balance. -
Number_Lookup
Use this function to validate a number by trying to do routing. If routing is OK, return information of country and network. This will deduct 0.25 credits from your account balance. -
Number_Validator_Quick
Use this function to return if the number is OK based on very basic number validation. This will deduct 0.1 credits from your account balance. -
Send_Flash
Used to send a Flash SMS. Flash SMS is a type of message that is displayed on the receiving phone without requiring user interaction (i.e. message is not stored in Inbox). Some phones may not support this message format. -
Send_MMS
Used to send a multimedia message (MMS) in Canada. Multiple media URLs should be separated by comma. Please make sure you have a MMS-enabled number and the recipient can handle MMS. The total size of media files should be less than 500K. -
Send_Plain
Used to send a text message (SMS). -
Send_Plain_Dedicated
Used to send an SMS through a dedicated number or a Short Code. You must have a short code associated with your account to use this function.- Tariff
- Carrier Codes
- Dedicated Number - this is the number or short code associated with your account. Contact us if you need one.
-
Send_Plain_Deferred
Used to send an SMS at a later date. Hours can take values between 0 and 11. Minutes can take value between 0 and 59. -
Send_Plain_Group
Used to send a text message (SMS) to a group of your personal contacts. For detailed explanation of return codes, please click here. -
Send_Plain_Multiple
Used to send a text message (SMS) to multiple recipients (comma separated, maximum is 25). For detailed explanation of return codes, please click here. -
Send_Plain_ServiceGroup
Used to send a text message (SMS) to a group of your service subscribers. For detailed explanation of return codes, please click here. -
Send_Port
Used to send a Hex encoded SMS to a specific port of the recipient. -
Send_Port_Dedicated
Used to send a Hex encoded SMS through a dedicated number to a specific port of the recipient.- Tariff
- Carrier Codes
- Dedicated Number - this is the number or short code associated with your account. Contact us if you need one.
-
Send_Test
Used to test the sending an SMS. Performs validation only. -
Send_WAPPush
Used to send a WAP Push SMS. Title is text that will be delivered in addition to the URL. URL is the location of the media file you want to make available to the recipient of the message.