Dokumentation
SMS
Benötigt: IP-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.
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 clickatell.com benötigt.
Die nachfolgende Step-By-Step Anleitung erklärt den Anmeldeprozess:
- Die folgende URL öffnet die Anmeldeseite zur Registrierung am SMS Gateway:
clickatell.com/sign-up - Nach dem Bestätigen der Verifizierungs-Mail muss sich unter portal.clickatell.com eingeloggt werden. Es muss "Platform" ausgewählt werden.
- Über das Dashboard auf der Seite portal.clickatell.com müssen sowohl Telefonnummern verifiziert, als auch eine "Integration" eingerichtet werden.
- Eine Integration konfiguriert die Art der Kommunikation.
- Guthaben wird über portal.clickatell.com verwaltet.
Damit IP-Symcon mit dem Gateway kommunizieren kann, muss zusätzlich noch der APIKey der Integration in IP-Symcon eingepflegt werden.
- Folgende URL muss geöffnet werden:
portal.clickatell.com - Es muss die Option "API key" kopiert werden.
- Der erhaltene APIKey, muss in IP-Symcon auf der Konfigurationsseite des SMS-Modul angegeben werden.
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.
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.