TEXT MESSAGE DEVELOPER SMS APIS
With the Wire2Air SMS API, you have access to powerful text messaging functionality for integration into your existing and new web and enterprise applications.
Send SMS Text messages using SMS API
Text Messaging API or SMS API can enable an application to receive and send SMS text messages utilizing Wire2Air advanced SMS gateway API or Text Messaging API. Wire2Air provides simple HTTP interface for clients to send and receive messages from mobile phone users. HTTP POST can be used in all modern programming languages including ASP, ASP.NET, C++, C#, PHP, VB, VB.NET, command lines, SSH & cURL.
Benefits of using our SMS Text Messaging Gateway and Text Messaging Post API
- Send SMS Text Messages Directly From Your Applications or Website
Send texts to an individual or multiple recipients directly from your server. - Receive SMS Text Messages Directly To Your Server
Whether you have a Short Code, Shared or Dedicated Inbound Number all inbound texts will be forwarded directly onto your server. - Easy and Immediate Implementation
Implementation of the required code and integrating it with our system can all be done in less than 30 minutes. - No SMS/SMPP Gateway required to be installed on client site.
- Sticky session; Once customer start using your server, stay in touch with them. Messages will be forwarded to your server even if keyword not included in message.
- Supports Delivery Reports (Advance Developer API account)
Send SMS Text Messages Via SMS API
HTTP URL
Example:
https://msgapi.wire2Air.com/smsapi/submitsm.aspx?version=2.0&userid=USERID&password=PASSWORD &vasid=VASID&FROM=SHORTCODE&to=MOBILENUMER&text=YOUR_MESSAGE
HTTP METHOD
POST or GET
HTTP Parameters
| *VERSION | 2.0 |
| *USERID | YOUR_USERID; PROVIDED BY Wire2Air |
| *PASSWORD | YOUR_PASSWORD; PROVIDED BY Wire2Air |
| *VASID | YOUR_VASID; PROVIDED BY Wire2Air |
| *FROM | SHORT CODE NUMBER; PROVIDED BY Wire2Air |
| *TO | DESTINATION MOBILE NUMBER. [(country code) + mobile number] e.g 17220001111 {comma separated mobile number to send a single message to Mass/Bulk Text message} |
| *TEXT | The Text Message (160 characters) |
| DeliveryDateTime (optional) | Optional Default: Now Date and time for message delivery in UTC format.Example: 07/14/1997 00:00:00;UTC date time The following represents Sunday, July 13, 1997 at 8:00:00 PM in New York City. |
| ReplyPath (optional) | Your server application web address to receive replies from users CASE BY case basis ONLY available in advance developer API. e.g http://[your_server]/smsreceiver? |
| BatchName (optional) | Applicable to Mass/Bulk Text Message only |
RESPONSE FROM SERVER
After you submit the message request to Wire2Air server, the server will return a response in following format:
For successful submission:
JOBID: [MOBILENUMBER]:[SMSID]
Failed submission:
ERR: 301: Failed authentication
ERR: 305: Not enough credits
Note
- Values must be properly URL encoded
- Message submitted longer than 160 characters will be rejected. For sending messages longer than 160 characters, contact sales.
- You’ll be charged one credit for every 160 character message.
- The list of allowed characters for messages and subjects is: a-z, A-Z, 0-9 and these special characters: .,:;!?()~=+-_\/@$#&%’”
- For line break in a message, use \r\n; e.g Your class is schedule on \r\n july 24th @ 7:00PM.
- The following characters count as two characters: ~, @, #, %, +, =, /, \, \r\n
Encode your API
What is URL encoding?
URL encoding converts special characters into friendly HTTP GET request that can be sent through the internet. You should use URL encode for all GET parameters.
Why URL encoding?
The data you’re sending to a web service using HTTP Get request must be encoded, any character that is not an alphabetic character, a number, or a special character that is being used outside its normal context is going to need to be encoded in your request.
URLs often contain characters which conflict with HTTP Get request reserved characters such as (&, /, ?) must be escaped.
How do you encode a URL?
To encode a URL, you simply replace the special characters with their encoding string. This will nearly always begin with a % character. All modern programming languages offer libraries to encode URLs, such in C# use HttpUtility.UrlEncode() and PHP: string urlencode (string $str)
Example:
GET
https://msgapi.wire2air.com/smsapi/submitsm.aspx?vasid=yourvasid&userid=YourAuthKey&password=yourpassword&from=27126&to=9999999999&text=A sample text & Message
GET
https://msgapi.wire2air.com/smsapi/submitsm.aspx?vasid=yourvasid&userid=YourAuthKey&password=yourpassword&from=27126&to=9999999999&text=A%20sample%20text%20%26%20Message
Text=A sample text & Message encoded to : A%20sample%20text%20%26%20Message
[SMS-HTTP-Sample]