SMS Gateway API
SMS API can enable application to receive and send SMS messages utilising txtimpact advanced SMS gateway API. TxtImpact 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 Message Gateway and HTTP Post API
- Send SMS Messages Directly From Your Applications or Website
Send texts to an individual or multiple recipients directly from your server.
- Receive SMS 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
Sending SMS Messages Via API:
HTTP URLs: http://SMSAPI.TxtImpact.com/smsadmin/submitsm.aspx
HTTP METHOD: POST or GET
HTTP Form Variables
|
Name |
Description |
|
*VERSION |
2.0 |
|
*USERID |
YOUR_USERID; PROVIDED BY TXTIMPACT |
|
*PASSWORD |
YOUR_PASSWORD; PROVIDED BY TXTIMPACT |
|
*VASID |
YOUR_VASID; PROVIDED BY TXTIMPACT |
|
*PROFILEID |
YOUR_PROFILEID; 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) |
|
NETWORKID |
Optional
Network ID of destination network,
TxtImpact use internal networkid to identify the carriers, Supported Networks
These are the same networkid passed from our HTTP API when receiving incoming SMS. |
|
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** |
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? |
Response from Send SMS APIs
The API will return a string message to the calling application.
Successful submission:
JOBID: [MOBILENUMBER]:[SMSID]
Failed submission:
ERR: 301: Failed authentication
ERR: 305: Not enough credits
API usage example from PHP, ASP, & C#:
Receive SMS/Text Messages from TxtImpact Gateway API:
How it works?
STEP1: User sends a text message to an assigned shortcode.
STEP2: Message received by TxtImpact server from carrier.
STEP3: TxtImpact parses the message, and redirect to clients’ server based on short code, and prefix assigned.
Requirements
Client should set a web service to receive messages from TxtImpact servers. TxtImpact will send a message to client server
in the following format.
HTTP URLS
http://[client web service url]?
MobileNumber=xxxxxxxx&Operatorid=110&Message=xxxxxxx&SMSINBOXID=388&shortcode=xxxx
Operatorid: To be used as NETWORKID in Send API
HTTP METHOD
GET
Parameters
MobileNumber: User’s mobile number
Operatorid: Networkid of destination network, TxtImpact use internal networkid to identify the networks, LIST ANNEX
1A
Message: Text Message sent by user
Rcvd: Message received date & time
SMSInboxid: Reference number for all incoming messages
Network Identifications for North America (Operatorid)
|
Network Name |
ID |
|
Boost |
600 |
|
Verizon |
11 |
|
AT&T |
44 |
|
SPRINT |
455 |
|
ALLTEL |
18 |
|
T-MOBILE |
470 |
|
Cellular One |
168 |
|
Nextel |
353 |
|
Virgin |
601 |
|
US Cellular |
602 |
| |
|
|