x
Get In Touch
Want to speak with a human being?
We can chat when it’s convient for you. Our team is available by phone, Monday through Friday from 9am to 5pm CST.
SCHEDULE A CALL WITH SALES

(800) 322-1112
support@textbetterinc.com

(800) 322-1112 support@textbetterinc.com

API Documentation

Our API solution offers flexible end points, on-demand reports, self-administration & instant integration capabilities.

Sending Text Messages

TextBetter uses a simple URL call to send text messages (SMS). It works with any internet browser and can be easily deployed, without complex code, like SOAP, REST or RPC.

https://api1A.com/OutgoingSMS.aspx?KEY=&From=&To=&Message=

KEY unique key for your company
FROM 11-digit telephone number
TO Your customers 11-digit telephone number
MESSAGE Up to 360 characters or your “if that then” statement call code

With each outgoing message, we provide the following result

Status: “{rn ”result”: {rn ”status”: {rn ”nvs_code”: ”S”,rn ”message”: ”Valid number, SMS delivered”,rn ”code”: ”200”rn },rn ”sms_id”: ”b2ej8fc4-94f2-462e-9lb3-4c16c4068d17”,rn ”sender”: ”19712701807”,rn ”recipient”: ”15164764461”,rn ”location”: ”USA”,rn ”carrier”: ”999”rn },rn ”id”: 0rn}”

Receiving Text Messages

TextBetter uses a customer provided endpoint to receive text messages. Depending on your preference, incoming text messages can be sent to your endpoint URL or email. We also provide metadata with each incoming text message. Messages sent to your endpoint will be URL encoded; remember to account for apostrophes if you will be inserting your messages into a database.

https://sms.anycompany.com
https://sms.anycompany.com/receive?From=12223334444&To=15558889999&Message=this is an incoming message

Example for C#:

Receiving values as query string

//incoming data string: From=12223334444&To=15558889999&Message=this is an incoming message 

Get the values from QueryString parameters

toNum Request.QueryString[“To”].ToString();
FromNum Request.QueryString[“From”].ToString();
IncomingPlaintext Request.QueryString[“Message”].ToString();
fromNum fromNum.Replace("+", "");  
IncomingPlaintext IncomingPlaintext.Replace("'", "''");  

Another language would need code equivalent to below

String data = new System.IO.StreamReader(Context.Request.InputStream).ReadToEnd();
String[] p = params.Split(‘&’)       //split parameters on & into an array, list, table, etc.

This would result in a table like:

p[0] ‘From=12223334444’
p[1] ‘To=15558889999
p[3] ‘Message=this is an incoming message’

To get the values, parse each string on the above

string[] v p[0].ToString().Split(‘=’)  
v[0] ’From’  
v[1] ‘12223334444’  

Reporting

These APIs will allow you to programmatically generate reports without logging into the Management Tool. API generated reports can be delivered through email or to your FTP site as a comma delimited txt file. Allowing you to easily read and ingest the data into your systems. The API can pull data for all conversations or for specific text enabled telephone numbers, as well as summary usage data, by text enabled number.

Conversation report

https://enterprise.textbetter.com/RunReportAPI.aspx?KEY=<KEY>&report=<ReportType>&FromDate=<FromDate>&ToDate=<ToDate>&UserID=<UserID>&virtual=<YourNumber>&other=<otherPersonsN
KEY = unique key for your company  
Report  = conversations  
FromDate = start date range for report  
ToDate = end date range for report  
UserID = the unique user id or FTP the report will be sent  
Virtual = A text enable number OR “ALL”  
Other = the “Other Party” number Or “ALL”
Conversation Report columns: (comma delimited txt file)
Virtual Mobile,
Virtual Mobile Tag,
Other Party,
Other Party Tag,
Message,
Date Time,
Type

Summary report

https://enterprise.textbetter.com/RunReportAPI.aspx?KEY=&report=&FromDate=&ToDate=&UserID=
KEY = unique key for your company
Report = summary
FromDate = start date range for report
ToDate = end date range for report
UserID = the unique user id or FTP the report will be sent
Summary Report columns: (comma delimited txt file)
Virtual Mobile,
Total Messages,
Total Sent,
Total Received

Opt-Out report

https://enterprise.textbetter.com/optoutReportAPI.aspx?KEY=<KEY>_FromEnterprise

Example:

https://enterprise.textbetter.com/optoutReportAPI.aspx?KEY=ABC123_FromEnterprise
KEY  = unique key for your company

Summary Report columns: (comma delimited txt file)
Original sending number,
Opt-Out subscriber number