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
[email protected]

Introduction

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 or RPC.

API Key: [Place your API key here]

Sending Texts with SMS ID

Below you will find an example request URL for sending an SMS text message. The same call can be used to perform an optional SMS ID check prior to sending the SMS message (verify the “to” number is wireless). If the check is used and the number is not wireless a corresponding error message is returned.

API Endpoint to Send Text Messages

https://api.textbetter.com/SendTexts.aspx?KEY=< KEY >&DID=< fromnumber >&tonumber=< tonumber >&message=< message >&checkSMSID=< y/n >

Parameters

Name
Key
FromNumber
ToNumber
Message
CheckSMSID
SMSID
Description
Your unique API Key
The 11 digit phone number you are sending the text message from; it must be a TextBetter text enabled number
The 11 digit phone number you are sending the text message to
The message you want delivered
If you want to verify the to number is wireless prior to sending
Check if the ToNumber is wireless before sending (must be 'Y' or 'N')*
Example
sjxgh63823jh&d
12215551336
13125557760
Hello world!
Y / N

*Notes

  • If SMSID is set to Y, the system will determine if the ToNumber is wireless or landline before sending. If it is wireless, the message will be sent. If it is landline, then the text message will not be sent and the error response “not a wireless number” will be returned.
  • If SMSID is set to N then this check is ignored.

Response (Success)

  • “Success!”

Possible Error Responses

  • “Invalid KEY”
  • “Invalid DID”
  • “Invalid To Number”
  • “Invalid Message”
  • “Not a wireless
  • “Opt-Out”
  • “Invalid Key/Company Combination”
  • “Error:” + detail error message
  • Response from carrier if not Success!

Receiving Texts

Messages Sent to your SMS Enabled Numbers go to your Https://Endpoint

During the set-up process, when we provide your API Key, we will request your HTTPS endpoint. This endpoint will be called for each message sent to your text enabled numbers (note: upon request separate endpoints can be requested for enabled numbers).

For example, if you provide us with https://sms.example.com/inc you will receive the following GET request, when someone sends a text to one of your text enabled numbers:

GET https://sms.example.com/inc?From=< remoteNumber >&To= < virtualNumber >&Message=< Message >

Parameters

Name
From
To
Message
Description
the number that sent the text
the number the text is to
the contents of the message
Example
12215551336
13125557760
Hello world!

SMS ID Only

Below you will find an example request URL for verifying a “to” number is either wireless or landline. This call is NOT used for sending SMS text messages.

https://api.textbetter.com/GetSMSID.aspx?KEY=< KEY >&Phone=< 11 digit phone >

Fields

Name
Key
Phone
Description
Your unique API Key
11 digit phone number you want to check wireless or landline
Example
731_09d6bb59e5
13125007760

Response (Success)

  • 0 Landline
  • 1 Wireless
  • Possible Error Responses

    • “Cannot find this customer KEY”
    • “Invalid KEY”
    • “Invalid Phone”