|
SENDESMS
Syntax :
SENDESMS("TelefonnummerEmpfänger", "Text der SMS", "Absendername", Statusvariable)
Mit dieser Anweisung können SMS versendet werden.
Zum Versand von SMS ist ein SMS-Konto mit Guthaben erforderlich.
Zu diesem Konto gibt es einen SMS-Code, der im Reiter Sicherheit des Einstellungsfensters angegeben wird.
Eine SMS kann maximal 160 Zeichen haben.
Das SMS-Guthaben kann im CL-Shop unter diesem Link bestellt werden:
SMS für CL-Software
Beschreibung der Anweisung SENDESMS:
Als erster Parameter der Anweisung wird die Mobilfunknummer des Handys angegeben, an das die SMS gesendet werden soll.
Wenn diese Nummer eine Festnetznummer im Inland ist wird dort angerufen und die SMS vorgelesen.
Je nach Telefonanbieter des Festnetzanschlusses kann es sein, dass dieses Featurue nicht zur Verfügung steht steht.
Als zweiter Parameter wird der Text der SMS angegeben. Der Text muss aus Buchstaben, Ziffern und Leerezichen bestehen, zulässige Sonderzeichen sind ! ? *, Komma, Punkt, Doppelpunkt, Semikolon, Klammern und einfaches Anführungszeichen.
Die Zeichen % & + # § werden in Leerzeichen umgewandelt.
Umlaute werden in eine andere Schreibweise umgewandlet ä zu ae, Ö zu Oe usw.
Bei Verwendung anderer als der aufgeführten Sonderzeichen werden diese in ? umgewandelt, können jedoch auch dazu führen, dass die SMS nicht versendet werden kann.
Dritter Parameter ist der Absendername, unter diesem Namen erscheint die SMS auf dem Ziel-Handy.
Vierter Parameter der Anweisung ist eine Variable oder ein Objekt vom Typ Zeichen, welches selbst erstellt werden muss. In diese Variablen wird eine Statusmeldung geschrieben sobald die SMS an den SMS-Server übergeben wurde.
Es werden 3 Parameter, getrennt durch Komma in die Statusvariable geschrieben.
Erster Parameter ist eine dreistellige Zahl.
100 bedeutet, dass die SMS ohne Fehler SMS-Server übertragen wurde, eine andere Zahl oder Text zeigen an, dass ein Fehler aufgetreten ist.
Der zweite Parameter gibt an wieviele SMS-Credits verbraucht wurden und ist abhängig von der Länge der gesendete SMS.
Wenn die Nachricht kleiner als 160 Zeichen ist wird nur 1 SMS-Credit berechnet, über 160 Zeichen 2 Credits.
Eine SMS kann maximal 320 Zeichen haben, wenn der Text mehr Zeichen hat werden diese abgeschnitten.
Wenn aufgrund eines Fehlers in den Parametern eine SMS nicht versendet werden konnte, erfolgt keine Belastung der Credits, das gilt jedoch nicht wenn ungültige Mobilfunknummern verwendet werden, da dann trotzdem ein (erfolgloser) Versand erfolgt.
Den aktuellen Kontostand Ihrer SMS-Credits können Sie sich auf folgender Seite anzeigen lassen:
https://cl-control.de/sms/smskonto.php
Allgemeine Hinweise:
Eine 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.
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.
|