Overview of the SOAP API features

 A variety of messaging and SMS features are supported by the gateway, which can be activated by including additional parameters. These parameters include those in the table below.

Feature

Description

Values

Default

Parameter

Binary

Force the message content to be sent as binary (8-bit) data

0,1

0

binary

Client Message ID

Client message ID defined by user for message tracking.

2993b6b548

none

cliMsgId

Concatenation

Specifies the maximum number of message parts available for the message.

1,2,3

Defaults to setting on your API connection.

concat

Delivery Time

Delays delivery of your SMS to the mobile device in minutes relative to the time at which the SMS was received by our gateway.

10

0

deliv_time

Delivery Queue

Delivers the message through one of three queues assigned to each client account. Messages in the highest priority queue will be delivered first.

1,2,3

3

queue

Destination Address

The mobile number of the handset to which the message must be delivered (MSISDN). The number must be in international format with no leading zeros or + symbol.

27831234567 (South Africa) 16501234567 (USA) 44123456789 (UK)

none

to

Enable Callback

Enables you to receive message delivery status updates via an HTTP request made to your server.

0,1,2,3,4,5,6,7

0

msg_callback

Gateway Escalation

Prompts an escalation to an alternative (more expensive) route, if messages are queued or delayed on the least-cost route.

0,1

0

escalate

Maximum Credits

Overrides the maximum charge specified online in “routing profiles”.

0.8,1,1.5,2,2.5,3

none

max_credits

Message Text

The content of your SMS message.

Hello World

 

text

Message Type

Send other types of messages such as flash messages.

Refer to description

 

msg_type

Mobile Originated

This is only applicable to clients that have subscribed to a two-way messaging service. We route via pre-defined carriers to enable the ability for a reply to be received. |

0,1

0

mo

Required Features

Some parameters and features are not set as “required” by default, and may be dropped if the least-cost route does not support them. Set this parameter to ensure that the features set when an SMS is sent are supported by the gateway used.

Refer to description

none

req_feat

Scheduled Time

Specify when a message should get delivered in GMT+0.

2015-06-30T14:00:00Z

none

scheduled_time

Sender ID

The source/sender address that the message will appear to come from (also known as the “Sender ID”). These must be registered within your online account and approved by us before they may be used. Two-way numbers rented from us do not require approval.

 

none

from

Unicode Message

Two digit language code. Convert your text to Unicode [UCS-2 encoding]. See http://www.Unicode.org/.

0,1

0

unicode

User Data Header

Set the UDH content of a message.

   

udh

Validity Period

The validity period in minutes relative to the time at which the SMS was received by our gateway. The message will not be delivered if it is still queued on our gateway after this time period.

25

24 Hours

validity