HTTP SMS Service Setup

To configure sending SMS over the HTTP protocol, you can follow the SMS Service Setup, but when selecting Type (the SMS Gateway dialog), choose the HTTP Request item.

In the next step, you have to select (and optionally modify) an URL in the Device field. There are two default URLs there:

  1. The first one is for communication with another IceWarp Server and its HTTP SMS gateway. This supports all SMS types: ASCII, Unicode, binary.
  2. The second one is for Clickatell HTTP SMS gateway. (See .)

URL example:

http://<server>/sms/?number=%number%&data=%data%&udh=%udh%&binary=%binary%&pid=%pid%&dcs=%dcs%&sender=%sender%

This URL consists of the following parameters:

(You can use corresponding variables for them.)

Parameter

Variable

&number

%number%

&data

%data%

&udh

%udh%

&binary

%binary%

&pid

%pid%

&dsc

%dcs%

&sender

%sender%

%sender_phonealias%

&parts

%parts%

&condition

%condition%

Note: The %sender_phonealias% variable uses the value defined in the Phone # field (Domains and Accounts – Management – <domain> – Users – <user> – User) – provided that the &sender parameter is supported by your SMS provider.

These parameters can be combined with the following attributes:

Attribute

Description

;unicode

encodes the parameter to the Unicode format.

;isunicode

conditions that allow you selection from the attribute modifiers based on the encoding of a parameter, or to append a custom value= parameter only if a condition (isunicode, isascii, isbinary) is met.

;isascii

;isbinary

;value=

adds text to URL parameters.

;hex

encodes the parameter to the hexadecimal format.

;len

adds the length character to any parameter, usually used for UDH, e.g.: %udh;len;hex% – udh parameter, its length, encoded to hexadecimal format.

Required for proper UDH handling by Clickatell gateway. It can be used for any parameter such as %body;len%.

;b64

encodes the parameter to the base64 format.

;charset=

is used to convert UTF-8 text to a different charset.