SMS API: SMS Gateway Developer API

With the TXTImpact 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
SMS API or Text Messaging API can enable application to receive and send SMS text messages utilising TXTImpact SMS gateway. TXTImpact provides simple HTTP interface for clients to send and receive text 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 API
  • Send SMS Text Messages Directly From Your Applications or Website Bulk Text Messaging: TXTImpact API supports multiple outbound SMS text messaging with a single API request.
  • Two-way SMS: Receive SMS Text Messages Directly on Your Server using web hooks. Whether you have a Short Code, Shared or long code (virtual local 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.
  • 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 Handset Delivery Reports
  • Automatic Unicode characters handling
  • Bi-direction Long SMS Message support: Text Messages longer than 160 characters are automatically split and concatenated seamlessly on the user’s handset
  • No SMS/SMPP Gateway required to be installed on client site.
  • Support HTTP and SMPP API
Send SMS Text Messages via SMS API | Receive Messages via SMS API
Sending SMS Text Messages using HTTP SMS API

HTTP URL

http://smsapi.wire2air.com/smsapi/submitsm.aspx

HTTP METHOD

POST or GET

HTTP Parameters

Required Parameters

*VERSION: 2.0
*USERID: YOUR_USERID; PROVIDED BY TXTIMPACT
*PASSWORD: YOUR_PASSWORD; PROVIDED BY TXTIMPACT
*VASID: YOUR_VASID; PROVIDED BY TXTIMPACT
*FROM: SHORT CODE NUMBER; PROVIDED BY TXTIMPACT
*TO: DESTINATION MOBILE NUMBER. [(country code) + mobile number] e.g 17220001111
*TEXT: The Text Message (160 characters)

Optional Parameters

DELIVERYDATETIME

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. Default: Now, send immediately

REPLYPATH Your server application web address to receive replies from the users e.g http://[your_server]/smsreceiver?

RESPONSE FROM SERVER

After you submit the message request to TXTImpact 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
….

Example

http://smsapi.wire2air.com/smsadmin/submitsm.aspx?version=2.0&userid=USERID&password=PASSWORD&vasid=VASID&FROM=SHORTCODE&to=MOBILENUMER&text=YOUR_MESSAGE

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

SMS API usage example from PHP, ASP, & C#:
PHP:
 <?php
  $ch = curl_init(http://smsapi.Wire2Air.com/smsadmin/submitsm.aspx');
  curl_setopt($ch, CURLOPT_POST, 1);
  curl_setopt($ch, CURLOPT_POSTFIELDS,"VERSION=2.0&userid=[username]&password=[userpassword]&VASId=[VASId]&PROFILEID=[PROFILEID]&FROM=27126&TO=[Mobile Number]&Text=[Text Message]);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER,1);
  $data = curl_exec($ch);
  Print($data); /* result of SMS API call*/
  ?>
C#:
  string ret=string.Empty;
  WebRequest w=WebRequest.Create("http://smsapi.Wire2Air.com/smsadmin/submitsm.aspx");
  w.Method="POST";
  w.ContentType="application/x-www-form-urlencoded";
  using(Stream writeStream = w.GetRequestStream())
     {
      UTF8Encoding encoding = new UTF8Encoding();
      byte[] bytes = encoding.GetBytes("VERSION=2.0&userid=[username]&password=[userpassword]&VASId=[VASId] & PROFILEID =[ PROFILEID ]& FROM =27126&TO=[Mobile Number]&Text=[Text Message]);
      writeStream.Write(bytes, 0, bytes.Length);
     }
  using (HttpWebResponse r = (HttpWebResponse) w.GetResponse())
      {
     using (Stream responseStream = r.GetResponseStream())
        {
         using (StreamReader readStream = new StreamReader (responseStream, Encoding.UTF8))
            {
            ret = readStream.ReadToEnd();18.            }
        }
       }
 MessageBox.Show(ret); /* result of API call*/
ASP:
sstrData = "To=" & [Mobile Number]
sstrData = sstrData + "&From=27126"
sstrData = sstrData + "&UserId=XXXXX"
SstrData = sstrData + "&Password=XXXXX"
SstrData = sstrData + "&vasid=XXXX"
SstrData = sstrData + "&networkid=44"
SstrData = sstrData + "&profileid=2"
SstrData = sstrData + "&Text=Demo Message"
Set myhttp=CreateObject ("Msxml2.XMLHTTP")
Myhttp.open ("POST", "http://smsapi.Wire2Air.com/smsadmin/submitsm.aspx", false)
Myhttp.setRequestHeader "Content-Type", "application/x-www-form-urlencoded"
Myhttp.send sstrData
Response.write myhttp.responsetext
Set myhttp = Nothing
Receive SMS or Text Messages from users
How it works?

Step 1: User sends a text message to an assigned short code or virtual phone number. Step 2: Message received by TXTImpact server from wireless carrier. Step 3: TXTImpact parses the message, and redirect to clients’ server based on short code, and prefix assigned.

Requirements:

Client should set-up a web service to receive messages from TXTImpact servers. TXTImpact will send a message to client server in the following format. When configured you can pickup values from our GET request in following way using PHP: PHP:

<?php
$sender = $_REQUEST['MobileNumber'];
$content = $_REQUEST ['Message'];
$inNumber = $_REQUEST ['shortcode']; 
$Rcvd = $_REQUEST ['Rcvd'];
?>

HTTP URL’s http://[client web service url]?MobileNumber=xxxxxxxx&Message=xxxxxxx&SMSINBOXID=388&shortcode=xxxx HTTP METHOD GET Parameters MobileNumber: User’s mobile number Message: Text Message sent by user Rcvd: Message received date & time SMSInboxid: Reference number for all incoming messages

Watch Tutorial Video on how to configure receive web handler and keywords to receive Text messages

sign-up
TXTImpact SMS Marketing and Mass text messaging

TXTImpact