General

Selecting the SMS Service node in the IceWarp Server console will display the SMS Service configuration area, with all current services listed:

Figure. General tab.

Field

Description

System account settings

This button opens the SMS Account dialog where you can set SMS account options.

See the Domains and Accounts - Management - User Accounts - Policies chapter – SMS Account Dialog section.

URL

URL of the local HTTP gateway for integration with custom scripts or applications.

ID

This column shows the COM port that this service is using.

Description

Your free-form description for this service.

Type

The type of modem this service is using.

Active

Whether this service is active (set by you).

Add

Click this button to add a new service. The SMS Gateway dialog opens.

Edit

Select a service and click the button to modify settings of this service. The SMS Gateway dialog opens.

Copy

Select a service and click the button to copy the service. The SMS Gateway dialog opens.

Delete

Select a service and click the button to delete this service.

Warning: Access mode to the service can be set on both domain and user levels. See the appropriate places ([domain] - Policies, [user] - Policies).

Figure. SMS Gateway dialog.

This dialog is used to setup or modify gateway's properties.

Field

Description

Active

Check this option to activate this SMS gateway.

ID

Unique identifier of the gateway, needs to be specified when multiple gateways are configured on the same server. Gateway ID is used to route messages to a specific gateway within gateway selection dialogs, in Outgoing/Incoming Messages rules or by URL parameter ?id=XXX. If not specified there, load-balancing takes places automatically and the first available gateway is used to send the message.

Type

Select the gateway type:

GSM Modem

This gateway will connect to a GSM local hardware modem.

HTTP Request

This gateway will connect to a remote HTTP server.

Device

For a GSM Gateway

Select the COM port of the modem to use with this gateway.

If your device is using virtual COM port rather than a standard one (COM1–4) then you should just type COM port number into the field (e.g. COM16).

For an HTTP Gateway

Select the URL given in the dropdown and modify it to suit your HTTP SMS gateway provider.

The example given in the dropdown is designed to be used with a remote instance of IceWarp Server, and SMS will be sent by the remote server specified.

Another example is set to suit to a remote HTTP gateway provided by Clickatell.

For details about HTTP SMS syntax and examples, refer to the HTTP SMS Service Setup and HTTP Request chapters.

For details about configuring of Clickatell HTTP gateway, refer to the Configuring Clickatell HTTP Gateway chapter.

Note: As IceWarp Server does not support SMS splitting, make sure your provider can deal with longer SMS (more than 150 characters) – is able to split them into more messages.

Template

Use the list to select a pre-defined device.

Description

Enter a meaningful description for this gateway (for identification purposes).

PIN/Password

Enter any PIN for this modem (if required).

Password is used for an HTTP gateway when SMS answers will be delivered via a delivery script. (See theHTTP Request - Delivery Script chapter. Example: http://yourserver.com/sms/deliver.html?id=HTTP&pass=pinnumber&number=%from%3&data=%data% –pinnumber is just the PIN/Password field within the HTTP gateway for incoming messages.)

E-mail From

This option facilitates SMS and email interoperability and must be used to enable the Reply-To feature. It allows you to reply to SMS received as emails into your mailbox, ensuring that your reply will be sent over the SMS gateway back to the originating sender's mobile number.

The From: edit lets you rewrite the From: header of SMS received to the gateway, so that it can  be routed to email or processed by incoming rules.

Enter sms:%s@icewarpdemo.com to rewrite the From: header with an SMS to email address so that the gateway can route the message back to SMS when you reply to such email. If you do not wish to use the Reply-To feature, the header can include only %s and in such case the message will include just sender's mobile number in the From: header.

Note: %s will be replaced by the originating sender's mobile number.

The helper sms: email account needs to be configured only for use with desktop email clients, in this case all messages are routed through the internal sms: protocol.

SMS Center

Enter the message center phone number of the service provider for this modem. If in doubt (format etc.), ask your provider.

Note: You only need to set this if it is not already set in your modem. When using HTTP Request, you do not need to set it.