# SMS

> Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26  
> Index: https://www.symcon.de/de/llms.txt

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/sms/

_Benötigt Symcon >= 4.1_

SMS ist ein Modul von IP-Symcon mit dem sich SMS via Clickatell verschicken lassen. Eine Verbindung mit IP-Symcon wird über die REST API hergestellt.

> **Achtung:** Seit November 2016 bietet Clickatell nur noch die REST-API an, welche IP-Symcon mit dem Modul SMS (Clickatell) integriert hat.

### Installation (REST API)
Um das SMS Modul verwenden zu können, wird ein Account bei [https://www.clickatell.com](https://www.clickatell.com)  benötigt.
Die nachfolgende Step-By-Step Anleitung erklärt den Anmeldeprozess:

1. Die folgende URL öffnet die Anmeldeseite zur Registrierung am SMS Gateway:
[https://www.clickatell.com/sign-up/](https://www.clickatell.com/sign-up/)
2. Nach dem Bestätigen der Verifizierungs-Mail muss sich unter [https://portal.clickatell.com/#/login](https://portal.clickatell.com/#/login)  eingeloggt werden. Es muss "Platform" ausgewählt werden.
3. Über das Dashboard auf der Seite [https://portal.clickatell.com/](https://portal.clickatell.com/)  müssen sowohl Telefonnummern verifiziert, als auch eine "Integration" eingerichtet werden.
4. Eine Integration konfiguriert die Art der Kommunikation.
5. Guthaben wird über [https://portal.clickatell.com/#/billing/details](https://portal.clickatell.com/#/billing/details)  verwaltet.

Damit IP-Symcon mit dem Gateway kommunizieren kann, muss zusätzlich noch der APIKey der Integration in IP-Symcon eingepflegt werden.

1. Folgende URL muss geöffnet werden:
[https://portal.clickatell.com/#/integrations/sms](https://portal.clickatell.com/#/integrations/sms)
2. Es muss die Option "__API key__" kopiert werden.
3. Der erhaltene APIKey, muss in IP-Symcon auf der Konfigurationsseite des SMS-Modul angegeben werden.

> **Hinweis:** Die Absendernummer muss im Clickatell Account verfiziert worden sein, bevor über diese SMS versendet werden können.

### Installation (veraltet, Https API)
Diese API wird seit November 2016 nicht mehr von Clickatell unterstützt.
Aus dem Grund wurde das Modul überarbeitet.

### Einbindung in IP-Symcon
Die Konfiguration besteht ausschließlich aus dem API-Key, der im Account eingerichtet wurde.

> **Achtung:** Es gibt mit der neuen REST-API bisher keine Möglichkeit das Guthaben abzufragen. SMS_RequestBalance ist nur für die alte API noch funktionial.

### Ländercode Vorwahl Nummer
Es müssen keine führenden Nullen angegeben werden.
Beispiel: +49171123456789

Es gibt auch auf der Clickatell-Homepage auf der Settings-Seite die Möglichkeit eine automatische Ländervorwahl zu integrieren.
"Convert mobile numbers into international format"
Somit entfällt das +49 für die Ländervorwahl.

## SMS_Send

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/sms/sms-send/

`bool SMS_Send(int $InstanzID, string $Nummer, string $Text)`

versendet eine SMS an eine Nummer

**Parameter**

- `$InstanzID` (int): ID des zu schaltenden Geräts
- `$Nummer` (string): Mobilfunknummer des Empfängers
- `$Text` (string): Text der SMS (max. 160 Zeichen)

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Text der SMS (max. 160 Zeichen)

**Beispiel**

```php
SMS_Send(12345, "0171123456789", "Alarm!");
```