SENDESMS
 
Syntax :
SENDESMS("TelefonnummerEmpfänger", "Text der SMS", "Absendername", Statusvariable)
 
Mit dieser Anweisung können SMS versendet werden.
Voraussetzung ist, dass der VPN-Service der CL-Software benutzt wird und auf dem Konto des VPN-Services ein SMS-Guthaben vorhanden ist.
Die Zugangsdaten zum VPN-Service müssen Im Reiter "Sicherheit" des Einstellungsfensters eingetragen werden damit der Versand von SMS möglich ist.
Als erster Parameter der Anweisung wird die Mobilfunknummer des Handys angegeben, an das die SMS gesendet werden soll.
 
Als zweiter Parameter wird der Text der SMS angegeben. Folgende Zeichen im Text sind nicht zulässig: % & +
Wenn eines dieser nicht zulässigen Zeichen im Text verwendet wird, wird es durch ein Leerzeichen ersetzt.
Dritter Parameter ist der Absendername, unter diesem Namen erscheint die SMS auf dem Handy.
Wenn der Absendername leer ist oder nur 1 Zeichen beinhaltet wird die SMS als Low-Cost-SMS versendet. Eine Low-Cost-SMS wird nur innerhalb Deutschlands versendet, als Absender erscheint eine unbestimmte Mobilfunknummer, der Versand kann länger als eine Minute dauern. Für eine Low-Cost-SMS wird 1 SMS-Credit vom Konto des VPN-Services abgebucht.
Wenn der Absendername mehr als einen Buchstaben beinhaltet (maximal 11 sind möglich) wird die SMS als Premium-SMS versendet. Eine Premium-SMS wird weltweit versendet, als Absender erscheint der angegebene Absendername, der Versand erfolgt normalerweise innerhalb von ca. 10 Sekunden. Für eine Premium-SMS werden 2 SMS-Credits vom Konto des VPN-Services abgebucht.
 
Vierter Parameter der Anweisung ist eine Variable oder ein Objekt vom Typ Zeichen, welche selbst erstellt werden muss. In diese Variablen wird eine Statusmeldung geschrieben  sobald die SMS an den SMS-Server übergeben wurde. Wenn ein Fehler bei der Übergabe der SMS an den Server auftritt ist das erste Wort in der Statusvariablen "*ERROR", in dem Fall wurde die SMS nicht versendet, der weitere Text enthält zusätzliche Informationen. Ein solcher Fehler ist normalerweise darauf zurückzuführen, dass keine Internetverbindung besteht oder der Server des VPN-Services nicht erreichbar ist. Falls die Zugangsdaten für den VPN-Service nicht korrekt sind lautet die Fehlermeldung "Not authorized"
Im Fall eines solchen Fehler wird das SMS-Konto natürlich nicht belastet.
Wenn die SMS erfolgreich an den Server übermittelt werden konnte beinhaltet die Statusvariable die Anzahl der verbliebenen SMS-Credits und der Zeitpunkt des Versands der SMS.
Diese Bestätigung bedeutet aber nicht, dass die SMS den Empfänger erreicht hat.
Die SMS wird nicht bei Ausführung des Befehls versendet um Verzögerungen der Ausführung durch Internetzugriffe zu vermeiden. Das Versenden passiert nach Ausführung des Befehls im Hintergrund, daher steht der Status des SMS-Versands immer erst einige Sekunden nach Ausführung des Befehls in der Variablen zur Verfügung.
Wann die SMS empfangen wird ist vom Mobilfunknetz bzw. der Mobilfunkverbindung des Empfängers abhängig.
Bitte beachten Sie:
Wenn versucht wird eine SMS an eine ungültige Mobilfunknummer versendet wird erscheint keine Fehlermeldung, weil die Unzustellbarkeit der Mail erst bei der späteren Verarbeitung im Mobilfunknetz festgestellt wird. Da es bei einem solchen Fehler keine Rückantwort gibt ist eine entsprechende Gutschrift auf dem SMS-Konto nicht möglich.
Eine SMS darf maximal 160 Zeichen haben, wenn der Text mehr Zeichen hat werden diese abgeschnitten.
 
 
Beispiel Low-Cost-SMS:
 
sendesms("01712345678", "Alarm Temperatur Tiefkühlschrank", "x", SMSStatus)
 
Beispiel Premium-SMS:
 
wenn TempTiefkuehl > -10 und SMSTiefkuehlMerker ausgeschaltet dann
  SMSText:="Achtung Temperatur Tiefkühlschrank ist " + TempTiefkuehl + " Grad"
  sendesms("01712345678", SMSText, "MeinHaus", SMSStatus)
  SMSTiefkuehlMerker einschalten
endewenn
 
Bitte unbedingt beachten:
Sie müssen durch geeignete Programmierung sicherstellen, dass nicht ungewollt zu viele SMS verschickt werden, also z.B. einen Zähler oder Merker wie im zweiten Beispiel verwenden. Ein solcher Merker kann dann manuell oder zeitgesteuert wieder ausgeschaltet bzw. auf 0 gesetzt werden.
Sie sollten Ihre Programmierung testen und überprüfen ob nicht unbeabsichtigt viele SMS versendet werden. 
Den aktuellen Kontostand Ihrer SMS-Credits können sie auf der Internetseite des VPN-Services prüfen, indem Sie folgende Seite aufrufen:
https://hausfernsteuerung.de:4433/smscredits?token=<Ihr VPN-Token>&subdomain=<IhreSubdomain>
 
Beispiel:                                                                 
https://hausfernsteuerung.de:4433/smscredits?token=ktGK734xydjq7qzLdl85sdXXY&subdomain=schaigner
Antwort Beispiel:
78 SMS-Credits
 

Created with help of DrExplain