SMS API: Difference between revisions

==Outbound messages==

We operate an outbound text service that is available to all of our customers that have a VoIP number. To use this service you must have an outgoing password configured in the control pages for the VoIP number.

To send texts you need to issue an HTTP GET or POST to our outbound text gateway http://sms.aa.net.uk/sms.cgi with the following fields as if sent from a form. As the password is sent in plain text you may prefer to use https.

{|

! 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 <tt>username</tt> 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.

|- class="e pro"

| ''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 <tt>username</tt> is used.

|-

| ''udh''

| Hex UDH header, see [[UDH_messages_to_SIM]].

|-

| ''srr''

| Email address or URL for delivery report, see below

|}