« Back to Product

Documentation

SMS

Require: Symcon >= 4.1

SMS is an IP-Symcon module which enables sending SMS via Clickatell. A connection to IP-Symcon is established via the REST API.

Warning

Since November 2016, Clickatell has only offered the REST API, which IP-Symcon has integrated with the SMS (Clickatell) module. The deprecated module SMS (Clickatell old) for the old HTTPS API is described under SMS (legacy).

Requirements

In order to be able to use the SMS module, an account at clickatell.com is required.
The following step-by-step instructions explain the registration process:

  1. The following URL opens the login page for registering with the SMS gateway:
    clickatell.com/sign-up
  2. After confirming the verification email, one must log in at portal.clickatell.com . "Platform" must be selected.
  3. Telephone numbers must be verified and an "integration" set up via the dashboard on the portal.clickatell.com page.
  4. An integration configures the type of communication.
  5. Credit is managed through portal.clickatell.com .

In order for IP-Symcon to be able to communicate with the gateway, the API key for the integration in IP-Symcon must also be entered.

  1. The following URL must be opened:
    portal.clickatell.com
  2. The "API key" option must be copied.
  3. The APIKey received must be specified in IP-Symcon on the configuration page of the SMS module.
Warning

The sender number must be verified in the Clickatell account before this SMS can be sent.

Installation

The module is part of Symcon and does not need to be installed.

Integration in IP-Symcon

The configuration consists exclusively of the API key that was set up in the account.

Warning

The credit cannot be queried with the REST API.

Configuration page

Name Description
APIKey API key of the integration from the Clickatell account

Below the configuration, "Number", "Message" and "Send Message" send a test SMS.

Country Code Area Code Number

No leading zeros need to be specified.
Example: +49171123456789

There is also the option of integrating an automatic country code on the Settings page of the Clickatell homepage.
"Convert mobile numbers into international format"
Thus, the +49 for the country code is omitted.

Any questions?