SMS API

From AAISP Support Site
Revision as of 08:32, 13 May 2015 by AA-Andrew (talk | contribs) (Created page with "This page contains technical details and as such may be quite long and hard to follow. If you cannot find the details you require please feel free to contact support who can e...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This page contains technical details and as such may be quite long and hard to follow. If you cannot find the details you require please feel free to contact support who can explain things for you. You will also find many other customers on irc who can help with queries. Feel free to send us feedback if you think there are any errors in this page.

Inbound

This is where text messages are sent to us to delivery to our customers. We provide VoIP numbers in all UK area codes and some special services (e.g. 0800). However, at present, only a few of the numbers starting 01 and 02 can receive texts properly from most networks. All of our 01, 02 and 03 numbers can receive texts from Three properly. Attempts to send texts to other geographic numbers (i.e. those starting 01 and 02) cause a call to be made and the text read out by an automated system.

Where texts can be received properly, and this includes all cases where A&A customers send texts through us, the text will be sent on to you by your choice of means. This is based on the incoming text setting on the control pages for your number.

Email

If you simply put in an email address, then the text is emailed to you. Additional email headers may be present to specify fields such as User Data Header if present, etc. This is also the default if you do not put any incoming text handling in to the control pages, but you have an email address defined for the number.

SIP2SIM

If you include a 19 digit string starting 89 which is the SIM ICCID for one of your SIP2SIM cards then the text will be passed to the SIM directly as a normal text. SIP2SIM charges apply for the SIP2SIM side as an incoming text.

HTTP

If you put an entry starting http:// or https:// then we will attempt to send the text to you using HTTP (or HTTPS). If the URL ends with a ? or & then an HTTP GET is done with a set of form fields (i.e. name=value) containing information about the text. If the URL does not, then an HTTP POST is done using URL encoded form data.

The fields posted are as follows, but additional fields may be added from time to time.

username This is the phone number as shown on the control pages for your VoIP number in full international format with no spaces.
password The corresponding outgoing password for the username as set in the control pages for your VoIP number.
da This is the number to which the message is to be sent and should be a full international format number (however, national format is also accepted). This may be a SIP2SIM ICCID to send direct to a SIM.
ud This is the message to send, encoded in UTF-8.
limit Set this to limit the number of parts that the message may be sent in.
costcentre Optional, up to 10 characters, code that is included in the bill XML data.
private Marks the message as private, see below
oa Sets the sending number (see below). Normally not needed as your username is used.
udh Hex UDH header, see below.
srr Email address or URL for delivery report, see below