SMS-Einstellungen

Ca. 8 Min. Lesezeit

Damit Alarmbenachrichtigungen per SMS gesendet werden können, muss ein SMS-Anbieter definiert werden. Diese Einstellungen nehmen Sie auf der Seite Einstellungen > SMS-Einstellungen vor. Die Seite können Benutzer mit der Rolle Editor und die Gruppe SystemAdmin öffnen.

SMS werden nicht direkt im Moment des Alarms gesendet. Tritt ein Alarm auf, wird die Nachricht in eine dauerhafte Sendewarteschlange geschrieben, und der Benachrichtigungsdienst übergibt die Nachrichten aus der Warteschlange an den Anbieter. So verzögert eine langsame Antwort des Anbieters die Alarmverarbeitung nicht.

Voraussetzungen

• Die installierte Lizenz muss das Recht zum SMS-Versand enthalten. Fehlt dieses Recht, werden weder Alarm-SMS noch Test-SMS gesendet.
• Beim gewählten Anbieter muss der API-Zugriff freigeschaltet sein.
• Der Absendertitel muss im Anbieterportal vorab genehmigt sein.
• Für Benutzer, die SMS erhalten sollen, muss im Benutzerdatensatz eine Telefonnummer definiert sein (siehe Benutzer- und Gruppenverwaltung).
• Der Benachrichtigungsdienst muss laufen. Den Zustand des Dienstes können Sie mit der Schaltfläche Dienststatus prüfen auf der Seite Benachrichtigungen prüfen.

Anbieter

In der Liste Anbieter stehen die folgenden Firmen für den Versand zur Verfügung. Wenn Sie einen Anbieter auswählen, werden die Anmeldefelder dieser Firma auf der zweiten Karte der Seite angezeigt. Mit einem Stern (*) gekennzeichnete Felder sind Pflichtfelder.

Anbieter	Anmeldefelder	Status
Netgsm	Benutzername*, Passwort*, App-Schlüssel	Verfügbar
İleti Merkezi	API-Schlüssel*, API-Hash*	Verfügbar
Verimor	Benutzername*, Passwort*	Verfügbar
Twilio	Konto-SID*, Auth-Token*, Absendernummer*, Messaging-Service-SID	Verfügbar

Der Versand über die anderen Anbieter in der Liste wird nicht unterstützt. Wenn Sie einen nicht unterstützten Anbieter auswählen, erscheint auf der Seite eine Warnung, und über diesen Anbieter können keine SMS gesendet werden.

Twilio

Ob Twilio in die Türkei senden kann und wie der Absender registriert wird, ist von Konto zu Konto verschieden; prüfen Sie bei Twilio, ob Ihr Konto diese Bedingungen erfüllt.

Einstellungsfelder

Felder der Karte SMS-Anbietereinstellungen:

Feld	Beschreibung
Anbieter	Die Firma, über die die SMS gesendet wird.
Absendertitel	Der Titel, der auf dem Telefon des Empfängers als Absendername erscheint; höchstens 32 Zeichen. Muss genau mit dem beim Anbieter genehmigten Wert übereinstimmen.
Standard-Ländercode	Die Vorwahl, die Nummern ohne Ländervorwahl vorangestellt wird. Für die Türkei +90 (Standard).
Zeitlimit (Sekunden)	Die längste Wartezeit auf eine Antwort des Anbieters; 1–120 Sekunden. Standard 30.
Wiederholungen	Die Anzahl der Wiederholungen bei Netzwerkfehlern, Zeitüberschreitungen oder vorübergehenden Fehlern des Anbieters; 0–10. Standard 3. Bei dauerhaften Fehlern wird nicht wiederholt.
Maximale Segmente	In wie viele SMS-Teile eine Nachricht höchstens aufgeteilt werden darf; 1–10. Standard 3. Eine Nachricht über dieser Grenze wird überhaupt nicht gesendet.

Geheime Felder wie Passwort, API-Schlüssel, Hash und Token auf der Karte des Anbieters werden verschlüsselt gespeichert und nie an die Seite zurückgesendet. Um einen gespeicherten geheimen Wert beizubehalten, lassen Sie das Feld leer; um ihn zu ändern, geben Sie den neuen Wert ein.

Anbieter wechseln

Wenn Sie einen anderen Anbieter auswählen und speichern, werden die gespeicherten Anmeldedaten des bisherigen Anbieters gelöscht. Wechseln Sie zum bisherigen Anbieter zurück, müssen Sie die Daten erneut eingeben.

Um die Änderungen zu speichern, klicken Sie auf Einstellungen speichern. Ist der SMS-Versand aktiviert und wird ein Anbieter ausgewählt, der nicht für den Versand verfügbar ist, kann nicht gespeichert werden. Bei aktiviertem Versand wird das Speichern auch abgelehnt, wenn eines der Pflichtfelder des Anbieters leer ist.

Nachrichtensegment

Ein Segment ist ein einzelner SMS-Teil, den der Netzbetreiber berechnet. Auch wenn eine lange Nachricht auf dem Telefon wie eine einzige Nachricht aussieht, kann der Anbieter sie als mehrere Segmente senden und berechnen.

Kodierung	Einzelnes Segment	Pro Segment bei geteilter Nachricht
GSM-7	160 Zeichen	153 Zeichen
Unicode (UCS-2)	70 Zeichen	67 Zeichen

• Lateinische Standardbuchstaben werden mit GSM-7 gesendet.
• Die Zeichen ^ { } \ [ ] ~ | € zählen in GSM-7 als zwei Zeichen.
• Türkische Zeichen, die es in GSM-7 nicht gibt, wie ş, ğ, ı, schalten die Nachricht auf Unicode-Kodierung um; die Grenze für ein einzelnes Segment sinkt auf 70 Zeichen.

Beispiel: Ein Text mit 100 Zeichen, der nur lateinische Standardbuchstaben enthält, ist ein einzelnes Segment. Ein gleich langer Text, der ş oder ğ enthält, ergibt zwei Segmente.

Test-SMS

Mit der Karte Test-SMS prüfen Sie die eingegebenen Einstellungen mit einem echten Versand:

1. Geben Sie die Anbieterdaten ein und klicken Sie auf Einstellungen speichern.
2. Geben Sie die Nummer in das Feld Testtelefon ein. Das Feld akzeptiert nur Ziffern, +, Klammern und Leerzeichen.
3. Geben Sie in das Nachrichtenfeld einen kurzen Testtext ein.
4. Prüfen Sie die unten auf der Karte angezeigte Zeichenzahl, die Segmentzahl und die Kodierung.
5. Klicken Sie auf Test-SMS einreihen.
6. Verfolgen Sie das Ergebnis auf dem Bildschirm Archiv > Benachrichtigungsverlauf (siehe Benachrichtigungsverlauf).

Solange der Standard-Ländercode +90 ist, werden nur türkische Mobilfunknummern akzeptiert. Die folgenden Schreibweisen sind alle gültig und werden vor dem Versand in das Format +905321234567 umgewandelt:

• 0532 123 45 67
• 5321234567
• +90 (532) 123 45 67
• 0090 532 123 45 67

Bei einer ungültigen Nummer erscheint unter dem Feld die Warnung Geben Sie eine gültige türkische Mobilnummer ein.

Die Schaltfläche Test-SMS einreihen ist nur aktiv, wenn der SMS-Versand aktiviert und der ausgewählte Anbieter verfügbar ist. Auch eine Test-SMS ist ein echter Versand und wird vom Anbieter berechnet.

Zusammenhang mit Benachrichtigungen

SMS verwenden keine eigene Empfängerliste. Wird auf der Seite Benachrichtigungen für eine Benachrichtigung zu einem Alarm als Benachrichtigungstyp SMS oder EmailAndSMS gewählt, erhalten die Benutzer dieser Benachrichtigung eine SMS an die Telefonnummer in ihrem Benutzerdatensatz.

• Benutzer mit ungültiger oder leerer Telefonnummer erhalten keine SMS; die anderen Empfänger sind davon nicht betroffen.
• Kommt dieselbe Nummer bei einem Alarmereignis mehrmals vor, wird die SMS nur einmal gesendet.
• E-Mail und SMS sind voneinander unabhängig; ein Fehler im einen Kanal hält den Versand im anderen nicht an.

Versandstatus

Den Status jeder SMS verfolgen Sie auf dem Bildschirm Benachrichtigungsverlauf:

Status	Bedeutung
In Warteschlange	Die Nachricht wartet auf den Versand.
Wird verarbeitet	Die Nachricht wird an den Anbieter übergeben.
Akzeptiert	Der Anbieter hat die Anfrage angenommen.
Gesendet	Der Anbieter hat die Nachricht gesendet.
Zugestellt	Vom Netzbetreiber oder Gerät ist eine Zustellbestätigung eingegangen.
Fehlgeschlagen	Der Versand ist fehlgeschlagen.
Validierung fehlgeschlagen	Die Nachricht wurde nicht gesendet, weil die Nummer oder die Nachricht ungültig ist.
Abgebrochen	Die Nachricht wurde abgebrochen.
Zustellung unbekannt	Der Versand wurde unterbrochen; ob die Nachricht den Anbieter erreicht hat, ist unbekannt. Um doppelten Versand zu vermeiden, wird nicht automatisch wiederholt.
Wegen Lizenz ausgesetzt	Die Nachricht wird zurückgehalten, weil die Lizenz das SMS-Recht verloren hat.

Bietet der Anbieter keine Zustellbestätigung an, kann der Datensatz im Status Akzeptiert oder Gesendet bleiben; das bedeutet nicht, dass die Nachricht nicht angekommen ist.

Verlauf und Aufbewahrungsdauer

• Der Versandverlauf von E-Mails und SMS wird fest 30 Tage aufbewahrt; ältere Datensätze werden automatisch gelöscht.
• Im Verlauf werden Telefonnummern maskiert angezeigt.
• In die Dienstprotokolle werden weder vollständige Telefonnummern noch Nachrichteninhalte oder Anmeldedaten des Anbieters geschrieben.

Wegen Lizenz ausgesetzte SMS

Verliert die Lizenz das SMS-Recht (etwa weil die Lizenz abläuft oder die Kulanzfrist endet), werden die noch nicht gesendeten SMS in der Warteschlange in den Status Wegen Lizenz ausgesetzt versetzt. Kommt das Recht zurück, werden diese Nachrichten nicht automatisch gesendet; um den gesammelten Versand alter Alarmnachrichten zu verhindern, entscheidet der Administrator.

1. Installieren Sie die neue Lizenzdatei mit dem Installationswerkzeug.
2. Starten Sie den Benachrichtigungsdienst neu. Ein geschlossener SMS-Kanal öffnet sich nicht automatisch, wenn die Lizenz zurückkommt.
3. Öffnen Sie mit einem Benutzer der Gruppe SystemAdmin den Bildschirm Archiv > Benachrichtigungsverlauf.
4. Wählen Sie die ausgesetzten SMS, die tatsächlich gesendet werden sollen, einzeln aus (höchstens 100).
5. Klicken Sie auf Ausgewählte SMS erneut einreihen oder Ausgewählte SMS abbrechen und prüfen Sie die Anzahl im Bestätigungsfenster.

• Das erneute Einreihen erfordert ein aktuelles, gültiges SMS-Recht; der Versand wird vom Anbieter berechnet.
• Abbrechen ist auch ohne Lizenz oder mit abgelaufener Lizenz möglich.
• Nachrichten mit unklarer Zustellung, vom Anbieter akzeptierte Nachrichten und Nachrichten ohne verbleibende Versuche können nicht erneut eingereiht werden.
• Wurde der Datensatz zwischenzeitlich durch einen anderen Vorgang geändert, wird der Vorgang abgelehnt; aktualisieren Sie die Liste und wählen Sie erneut aus.
• Der Verlauf und die Datensätze früherer Versuche werden nicht gelöscht.

Sicherung

Die SMS-Einstellungen sind in der Konfigurationssicherung als Modul SMS-Einstellungen enthalten (siehe Sicherung und Wiederherstellung). Die Anmeldedaten des Anbieters sind in der Sicherung enthalten; bewahren Sie das Sicherungspaket wie vertrauliche Daten auf. Senden Sie nach der Wiederherstellung in einer anderen Installation eine Test-SMS; schlägt sie fehl, geben Sie die Anbieterdaten erneut ein.

Fehlerbehebung

Symptom	Mögliche Ursache und Lösung
SMS-Einstellungen konnten nicht geladen werden.	Prüfen Sie Ihre Sitzung und Ihre Berechtigung; laden Sie die Seite neu.
SMS-Einstellungen konnten nicht gespeichert werden.	Prüfen Sie die Pflichtfelder des Anbieters und die Grenzen der Felder.
Test-SMS konnte nicht eingereiht werden.	Prüfen Sie, ob der Benachrichtigungsdienst läuft und ob die Lizenz das SMS-Recht enthält.
Der Benachrichtigungsdienst ist nicht erreichbar. (3703)	Starten Sie den Benachrichtigungsdienst oder starten Sie ihn neu.
Das Datenbankschema des Benachrichtigungsdienstes ist nicht aktuell. (3706)	Wenden Sie sich an Ihren Systemintegrator.
SMS im Status Validierung fehlgeschlagen	Prüfen Sie die Telefonnummer des Benutzers.
SMS im Status Fehlgeschlagen	Prüfen Sie die Spalte Fehlercode, die Anmeldedaten des Anbieters, die Genehmigung des Absendertitels und IP-Beschränkungen im Anbieterportal.
Es entsteht überhaupt keine SMS	Prüfen Sie den Benachrichtigungstyp der Benachrichtigung, ob der Benachrichtigung Benutzer hinzugefügt wurden und die Telefonnummer des Benutzers. Überschreitet die Nachricht die Grenze Maximale Segmente, wird sie gar nicht erst in die Warteschlange aufgenommen.