Nachfolgend finden Sie eine detaillierte Beschreibung aller Funktionen, die die SMSEagle-Software bietet. Die Reihenfolge der Beschreibungen entspricht der der SMSEagle Web-GUI.

SMS verfassen

Hier zeigen wir die verschiedenen Möglichkeiten, eine SMS von Ihrem Gerät zu senden.

Screenshot der Standardansicht von Compose SMS

In Compose SMS können Benutzer:

• SMS an Kontakte aus dem Telefonbuch senden, manuell eingeben oder aus einer Datei importieren

• Beim Import aus einer Datei kann jede Spalte als Platzhalter in der Nachricht verwendet werden. Beim Senden wird der Platzhalter durch einen eindeutigen Wert für jede importierte Zeile aus der CSV-Datei ersetzt. Dadurch können Sie jedem Empfänger eine personalisierte Nachricht senden.

• Sendedatum auf jetzt, zu einem bestimmten Datum und einer bestimmten Uhrzeit, nach einer Verzögerung, zwischen ausgewählten Stunden oder mit hoher Priorität einstellen

• Gültigkeitsdauer der SMS festlegen

• Einen Nachrichtentyp auswählen: normale SMS, Flash-SMS, MMS, USSD-Code, E-Mail, Signal oder WhatsApp

• Eine Nachrichtenvorlage festlegen, die gespeichert und zu einem anderen Zeitpunkt verwendet werden kann

• Als Unicode senden (für die Verwendung von Sonderzeichen)

• Nachricht senden oder Senden und Wiederholen (Fenster bleibt geöffnet, sodass Änderungen an der nächsten Nachricht möglich sind)

SMS aus CSV importieren und Platzhalter verwenden

Die SMSEagle-Software ermöglicht es Ihnen, SMS-Text aus einer CSV-Datei zu importieren und (optional) spezielle Platzhalter im Nachrichtentext zu verwenden. Platzhalter sind spezielle Felder, die für jede Nachricht durch eindeutige Werte ersetzt werden. Zunächst wird eine .csv-Datei wie im folgenden Beispiel benötigt. Spalten können nach Bedarf hinzugefügt und benannt werden.

Beim Verfassen einer SMS mit einer .csv-Datei als Quelle wird jede Spalte in der hochgeladenen .csv-Datei zu einem Platzhalter, der die Informationen aus Ihrer Datei einfügt. Platzhalter können dem Nachrichtentext hinzugefügt werden, indem Sie auf den Spaltennamen im Bereich „Select field“ klicken, wie unten dargestellt.

Screenshot von „Compose SMS“ mit importierter .csv-Datei.

Anrufe (Voice-Funktion)

Nur verfügbar für Benutzer, die das VOICE-Add-on für ihr SMSEagle-Gerät erworben haben.

Die Anruf-Funktion ermöglicht das Tätigen von Weckanrufen (nur Klingeln), Text-to-Speech-Anrufen und Audiodatei-Anrufen an eine einzelne Telefonnummer oder eine Gruppe von Empfängern. Diese Funktion eignet sich ideal für die Übermittlung dringender Nachrichten oder Ankündigungen, wie z. B. Alarme, Notfallbenachrichtigungen oder andere zeitkritische Informationen. Eine Anrufanfrage kann über die SMSEagle Web-GUI oder API erstellt werden.

Weckanrufe (nur Klingeln)

Ein Weckanruf ist ein reiner Klingelanruf, der verwendet werden kann, um die Aufmerksamkeit eines Empfängers zu erregen. Diese Funktion ermöglicht es beispielsweise, jemanden nachts zu wecken, um die Aufmerksamkeit auf eine SMS mit einem kritischen Alarm zu lenken. Wenn ein Weckanruf ausgeführt wird, klingelt das SMSEagle-Gerät für eine festgelegte Anzahl von Sekunden bei einer angegebenen Telefonnummer oder einem Telefonbucheintrag.

Text-to-Speech (TTS)-Anrufe

Aufgrund technischer Einschränkungen nur auf NXS-Hardware Rev.4 und MHD-8100-4G-Geräten verfügbar.

Es gibt 3 Modi der Text-to-Speech-Funktion:

• Text to Speech Simple: schnellere Methode, unterstützt aber nur die englische Sprache.

• Text to Speech Advanced: unterstützt mehrere Sprachen, bietet eine bessere Sprachqualität, ist jedoch bei längeren Texten langsamer. Funktioniert offline. Die Wiedergabegeschwindigkeit kann angepasst werden, um zu steuern, wie schnell die Nachricht vorgelesen wird.

• Elevenlabs TTS: mehrere Sprachen, hervorragende, natürlich klingende Stimmen. Erfordert ein Elevenlabs-Konto und Internetzugang für die Text-to-Speech-Umwandlung

Audiodatei-Anrufe

Die Funktion Audio File Call ermöglicht es Ihnen, Sprachanrufe mit aufgenommenen Audiodateien (Wave) durchzuführen. Diese Funktion eignet sich ideal für alle, die eine persönliche Note für individuelle Ankündigungen oder spezifische Alarme bevorzugen. Sie können eine vordefinierte Datei im Menü Calls > Audio files hochladen. Die Datei muss folgende Anforderungen erfüllen: Wave-Dateiformat, 8 kHz oder 16 kHz, mono, 16-Bit PCM.

Screenshot mit Beispielen aus dem Menü „Calls“

Screenshot des Fensters New Call

Im Fenster New call können Sie Folgendes einstellen:

• Kontakt oder Gruppe aus dem Telefonbuch oder manuelle Eingabe

• Auswahl, ob ein Anruf sofort, zu einem bestimmten Datum/einer bestimmten Uhrzeit oder innerhalb eines Zeitraums erfolgen soll

• Von welchem Modem aus angerufen werden soll (bei Verwendung eines Geräts mit mehreren Modems)

• Anrufpriorität von 0-5 festlegen

• Anruftyp auswählen: Ring only, Text to Speech Simple, Text to Speech Advanced, Audio File, ElevenLabs TTS

• Für Text to Speech Advanced können Sie Sprache und Stimmmodell auswählen

• Für Audio File können Sie eine vorhandene Datei auswählen oder eine Datei von Ihrem Computer hochladen

• Nachricht eingeben, wenn der Anruftyp Text-to-Speech ausgewählt ist. Bei „Text-to-Speech Simple“ ist die Länge der Textnachricht auf 950 Zeichen begrenzt.

Eingehende Anrufe

SMSEagle unterstützt die Verarbeitung eingehender Sprachanrufe. Eingehende Anrufe können:

• In der Anrufhistorie des Geräts protokolliert werden

• Als Auslöser für Webhooks verwendet werden

• Global über das Menü Settings > Maintenance konfiguriert werden, wo Sie das Standardverhalten des Geräts festlegen können: eingehende Anrufe immer ablehnen, annehmen oder ignorieren.

Wiederholungsversuche

Wenn ein Anrufversuch fehlschlägt, wird er automatisch bis zu 2 weitere Male wiederholt.

TTS-Offline-Sprachmodelle

Die Funktion Text to Speech Advanced verfügt über 2 vorinstallierte Sprachmodelle: Englisch, Deutsch. Sie können zusätzliche Stimmmodelle über das Menü Calls > TTS voice models hochladen. Die Stimmmodell-Bibliothek enthält derzeit 36 Sprachen und für einige Sprachen mehrere Stimmen. Auf der Seite Voice Models können Sie verschiedene Stimmmodelle vergleichen und sich Sprachbeispiele anhören.

Neue Stimmmodelle können halbautomatisch (das Gerät lädt Dateien aus dem Repository auf github.com herunter) oder manuell (die Dateien müssen auf den Computer heruntergeladen und über das Dialogfenster hochgeladen werden) hinzugefügt werden. Sobald das Stimmmodell hochgeladen ist, funktioniert die TTS-Umwandlung offline.

Screenshot aus dem Menü Calls>TTS Voice models

TTS Online Voice models

Online-Sprachmodelle verwenden die ElevenLabs-API zur Text-to-Speech-Umwandlung, um hervorragende, natürlich klingende Stimmen zu liefern. Sie benötigen jedoch ein ElevenLabs-Konto, um diese Funktion nutzen zu können. Ihr SMSEagle-Gerät muss außerdem mit dem Internet verbunden sein, damit diese Funktion funktioniert.

Screenshot aus dem Menü Calls>TTS Online Voice models

Um ElevenLabs-Sprachanrufe in SMSEagle zu nutzen, müssen Sie einen ElevenLabs-API-Schlüssel generieren (unter dem Tab Developers > API Keys). SMSEagle benötigt die folgenden ElevenLabs-API-Berechtigungen: *Text to Speech: Access Voices: Read. *

Nachdem Sie diese ausgewählt haben, speichern Sie die Einstellungen und geben Sie den ElevenLabs-API-Schlüssel in der SMSEagle Web-GUI ein (Menü Calls > TTS Online voice models > ElevenLabs API key).

Bereinigung temporärer Dateien

Die Funktion „Temporary voice files cleanup“ hilft dabei, Speicherplatz auf dem SMSEagle-Gerät zu sparen, indem nicht mehr benötigte temporäre Dateien, die während der Text-to-Speech(TTS)-Verarbeitung erstellt wurden, automatisch entfernt werden.

In der Standardkonfiguration läuft der Vorgang jeden Montag um 02:00 Uhr. Bei Systemen, die eine große Anzahl von Anrufen generieren, wird empfohlen, die Bereinigungshäufigkeit zu erhöhen, um übermäßige Festplattennutzung zu vermeiden und einen stabilen Gerätebetrieb sicherzustellen. Dateien, die noch für geplante oder ausstehende Anrufe benötigt werden, werden nicht entfernt und bleiben vollständig geschützt.

Screenshot aus dem Menü Calls>Temporary files cleanup

Folders

Folders enthalten Ihre SMS-/MMS-Nachrichten. Ordner sind übersichtlich in 5 Kategorien gruppiert:

• Inbox

• Outbox

• Sent Items

• Inbox rules

• Trash

Die Ansicht der Unterhaltungen kann entweder vom Typ „Balloons“ (Konversation wie auf einem Smartphone) oder „Table“ (tabellarische Ansicht) sein. Der Ansichtstyp kann im Menü Settings > Application geändert werden.

Ansichtstyp „Balloons“:

Ansichtstyp „Table“:

MMS

Um einen MMS-Anhang anzuzeigen, müssen Sie in der Posteingangsnachricht auf „show MMS attachment“ klicken.

Status gesendeter Elemente

Der Status einer gesendeten Nachricht ist unter Folders>Sent Items>in der ausgewählten Nachricht ersichtlich. Es gibt 2 Stellen, an denen der Sendestatus angezeigt wird: das Status-Symbol in der rechten unteren Ecke jeder Nachricht und der Statustext in den Nachrichtendetails (Schaltfläche „Show Details“).

Screenshot mit Beispielen aus Folders>Sent Items>message example

Es gibt 3 verschiedene Symbole, die den Sendestatus anzeigen:

• Sendefehler

• Nachricht gesendet

• Nachricht zugestellt (nur verfügbar, wenn Delivery Reports aktiviert sind)

Inbox rules

Sie können Regeln erstellen, um eingehende Nachrichten automatisch in Ihre benutzerdefinierten Ordner (My Folders) zu verschieben. Sie können die Aktivierungsreihenfolge der Regeln anpassen, indem Sie sie nach oben oder unten ziehen. Um eine Regel zu verschieben, verwenden Sie die schwarzen Punkte neben ihrer ID. Regeln, die weiter oben in der Liste stehen, haben eine höhere Priorität und werden zuerst geprüft.

Screenshot aus „Inbox > Inbox rules“

*Screenshot von „Add new inbox rule“ *

Beim Hinzufügen einer neuen Regel können Sie Folgendes festlegen:

• Regelname

• Was die Nachricht enthält

• Was die Absendernummer enthält

• Von welchem Modem die Nachricht empfangen wird

• In welchen benutzerdefinierten Ordner die Nachricht verschoben werden soll

Cleanup Folders

Mit dieser Funktion können Sie Regeln hinzufügen, wann Nachrichten und Protokolle in ausgewählten Ordnern automatisch bereinigt werden sollen.

Screenshot mit Beispiel aus dem Bildschirm Cleanup folders

Screenshot von Add or edit purging rule

Beim Hinzufügen oder Bearbeiten einer Bereinigungsregel können Sie Folgendes festlegen:

• Regelname

• Bereinigungsintervall (täglich, wöchentlich, monatlich oder jährlich)

• Uhrzeit festlegen

• Ordner auswählen (Inbox, Outbox, Sent Items, Calls done, Calls queued, Signal inbox, Signal outbox, Signal sent, WhatsApp inbox, WhatsApp outbox, WhatsApp sent und Emails)

• Zeitspanne der Nachrichten festlegen

• Löschen von Modem-Protokolldateien auswählen

Telefonbuch

Die Web-GUI des SMSEagle-Geräts verfügt über ein Telefonbuch zur Verwaltung von Kontakten, Gruppen und Schichten. Jeder Benutzer kann private und öffentliche Kontakte anlegen und Kontakte in privaten und öffentlichen Gruppen zusammenfassen. Kontakte können optional auch Arbeitsschichten zugewiesen werden. Kontakte und Gruppen aus dem Telefonbuch ermöglichen Benutzern ein effizientes Versenden von Nachrichten.

Telefonbuch-Kontakte

Nachfolgend zeigen wir die Hauptansicht des Telefonbuchs, in der der Benutzer seine Kontakte verwaltet.

Screenshot der Standardansicht des Telefonbuchs

In der Telefonbuch-Kontaktverwaltung können Benutzer:

• Kontakte über die Web-GUI hinzufügen/bearbeiten/löschen

• Kontakte aus einer CSV-Datei importieren

• Kontakte auf öffentliche oder private Sichtbarkeit setzen

• Kontakte zu Gruppen hinzufügen

• Kontakte zu Arbeitsschichten hinzufügen

• Urlaubsmodus einstellen (Zeitraum oder dauerhaft)

• Eine Nachricht an einen Kontakt senden

• Ausgewählten Kontakt oder alle Kontakte exportieren

• Nachrichtenverlauf eines Kontakts anzeigen

Screenshot des Fensters Kontakt bearbeiten/hinzufügen

Im Fenster Kontakt bearbeiten/hinzufügen des Telefonbuchs können Benutzer:

• Kontaktname und Telefonnummer festlegen

• Auswählen, ob der Kontakt Privat/Öffentlich ist

• Dem Kontakt ein ausgewähltes Modem zuweisen oder die Standardmodemauswahl beibehalten (gemäß globalen Einstellungen)

• Kontakt zu einer Gruppe hinzufügen

• Kontakt zu einer Arbeitsschicht hinzufügen

• Urlaubsmodus aktivieren/deaktivieren (bei aktiviertem Urlaubsmodus werden keine Nachrichten gesendet)

Screenshot des CSV-Datei-Imports

Im Fenster CSV-Datei importieren können Benutzer:

• Wählen Sie eine CSV-Datei zum Hochladen aus

• Legen Sie die hochgeladenen Kontakte als Public Contact fest

• Legen Sie die hochgeladenen Kontakte als Public Group fest

• Wählen Sie aus, zu welcher Gruppe die hochgeladenen Kontakte hinzugefügt werden sollen

• Wählen Sie aus, ob Telefonnummern, die bereits im Phonebook vorhanden sind, übersprungen werden sollen

Phonebook Groups

Screenshot aus den Phonebook Groups

In der Phonebook Group Management-Ansicht können Benutzer:

• Gruppen hinzufügen/bearbeiten/löschen

• Gruppen auf öffentliche oder private Sichtbarkeit einstellen

• Gruppeninhalt anzeigen (Kontakte, die zur Gruppe gehören)

• Nachricht an eine Gruppe senden

• Ausgewählte Gruppe exportieren oder alle exportieren

• Kontakte direkt innerhalb der Gruppenansicht hinzufügen oder entfernen (ohne zu den einzelnen Kontakteinstellungen navigieren zu müssen)

• Kontakte aus den Suchergebnissen entfernen

Public and Private Contacts/Groups Public Contacts/Groups sind für alle Benutzer auf dem Gerät sichtbar. Ein Public Contact/Group kann nur vom Besitzer (dem Benutzer, der den Kontakt/die Gruppe erstellt hat) bearbeitet werden. Private Contacts/Groups sind nur für einen einzelnen Benutzer (den Besitzer) sichtbar.

Phonebook Escalation Groups

Eine Escalation Group ist eine spezielle Version einer Phonebook Group. Wenn eine Gruppe als „Escalation Group“ festgelegt ist, wird eine einzelne an die Gruppe gesendete Nachricht an die Gruppenmitglieder eskaliert. Die Nachricht wird in einem festgelegten Zeitintervall eskaliert, bis ein festgelegtes STOP-Wort empfangen wird.

Screenshot aus der Manage Group-Ansicht

Sie können die Eskalationsreihenfolge ändern, indem Sie Kontakte nach oben oder unten ziehen.

Screenshot aus Manage Groups mit eingestellter Eskalation

Die aktuelle Eskalationswarteschlange kann über das Menü Folders>Outbox>Escalation queues angezeigt und verwaltet werden

Screenshot mit Beispiel aus dem Fenster Folders>Outbox>Escalation queues

Phonebook Working Shifts

Die Shift-Management-Funktion ermöglicht es, Phonebook-Kontakten die Arbeit in Schichten zuzuweisen. Wenn ein Kontakt einer Working Shift zugewiesen ist, prüft das Gerät vor dem Senden einer Nachricht, ob der Kontakt gerade Dienst hat. Ist der Kontakt nicht im Dienst, wird die Nachricht übersprungen oder auf den Beginn der nächsten Schicht verschoben. Um Working Shifts zu verwenden, definieren Sie hier Schichten und fügen Sie den Kontakt in den Kontaktdetails einer Schicht hinzu.

Screenshot der Schichtverwaltung im Phonebook

Benutzer

Die Funktion Users ermöglicht die Verwaltung des Zugriffs auf Ihr Gerät. Sie erlaubt das Hinzufügen, Bearbeiten und Entfernen von Benutzern sowie das Festlegen ihrer Berechtigungen. Es gibt zwei Zugriffsebenen für einen Benutzer:

• Benutzerrolle „Administrator“:

Ermöglicht vollen Zugriff und volle Kontrolle über das Gerät, einschließlich Einstellungen und Benutzerverwaltung.

• Benutzerrolle „User“:

Beschränkt den Zugriff auf die Module Compose, Folders, Phonebook und Reporting.

Screenshot des Fensters Edit/Add User

Multi-User-Funktionen

Wie im Kapitel „Users“ beschrieben, ermöglicht die SMSEagle-Software das Anlegen mehrerer Benutzer mit unterschiedlichen Zugriffsebenen (Administrator oder User). Diese Benutzer können gleichzeitig über Web-GUI oder API auf das Gerät zugreifen. Im Multi-User-Szenario stehen folgende Funktionen zur Verfügung:

• Mehrere Benutzer können gleichzeitig über Web-GUI oder API auf das Gerät zugreifen

• Jeder Benutzer kann private oder öffentliche (gemeinsam genutzte) Phonebook-Kontakte und -Gruppen anlegen (Details siehe Kapitel „Phonebook“)

• Der Administrator kann einen Benutzer mit der Rolle „User“ so einschränken, dass er nur ausgewählte Modems zum Versenden von Nachrichten nutzen darf (Details siehe Kapitel „Users“)

• Benutzer mit der Rolle „User“ verfügen über einen eigenen privaten Ordner für gesendete Nachrichten (sie können keine von anderen Benutzern gesendeten Nachrichten sehen). Benutzer mit der Rolle „Administrator“ können Nachrichten aller Benutzer sehen.

• Der Inhalt des Inbox-Ordners (eingehende Nachrichten) kann sichtbar sein: für alle/nur für die Rolle „Administrator“/nur für Modems, die einem Benutzer zugewiesen sind (Details siehe Kapitel „Application settings“)

Benutzereinstellungen

Über das Menü User Settings kann jeder Benutzer seine persönlichen Präferenzen, Authentifizierungsoptionen und das Verhalten der Oberfläche innerhalb der SMSEagle Web-UI verwalten. Diese Einstellungen gelten nur für den aktuell angemeldeten Benutzer und wirken sich nicht auf andere Konten aus.

Das Menü ist in drei Tabs unterteilt:

• Personal data

• Password

• MFA

Personal Data

Der Tab Personal data dient zur Konfiguration der Benutzeridentitätsdaten, der Nachrichtenpräferenzen und des Verhaltens der Oberfläche. Verfügbare Einstellungen:

• Language: Wählt die Anzeigesprache der SMSEagle-Weboberfläche für den aktuellen Benutzer aus.

• Name: Legt den Anzeigenamen des Benutzers fest. Dieser Name kann in internen Ansichten und im Zusammenhang mit Nachrichten verwendet werden.

• Login: Zeigt den Login-Namen des Benutzers an. Dieses Feld ist rein informativ und kann nicht geändert werden.

• Telephone Number: Gibt die Telefonnummer des Benutzers an. Die Nummer wird für die Passwort-Erinnerung verwendet.

• Signature: Ermöglicht dem Benutzer, eine persönliche Nachrichtensignatur festzulegen:

  • Signature Off: Es wird keine Signatur hinzugefügt

  • Signature On: Der eingegebene Text wird an Nachrichten angehängt, die über das Menü Compose gesendet werden.

• Standard-Betreff für E-Mails im Menü „Compose“: Legt eine Standard-Betreffzeile fest, die beim Senden von Nachrichten über das Menü „Compose“ automatisch vorausgefüllt wird.

• Standard-SMS-Kodierung im Menü „Compose“: Legt die bevorzugte SMS-Kodierungsmethode fest, die im Menü „Compose“ eingestellt wird. Verfügbare Optionen: Standard, Unicode oder Automatic.

• Benachrichtigungston bei eingehender SMS abspielen: Aktiviert oder deaktiviert einen akustischen Hinweis, wenn eine neue SMS-Nachricht im Webinterface empfangen wird.

• Konversationssortierung: Bestimmt die Reihenfolge, in der Konversationen angezeigt werden

• Konversationsansichtstyp: Legt fest, wie Nachrichtenverläufe visuell dargestellt werden (z. B. als Sprechblasen-/Chat-Ansicht).

• Data per Page: Legt die Anzahl der pro Seite angezeigten Einträge in Nachrichtenlisten und im Telefonbuch fest. Dies wirkt sich auf die Seitenaufteilung in der gesamten Oberfläche aus.

Password

Im Tab Password kann der Benutzer sein Kontopasswort ändern.

Multi-Faktor-Authentifizierung (MFA)

Multifaktor-Authentifizierung (MFA) fügt dem Anmeldevorgang eine zusätzliche Schutzebene hinzu. Beim Zugriff auf Web-GUI-Konten geben Benutzer einen Benutzernamen und ein Passwort sowie eine zusätzliche Identitätsprüfung an, wie z. B. einen per SMS erhaltenen Code oder ein Token aus einer Authenticator-App.

MFA über User Settings aktivieren

MFA kann von jedem Benutzer im Menü User Settings > Tab MFA aktiviert werden.

Screenshot aus User Settings > MFA.

Sie können die Authentifizierungsmethode wählen: SMS oder Authenticator App (wie Google Authenticator, MS Authenticator, Authy, FreeOTP, Aegis usw.)

Wenn SMS als Authentifizierungsmethode ausgewählt ist, wird ein Bestätigungscode per SMS (Text) an die im Tab Personal data angegebene Nummer gesendet. Der SMS-OTP-Code muss zum Abschluss des Vorgangs eingegeben werden.

Wenn Authenticator app ausgewählt ist, muss ein Benutzerpasswort eingegeben werden, um einen QR-Code für die Authenticator-App anzuzeigen. Der QR-Code muss in der App gescannt werden, und anschließend muss das OTP aus der App zum Abschluss des Vorgangs in der Web-GUI eingegeben werden.

Screenshot aus User Settings > MFA. Anforderung eines Bestätigungscodes.

Benutzeranmeldung mit MFA

Sobald MFA aktiviert ist, muss der Benutzer bei jeder Anmeldung an der Web-GUI eine Zwei-Faktor-Authentifizierung (Benutzer und Passwort + einmaliges SMS-Token) angeben. Das einmalige SMS-Token ist 10 Minuten lang gültig.

Screenshot des Anmeldevorgangs mit aktivierter MFA.

Wiederherstellungscode

Wenn ein Benutzer aus irgendeinem Grund keine Textnachricht empfangen kann oder keinen Zugriff auf sein Telefon hat, kann ein Wiederherstellungscode verwendet werden. Der Wiederherstellungscode befindet sich im Tab User Settings > MFA. Denken Sie daran, den einmalig verwendbaren Wiederherstellungscode an einem sicheren Ort zu speichern. Der Wiederherstellungscode wird nach der Verwendung neu erstellt.

Screenshot aus User Settings > MFA. Der Wiederherstellungscode wird nach Eingabe des Passworts angezeigt

MFA-Aktivierung durch Administrator

MFA kann auch von einer Administrator-Rolle für ausgewählte Benutzer aktiviert werden. Dies erfolgt im Menü Users > Edit User.

Screenshot von Edit/Add User

Berichtsmodul

Das Reporting-Modul ist eine Erweiterung der grundlegenden Suchfunktion. Das Modul ermöglicht es Benutzern, Nachrichten aus den Ordnern Inbox/Sent items anhand benutzerdefinierter Kriterien zu filtern und die gefilterten Nachrichten anzuzeigen. Die gefilterte Nachrichtenliste kann als PDF- oder CSV-Datei exportiert werden.

Screenshot des Reporting-Moduls

Statistikansicht

Das Reporting-Modul ermöglicht auch die Anzeige täglicher Statistiken der gesendeten/empfangenen Nachrichten. Die Statistikansicht zeigt die Anzahl der Nachrichten pro Tag sowie die Absender-/Empfängernummer an.

Screenshot der Statistikansicht im Reporting-Modul

Periodische Berichte/Statistiken

Sie können wählen, automatische Berichte täglich, wöchentlich oder monatlich zu senden. Die E-Mails werden genau zum Ende des gewählten Intervalls versendet und enthalten alle Daten aus diesem Zeitraum (von 00:00 Uhr des ersten Tages bis 23:59 Uhr des letzten Tages bzw. innerhalb eines Tages bei der täglichen Option).

Wichtig Denken Sie bei periodischen Berichten/Statistiken daran, dass Sie die SMTP-Einstellungen zum Versenden von E-Mails im Menü ‚Emails‘ > ‚SMTP Configuration‘ konfigurieren und diese dem ‚Reporting module‘ zuweisen müssen.

Screenshot der periodischen Berichte im Reporting-Modul

Netzwerküberwachung

SMSEagle ist mit Funktionen zur Netzwerküberwachung ausgestattet. Mit diesen Funktionen können Sie jedes Gerät oder jeden Dienst überwachen, der das ICMP-, TCP-, UDP- oder SNMP-Protokoll verwendet. Das SMSEagle Network Monitoring-Plugin überprüft nacheinander die Verfügbarkeit der definierten Hosts/Dienste in der Network Monitoring-Funktion und sendet einen definierten SMS-Alarm, wenn ein Host/Dienst nicht verfügbar ist/wieder verfügbar wird oder wenn der SNMP-Rückgabewert die erforderlichen Kriterien erreicht. Nachfolgend finden Sie einen kurzen Überblick über die Fähigkeiten des Plugins.

Statuskontrolle aller Ihrer definierten Aufgaben

• eine Übersicht der Einstellungen für alle Ihre Aufgaben anzeigen

• prüfen, welcher Server/Dienst derzeit nicht verfügbar ist

• sehen, wann ein bestimmter Server/Dienst zuletzt ausgefallen ist (letzte Ausfallzeit)

• prüfen, was bei der letzten Ausfallzeit passiert ist (Server-/Dienst-Antwort einsehen)

• Ihre Aufgaben bearbeiten/löschen

• Aufgaben bei Bedarf deaktivieren (z. B. bei Maschinen-Upgrades)

Festlegen, was Sie in jeder Aufgabe überwachen möchten

• Wählen Sie einen Namen für die Aufgabe

• Legen Sie eine übergeordnete Aufgabe (Parent Task) fest. Wenn eine übergeordnete Aufgabe definiert ist, überwacht der Network Monitor den Zustand der untergeordneten Aufgabe nur, wenn die übergeordnete Aufgabe fehlerfrei ist

• Geben Sie einen Host (IP-Adresse oder Hostname) ein

• Wählen Sie ICMP (Ping), um einen Server über das ICMP-Protokoll zu überwachen

• oder PORT (TCP/UDP), um Ihren Dienst auf einem ausgewählten Port zu überwachen (SMSEagle prüft, ob der Port geöffnet ist)

• oder SNMP, um Objekte über das SNMP-Protokoll zu überwachen (unterstützte Rückgabetypen: numerisch, string)

• erhöhen Sie den Standard-Timeout-Wert für ausgelastete Server (standardmäßig auf 30 Sekunden eingestellt)

• testen Sie die Verbindung zum Server

Definieren Sie einen Zeitplan

• Wählen Sie, ob die Aufgabe immer aktiviert sein soll…

• …oder deaktivieren Sie sie zu ausgewählten Zeiten (nachts, während geplanter Neustarts eines Rechners, während ressourcenintensiver Backups usw.)

• Geben Sie eine Telefonnummer ein oder wählen Sie eine Benutzergruppe, an die Ihr SMS-Alarm gesendet werden soll

• Wählen Sie, wann der SMS-Alarm gesendet werden soll (wenn Host/Dienst ausfällt, wenn Host/Dienst nach einem Ausfall wieder verfügbar ist)

• Wählen Sie, ob der SMS-Alarm einmalig gesendet oder alle X Minuten wiederholt werden soll

Definieren Sie eine SMS-Alarmnachricht

Definieren Sie Ihre SMS-Nachrichten für den Fall, dass ein Host oder Dienst nicht verfügbar wird bzw. wieder verfügbar ist. Wählen Sie Feld-Platzhalter für Ihren SMS-Text:

• {TASKNAME} – fügt einen Aufgabennamen in den SMS-Text ein

• {HOST} – Hostname oder IP-Adresse

• {RESPONSE} – empfangene Nachricht (falls keine Antwort von Server/Dienst erfolgt)

• {TIMESTAMP} – Zeitstempel eines Fehlers

SMS-Alarme empfangen

• lassen Sie sich benachrichtigen, wenn Ihre Dienste/Server ausfallen (oder nach einem Ausfall wieder verfügbar sind)

• geben Sie sich selbst die Möglichkeit, schnell zu reagieren

Sprachanruf

Auf eine SMS-Nachricht kann optional ein Wecksignal (Wake-up Call) oder ein Text-to-Speech-Anruf folgen. Dies kann in der Regeldefinition aktiviert werden. Diese Funktion erfordert ein Gerät mit einem aktiven Voice-Call-Add-on.

Netzwerk-Überwachungssonden

Die Netzwerküberwachungsfunktion in SMSEagle-Geräten ermöglicht es Ihnen, die Verfügbarkeit und den Zustand von Netzwerkgeräten, Diensten und Industriesystemen kontinuierlich zu überwachen. Jede Überwachungsaufgabe basiert auf einem Testtyp, der definiert, wie das Ziel geprüft wird. Wenn ein Problem erkannt wird, kann SMSEagle sofort SMS-Benachrichtigungen (und optional Sprachanrufe) senden, um eine schnelle Reaktion auf Vorfälle zu gewährleisten.

ICMP (Ping)

Der ICMP (Ping) überprüft die grundlegende Netzwerkerreichbarkeit eines Hosts durch das Senden von ICMP-Echo-Anfragen.

Verfügbare Parameter:

• Host (IP oder Hostname)

• Anzahl der Anfragen

• Connect Timeout

Typische Anwendungsfälle:

• Prüfen, ob ein Server, Router, eine Firewall oder ein Netzwerkgerät online ist

• Erkennen eines vollständigen Verbindungsverlusts oder Geräteausfalls

TCP Port

Die TCP-Port-Sonde prüft, ob ein bestimmter TCP-Dienst erreichbar ist, indem versucht wird, eine TCP-Verbindung zu einem definierten Port aufzubauen.

Verfügbare Parameter:

• Host: IP-Adresse oder Hostname

• Portnummer

• Connect Timeout

Typische Anwendungsfälle:

• Überwachung von Diensten wie HTTP/HTTPS, SMTP, SSH, FTP, Datenbanken oder Anwendungsservern

• Überprüfung nicht nur, ob ein Host online ist, sondern ob ein Dienst tatsächlich läuft

UDP Port

Die UDP-Port-Sonde überwacht die Verfügbarkeit von Diensten, die auf dem UDP-Protokoll basieren.

Verfügbare Parameter:

• Host: IP-Adresse oder Hostname

• Portnummer

• Connect Timeout

Typische Anwendungsfälle:

• DNS-Dienste

• Benutzerdefinierte oder proprietäre UDP-basierte Anwendungen

SNMP Probe

Die SNMP (Simple Network Management Protocol)-Sonde ermöglicht es SMSEagle, bestimmte von SNMP-fähigen Geräten bereitgestellte Parameter zu überwachen.

Verfügbare Parameter:

• Host: IP-Adresse oder Hostname

• Protokollversion: v1/v2

• Object ID

• Community

• Rückgabewerttyp (numerisch/String)

• Connect Timeout

• SMS sent when: definiert eine Bedingung, unter der ein SMS-Alarm ausgelöst werden soll (z. B. Wert ist gleich / ungleich / größer als / kleiner als ein definierter Schwellenwert)

Typische Anwendungsfälle:

• Überwachung von Routern, Switches, USV-Systemen, Servern und Netzwerkgeräten

• Verfolgung von Kennzahlen wie Temperatur, CPU-Auslastung, Speichernutzung, Verbindungsstatus oder Stromversorgungsbedingungen

Modbus TCP

Der Modbus-TCP-Sensor ist für die Überwachung von industriellen und OT-Umgebungen konzipiert. Damit können Sie Werte direkt von SPS, Sensoren, Controllern und anderen industriellen Geräten auslesen, die die Modbus-TCP/IP-Kommunikation unterstützen, und SMS-Alarme auslösen, wenn ein Registerwert definierte Kriterien erfüllt.

Verfügbare Parameter:

• Host: IP-Adresse oder Hostname des Modbus-Geräts

• Port: TCP-Port des Modbus-Servers (Standard: 502)

• Unit ID: Modbus-Geräte-Kennung (Unit Identifier)

• Function code: Typ des zu lesenden Registers: Read Coils (1), Read Discrete Inputs (2), Read Holding Registers (3) oder Read Input Registers (4)

• Register: Adresse des zu überwachenden Registers

• SMS sent when: definiert eine Bedingung, unter der ein SMS-Alarm ausgelöst werden soll (z. B. Wert ist gleich / ungleich / größer als / kleiner als ein definierter Schwellenwert)

Typische Anwendungsfälle:

• SPS,

• SCADA-Systeme

• Industrielle Sensoren und Automatisierungsgeräte

Überwachungsfrequenz

Überwachungsaufgaben werden im Parallelmodus ausgeführt. Die Software optimiert automatisch die Anzahl der parallelen Aufgaben und deren Häufigkeit unter Berücksichtigung der Leistung des Geräts und passt die Überwachungsperiode bei Bedarf an.

Sie können die Überwachungsperiode in den Network Monitor-Einstellungen manuell erhöhen/verringern:

Wenn der Wert der Überwachungsperiode zu klein ist (es gibt zu viele Überwachungsaufgaben, die parallel ausgeführt werden müssen), passt die Software den Wert an, um eine optimale Auslastung und Leistung Ihres Geräts sicherzustellen.

Reports

Dieser Tab ermöglicht es Ihnen, Berichte über Aufgabenfehler im Network Monitor für einen ausgewählten Zeitraum anzuzeigen.

Screenshot aus dem Fenster Network Monitor > Reports.

SNMP Traps

SNMP Trap ist ein weit verbreiteter Mechanismus zur Verwaltung und Überwachung von Geräteaktivitäten über das SNMP-Protokoll. Was den Trap einzigartig macht, ist, dass er sofort von einem Agenten ausgelöst wird, anstatt auf eine Statusanfrage von einer SNMP-Get-Abfrage zu warten.

Screenshot aus dem Fenster Network Monitor > SNMP TRAPS.

Screenshot aus dem Fenster Network Monitor > SNMP TRAPS Add or Edit.

SMSEagle kann als SNMP-Trap-Empfänger fungieren. Für jeden eingehenden Trap können Sie eine Regel definieren, die eine SMS-Nachricht auslöst.

• Optionen für den Abgleich des Trap-Inhalts:

  • Alle OIDs im Trap abgleichen — der Alarm wird ausgelöst, sobald ein Trap von einer definierten Quelle eintrifft

  • Einen bestimmten OID-Wert abgleichen — der Alarm wird nur ausgelöst, wenn ein Trap eine bestimmte OID enthält, die einem definierten Wert entspricht (gleich/ungleich/größer/kleiner als)

Der Abgleich eines einzelnen OID-Werts ist nützlich, wenn ein Gerät mehrere OIDs in einem Trap sendet und Sie nur auf eine bestimmte reagieren möchten.

SMSEagle unterstützt außerdem die Anzeige des Werts einer bestimmten OID aus einem eingehenden SNMP-Trap direkt in Alarmnachrichten. Sie können einen speziellen Platzhalter verwenden, um einen einzelnen OID-Wert im Nachrichteninhalt zu referenzieren, zum Beispiel: {TRAP:OID_IDENTIFIER}. Zur Laufzeit wird der Platzhalter durch den tatsächlichen im SNMP-Trap empfangenen Wert ersetzt.

Dies ist besonders nützlich, wenn ein einzelner Trap mehrere OIDs enthält, aber nur ein bestimmter Wert für den Alarmempfänger relevant ist.

E-Mails

Email to SMS

Die Email to SMS-Funktion ermöglicht es Ihnen, eine E-Mail in eine SMS-Nachricht umzuwandeln.

Grundlegende Verwendung

Wenn die Funktion aktiviert ist, wird eine an die folgende E-Mail-Adresse gesendete E-Mail:

PHONE_NUMBER@IP_ADDRESS_OF_SMSEAGLE wird in eine SMS-Nachricht umgewandelt.

Dabei gilt:

PHONE_NUMBER - ist die Zieltelefonnummer

IP_ADDRESS_OF_SMSEAGLE - ist die IP-Adresse Ihres Geräts.

Der Text der E-Mail ist der Text der SMS-Nachricht (optional können Sie den E-Mail-Betreff am Anfang der SMS-Nachricht anhängen).

Beispiel: Eine E-Mail-Nachricht, die an die Adresse 123456789@192.168.0.101 gesendet wird, wird in eine SMS-Nachricht umgewandelt und an die Telefonnummer 123456789 zugestellt.

An Benutzername/Gruppe senden

Eine an die E-Mail-Adresse gesendete E-Mail:

NAME_IN_PHONEBOOK@IP_ADDRESS_OF_SMSEAGLE wird in eine SMS-Nachricht umgewandelt und an einen Benutzer oder eine Benutzergruppe aus dem SMSEagle-Telefonbuch gesendet.

Dabei gilt:

NAME_IN_PHONEBOOK - ist ein Benutzername oder Gruppenname (muss eine öffentliche Gruppe sein) aus dem SMSEagle-Telefonbuch

IP_ADDRESS_OF_SMSEAGLE - ist die IP-Adresse Ihres Geräts.

Der Text der E-Mail ist der Text der SMS-Nachricht (optional können Sie den E-Mail-Betreff am Anfang der SMS-Nachricht anhängen).

Beispiel: Eine E-Mail-Nachricht, die an die Adresse db-admins@192.168.0.101 gesendet wird, wird in eine SMS-Nachricht umgewandelt und an alle Mitglieder der Gruppe db-admin zugestellt. Die Gruppe db-admin muss in Ihrem SMSEagle-Telefonbuch definiert sein.

An LDAP-Kontakte/Gruppen senden

Wenn Ihr Unternehmen LDAP (Active Directory oder OpenLDAP) für die Kontaktverwaltung verwendet, können Sie LDAP-Kontakte oder -Gruppen verwenden, um E-Mail in eine SMS-Textnachricht umzuwandeln.

Beispiel: Eine E-Mail-Nachricht, die an die Adresse myldap-admins1@192.168.0.101 gesendet wird, wird in eine SMS-Nachricht umgewandelt und an alle Mitglieder der Gruppe myldap-admins1 zugestellt. Die Gruppe myldap-admins1 muss in Ihrem LDAP-Verzeichnis definiert sein, und das LDAP-Plugin muss auf Ihrem SMSEagle-Gerät konfiguriert sein.

Sprachanruf

Einer aus einer E-Mail umgewandelten SMS-Nachricht kann optional ein Weckruf oder ein Text-to-Speech-Anruf folgen. Dies kann in der Regeldefinition aktiviert werden. Diese Funktion erfordert ein Gerät mit einem aktiven Voice-Call-Add-on.“

Verwendung von FQDN in der E-Mail-Adresse

Es ist auch möglich, einen vollqualifizierten Domainnamen (Fully Qualified Domain Name) in einer an die SMSEagle-Box gesendeten E-Mail-Adresse zu verwenden (z. B.: 123456789@mydomain.com). Weitere Details finden Sie in unserem FAQ-Artikel: How do I configure Email2SMS plugin to accept FQDN email addresses.

E-Mail-Betreff - zusätzliche Parameter (optional)

Es ist möglich, mithilfe des E-Mail-Betreffs zusätzliche Flags für eine einzelne umgewandelte Nachricht festzulegen. Derzeit sind folgende Flags verfügbar:

• date - Datum und Uhrzeit im Format YYYYmmDDHHMM (YYYY – Jahr, mm – Monat, DD – Tag, HH – Stunde, MM – Minute). Wenn dieser Parameter nicht null ist, wird die SMS zum angegebenen Datum und zur angegebenen Uhrzeit zum Versand geplant

• modemno - legt die Sendemodemnummer fest (nur für Geräte mit mehreren Modems verfügbar)

Wenn Sie eine E-Mail mit einem Betreff senden, der FLAG=VALUE enthält, wird das Flag für diese bestimmte Email2SMS-Nachricht gesetzt. Beispiel 1: Eine E-Mail-Nachricht mit einem Betreff, der modemno=2 enthält, wird in eine SMS-Nachricht umgewandelt und über Modem Nummer 2 gesendet. Beispiel 2: Eine E-Mail-Nachricht mit einem Betreff, der date=201801010005&modemno=2 enthält, wird in eine SMS-Nachricht umgewandelt und am 01.01.2018 um 00:05 Uhr über Modem Nummer 2 gesendet.

Funktionskonfiguration

Die Funktion „Email To SMS“ ermöglicht das Hinzufügen mehrerer Weiterleitungsregeln. Jede Regel kann vom Benutzer aktiviert oder deaktiviert werden.

Screenshot des Fensters Email To SMS > Rules

Screenshot von Email to SMS > Add new rule

• Sie können Ihrer Regel einen Namen geben

• Sie können die Weiterleitung auf „Always“ oder „For specified senders / when email contains“ einstellen

• Sie können festlegen, wann der Betreff und der Nachrichteninhalt bestimmte Begriffe enthalten (mit oder ohne Berücksichtigung der Groß-/Kleinschreibung)

• Sie können eine „Stop phrase“ definieren. Der Text ab dieser Stopp-Phrase wird (unter Beachtung der Groß-/Kleinschreibung) aus der Nachricht entfernt

• Sie können auswählen, ob nach dem Senden der SMS ein Anruf erfolgen soll (No/Ring only/TTS oder TTS advanced)*

• Sie können das Sprachmodell auswählen (Englisch oder Deutsch)*

• Sie können die Nachrichtenpriorität festlegen (0–9). Nachrichten mit höherer Priorität werden in der ausgehenden Warteschlange früher verarbeitet

*Anrufoptionen sind nur verfügbar, wenn die Voice (Calls)-Funktion für Ihr Gerät erworben wurde

Screenshot der Email to SMS-Einstellungen

• wenn Sie das Plugin verwenden möchten, setzen Sie ‚Email2SMS active‘ auf ‚Yes‘

• wenn Sie den Betreff einer E-Mail in die SMS-Nachricht aufnehmen möchten, setzen Sie die Einstellung ‚What to do with email subject‘ auf ‚Include in SMS‘. Der E-Mail-Betreff wird dann an den Anfang der SMS-Nachricht angehängt

• wenn Sie eine Benutzerauthentifizierung verwenden möchten, setzen Sie die Einstellung ‚What to do with email subject‘ auf ‚Use for authentication‘. Wenn die Benutzerauthentifizierung aktiviert ist, geben Sie im Betreff der E-Mail Ihren Login und Ihr Passwort in folgender Form an: login=john&pass=doe ODER geben Sie ein API-Zugriffstoken in folgender Form an: access_token=token

• wenn Sie nur den Betreff einer E-Mail in die SMS-Nachricht aufnehmen möchten, setzen Sie die Einstellung ‚What to do with email subject‘ auf ‚Send only subject without email body‘. Es wird dann nur der E-Mail-Betreff in die SMS-Nachricht eingefügt

• der Text einer E-Mail wird auf den Wert ‚Maximum number of characters‘ gekürzt. Die maximal zulässige Länge einer SMS-Nachricht beträgt 1300 Zeichen

• wenn Sie in der SMS-Nachricht spezielle nationale Zeichen (wie ąäàöß我) einbeziehen möchten, setzen Sie „Unicode encoding of SMS text“ auf ‚Yes‘

• wenn Sie als MMS senden möchten, können Sie festlegen, ob dies immer oder nur dann geschehen soll, wenn eine E-Mail einen Anhang enthält

• Wählen Sie, ob Sie Kontakte aus dem LDAP-Verzeichnis verwenden möchten (Yes/No). Das LDAP-Plugin muss zuerst konfiguriert werden, um diese Funktion nutzen zu können

• Wenn Sie Kontakte aus LDAP aktiviert haben, definieren Sie die Telefonnummer für LDAP-Fehler. Benachrichtigungen über Fehler bei der LDAP-Verbindung werden nach 3 erfolglosen LDAP-Verbindungsversuchen an diese Telefonnummer gesendet. Lassen Sie dieses Feld leer, wenn keine Benachrichtigungen gewünscht sind

• FQDN: Das Email2SMS-Plugin kann so konfiguriert werden, dass es anstelle der reinen IP-Adresse des Geräts in der E-Mail-Adresse eine alternative FQDN-Adresse verwendet. Dies erfordert die Konfiguration einer entsprechenden Domain und der DNS-Einträge auf Ihrem DNS-Server – sowohl A- als auch MX-Einträge, die auf die IP-Adresse des SMSEagle verweisen. Mit dieser Konfiguration erreichen E-Mails, die an die neu konfigurierte Domain gesendet werden, den SMSEagle und werden vom Plugin korrekt verarbeitet.

• NAT: Wenn Ihr Gerät im LAN hinter NAT arbeitet und Sie in der Lage sein möchten, ihm E-Mails aus dem öffentlichen Internet zu senden, müssen Sie hier die öffentliche IP-Adresse konfigurieren, unter der es erreichbar wäre. Beachten Sie, dass dies eine zusätzliche Konfiguration Ihres LAN/Ihrer Firewall erfordert, um den Datenverkehr an den SMSEagle weiterzuleiten (mindestens die Weiterleitung des TCP-Ports 25).

Email to SMS Poller

Der Email2SMS Poller ist eine Alternative zur Email2SMS-Funktion zum Konvertieren von E-Mails in SMS-Nachrichten. Diese Funktion sollte verwendet werden, wenn Sie E-Mails aus einem bestehenden Postfach auf Ihrem Mailserver abrufen müssen. Der Email2SMS Poller verbindet sich mit einem konfigurierten E-Mail-Konto und ruft es in festgelegten Zeitabständen nach neuen E-Mails ab. Sobald eine neue E-Mail empfangen wird, wird sie automatisch in eine SMS-Nachricht umgewandelt.

Die Funktion unterstützt POP3- und IMAP-Konten sowie die Basisauthentifizierung für alle Postfächer und OAuth2 für Office365-Postfächer.

Um eine SMS über Email2SMS Poller zu versenden, müssen Sie eine E-Mail an ein bestimmtes E-Mail-Konto senden, wobei der Betreff der E-Mail eine Mobilnummer (oder mehrere durch Komma getrennte Telefonnummern) oder den Namen eines Telefonbuchkontakts/einer Gruppe enthalten muss.

Einfaches Beispiel

Zum Beispiel eine solche E-Mail-Nachricht:

TO: smseagle@mycompany.com
FROM: john.doe@mycompany.com
SUBJECT: +48333444555
BODY: Hello world!

In diesem Fall ruft das SMSEagle-Gateway eine eingehende E-Mail vom Konto smseagle@mycompany.com ab und sendet deren Inhalt als SMS-Nachricht an die Mobilnummer +48333444555.

An Benutzername/Gruppe senden

Wenn Sie eine SMS an einen Kontakt oder eine Gruppe aus dem SMSEagle-Telefonbuch senden möchten, geben Sie den Namen des Kontakts/der Gruppe in das Feld SUBJECT ein.

An LDAP-Kontakte/Gruppen senden

Wenn Ihr Unternehmen LDAP (Active Directory oder OpenLDAP) für die Kontaktverwaltung verwendet, können Sie LDAP-Kontakte oder -Gruppen verwenden, um E-Mail in eine SMS-Textnachricht umzuwandeln.

Beispiel: Eine E-Mail-Nachricht, die mit dem Betreff myldap-admins gesendet wird, wird in eine SMS-Nachricht umgewandelt und an alle Mitglieder der Gruppe myldap-admins1 zugestellt. Die Gruppe myldap-admins1 muss in Ihrem LDAP-Verzeichnis definiert sein, und das LDAP-Plugin muss auf Ihrem SMSEagle-Gerät konfiguriert sein.

Sprachanruf

Einer aus einer E-Mail konvertierten SMS-Nachricht kann optional ein Weckruf oder ein Text-to-Speech-Anruf folgen. Dies kann in der Regeldefinition aktiviert werden. Diese Funktion erfordert ein Gerät mit einem aktiven Voice-Call-Add-on.

Wichtiger Hinweis: Nachrichten, die vom Email2SMS Poller verarbeitet (aber nicht gelöscht) werden, werden im Postfach als gelesen markiert. Die Software basiert auf der Kennzeichnung von Nachrichten als Gelesen/Ungelesen. Wenn eine bereits gelesene Nachricht im Postfach als ungelesen markiert wird, führt dies dazu, dass sie erneut vom Email2SMS Poller verarbeitet wird. Wir empfehlen, ein separates E-Mail-Konto zu verwenden, um zu vermeiden, dass dieselbe Nachricht erneut gesendet wird (indem eine bereits verarbeitete gelesene Nachricht als ungelesen markiert wird).

Funktionskonfiguration

Die Funktion „Email To SMS Poller“ ermöglicht das Hinzufügen mehrerer Weiterleitungsregeln. Jede Regel kann vom Benutzer aktiviert oder deaktiviert werden.

Screenshot der Email to SMS Poller-Regeln

Screenshot von Email to SMS Poller > Add new rule

• Sie können Ihrer Regel einen Namen geben

• Sie können die Weiterleitung auf „Always“ oder „For specified senders / when email contains“ einstellen

• Sie können eine sendende Modem-Nr. auswählen.

• Sie können eine „Stop phrase“ definieren. Der Text ab dieser Stopp-Phrase wird (unter Beachtung der Groß-/Kleinschreibung) aus der Nachricht entfernt

• Sie können die Nachrichtenpriorität festlegen (0–9). Nachrichten mit höherer Priorität werden in der ausgehenden Warteschlange früher verarbeitet

Screenshot der Email to SMS Poller-Einstellungen

• Wenn Sie das Plugin verwenden möchten, setzen Sie ‚Enable Email2SMS Poller‘ auf ‚Yes‘

• Legen Sie das Intervall für den E-Mail-Abruf fest (in Sekunden)

• Der Text einer E-Mail wird auf den im Feld „Maximum number of characters“ angegebenen Wert gekürzt. Die maximal zulässige Länge einer SMS-Nachricht beträgt 1300 Zeichen.

• Wenn Sie spezielle nationale Zeichen einbeziehen möchten, aktivieren Sie „Unicode encoding of SMS text“

• Wählen Sie das Protokoll IMAP oder POP3

• Geben Sie die Postfach-Konfiguration an (Host, Port, Benutzer, Passwort, Verschlüsselungseinstellungen)

• Wenn Sie E-Mails nach dem Abruf durch den Email2SMS Poller aus dem Postfach löschen möchten, markieren Sie „Delete emails from server after processing“

• Wenn Sie als MMS senden möchten, wählen Sie „always“ oder „only when email contains an attachment“

Funktionskonfiguration für Office 365 OAuth2

• Wählen Sie im Reiter Settings beim Parameter „Protocol“ die Option „IMAP + Oauth2 (Office 365)“

• Host: Geben Sie den IMAP-Server für Office365 ein (Standard: outlook.office365.com)

• Username: Geben Sie die E-Mail-Adresse des Postfachs ein, das für den Email2SMS Poller verwendet werden soll

• Folgen Sie den Anweisungen im Knowledgebase-Artikel: How to setup Office365 for Oauth2?, um die Werte für Client ID, Tenant ID und Client Secret aus dem Microsoft Azure Portal zu erhalten

• Geben Sie die Werte Client ID, Tenant ID, Client Secret in den Plugin-Einstellungen ein

• Klicken Sie auf die Schaltfläche „Save“, um die Einstellungen zu speichern

• Klicken Sie auf die Schaltfläche „Authenticate via Oauth“ und melden Sie sich mit der E-Mail-Adresse und dem Passwort des Postfachs an, das für den Email2SMS Poller verwendet wird

• Wenn der Vorgang erfolgreich abgeschlossen wurde, sollte in der SMSEagle Web-GUI die Meldung „Oauth authentication success“ angezeigt werden

SMS to Email

Die Funktion SMS to Email ermöglicht es, eingehende SMS/MMS-Nachrichten an eine E-Mail-Adresse weiterzuleiten.

Das Plugin kann in zwei Modi verwendet werden:

1. Weiterleitung eingehender SMS/MMS an die E-Mail-Adresse des letzten Absenders (sogenanntes Two-way Email2SMS & SMS2Email) In diesem Modus prüft SMSEagle beim Empfang einer eingehenden SMS, ob zuvor jemand über Email2SMS eine SMS an die Nummer aus der eingehenden SMS gesendet hat. Wird ein letzter Absender gefunden, wird die eingehende SMS an dessen E-Mail-Adresse weitergeleitet. Wird kein letzter Absender gefunden, wird die eingehende Nachricht an eine in den Plugin-Einstellungen festgelegte Standard-E-Mail-Adresse weitergeleitet.

2. Es leitet alle eingehenden Nachrichten an eine feste E-Mail-Adresse weiter. In diesem Modus werden eingehende SMS/MMS-Nachrichten immer an dieselbe E-Mail-Adresse weitergeleitet.

Funktionskonfiguration

Die Funktion verwendet einen externen SMTP-E-Mail-Server zum Versenden von E-Mails. Sie können den E-Mail-Server über das Menü Emails > SMTP Configuration konfigurieren. Bitte fügen Sie mindestens eine Konfiguration hinzu und wählen Sie diese im Dropdown-Parameter „SMS To Email“ unten aus.

Die Funktion „SMS To Email“ ermöglicht das Hinzufügen mehrerer Weiterleitungsregeln. Jede Regel kann von einem Benutzer aktiviert oder deaktiviert werden.

Screenshot von SMS to Email > Rules

Screenshot von SMS to Email > Rules> Add or Edit rule

In der Regeldefinition können Sie wählen, ob alle eingehenden Nachrichten weitergeleitet werden sollen oder nur Nachrichten von bestimmten Absendern/mit bestimmtem Text. Der E-Mail-Betreff kann ein fester Text sein, oder Sie können Platzhalter verwenden: {SENDER} - Absendernummer, {WORDS,X} - Die ersten X Wörter der Nachricht, {CHARS,X} - Die ersten X Zeichen der Nachricht.

E-Mail-Text dieser Funktion

Der E-Mail-Text der Funktion SMS To Email enthält:

• Telefonnummer aus der eingehenden SMS (und Name des Telefonbuchkontakts, falls gefunden)

• Datum und Uhrzeit des SMS-Empfangs

• SMS-Nachricht

Beispiel für einen von SMSEagle gesendeten E-Mail-Text: From: +483334455 (John Doe) Received: 2017-06-01 14:38:12 Message: My SMS message

Email Alerts

Die Funktion Email Alerts ermöglicht das Senden einer E-Mail-Benachrichtigung an eine ausgewählte E-Mail-Adresse, wenn beim Versenden von SMS Fehler auftreten. Wenn ein definierter Schwellenwert für die Fehleranzahl erreicht wird, wird eine Benachrichtigungs-E-Mail ausgelöst.

• Sie können das Senden einer E-Mail-Benachrichtigung bei Fehlern beim Nachrichtenversand aktivieren/deaktivieren

• Sie können die Anzahl der Fehler festlegen, bevor eine Benachrichtigung gesendet wird

• Sie können die E-Mail-Adresse(n) der Empfänger festlegen

• Sie können den E-Mail-Betreff und den Inhalt der Nachricht einschließlich Platzhaltern festlegen.

• Sie können Ihre SMTP-Servereinstellungen für den Versand von E-Mails eingeben

• Sie können Debug-Informationen im Systemprotokoll speichern (aktivieren Sie dies nur zur Fehlerbehebung)

Hinweis: Um Fehlalarme zu vermeiden, empfehlen wir, den Parameter „Send alert when error counter exceeds“ auf einen Wert > 2 zu setzen.

Der E-Mail-Server, der für SMS to Email verwendet wird, wird über das Menü Emails > SMTP Configuration konfiguriert. Bitte fügen Sie mindestens eine Konfiguration hinzu und wählen Sie diese im untenstehenden Dropdown-Parameter aus

E-Mail-Konversationen

Das Emails-Modul enthält eine eigene Conversations-Seite, die eingehende und ausgehende E-Mail-Nachrichten in einer nach Absender/Empfänger gruppierten Thread-Ansicht darstellt. Dies erleichtert die Nachverfolgung des vollständigen Verlaufs der E-Mail-Kommunikation direkt in der SMSEagle Web-GUI.

Eingehende und ausgehende E-Mail-Nachrichten werden automatisch auf dem Gerät gespeichert und sind über die Conversations-Seite zugänglich.

Screenshot aus dem Menü Emails>Conversations

SMTP Configuration

Das Menü SMTP Configuration ist die zentrale Stelle zur Konfiguration der SMTP-Einstellungen. Diese Einstellungen sind erforderlich, wenn Sie E-Mails vom SMSEagle-Gerät aus in verschiedenen Funktionen wie SMS to Email, API, Compose-Menü oder Email Alerts senden möchten.

Hier können Sie eine einzige Konfiguration für alle Funktionen oder mehrere Konfigurationen, jeweils eine pro Funktion, verwenden.

Screenshot aus dem Menü SMTP Configuration

So beginnen Sie mit der Nutzung der E-Mail-Funktionen auf Ihrem SMSEagle:

1. Erstellen Sie mindestens eine Konfiguration

Screenshot aus SMTP add configuration

• Konfigurationsnamen festlegen

• SMTP Host festlegen

• SMTP Port festlegen

• SMTP-Verbindungsverschlüsselung auswählen (none, SSL, TLS)

2. Konfiguration einer ausgewählten Funktion zuweisen

Sobald ein Konfigurationseintrag eingerichtet ist, weisen Sie ihn einer ausgewählten Funktion zu.

Workflows

Die Workflows-Funktion ermöglicht ein fortschrittliches Management von eingehender und ausgehender Kommunikation durch die Definition von Regeln und Aktionen basierend auf Nachrichteninhalt und -quelle. Sie ermöglicht die Erstellung sehr flexibler Automatisierungsregeln, die jeweils aus drei Komponenten bestehen:

• Trigger - Das Ereignis, das die Regel startet, z. B. eine eingehende SMS, MMS, E-Mail, WhatsApp- oder Signal-Nachricht.

• Bedingung - Optionale Logik, die definiert, wann die Regel ausgeführt werden soll.

• Aktion - Das Ergebnis, das bei Ausführung der Regel durchgeführt wird, z. B. das Senden von SMS-, MMS-, WhatsApp- oder Signal-Nachrichten oder das Initiieren von Ring-Anrufen, Text-To-Speech-Anrufen und Wave-Datei-Anrufen.

Die Workflows-Funktion ermöglicht es Ihnen, mehrere Verarbeitungsregeln hinzuzufügen. Jede Regel kann von einem Benutzer aktiviert oder deaktiviert werden.

Workflow-Builder

Um eine einzelne Workflow-Regel zu erstellen, verwenden Sie den Workflow Builder. Dieses Tool ermöglicht es Ihnen, die Verarbeitung eingehender Nachrichten (oder anderer Ereignisse) mithilfe von Point-and-Click-Regeln zu automatisieren.

Screenshot des Workflow Builders

In jedem Workflow können Sie Folgendes konfigurieren:

Name Geben Sie einen aussagekräftigen Namen für Ihre Regel ein.

Trigger Der Trigger ist ein Ereignis, das die Regel auslöst. Sie können aus folgenden Triggern wählen:

• Modem (SMS/MMS)

• E-Mail

• WhatsApp

• Signal On Sent (SMS/MMS): wird ausgelöst, wenn eine ausgehende Nachricht gesendet wurde

• On Error (SMS/MMS): wird ausgelöst, wenn beim Senden einer Nachricht ein Fehler auftritt

• On Delivery Report (SMS/MMS): wird ausgelöst, wenn ein Zustellbericht empfangen wird

Bedingungsgruppen Erstellen Sie eine Logik mit Gruppen von Bedingungen. Jede Bedingung besteht aus:

• Eigenschaft (Absender oder Inhalt)

• Operator (Contains, Equals, Not Equals, Ends With, Not Contains, Regex Match, Starts With, In Group oder In Contact)

• Wert (Freitext)

Sie können mehrere Bedingungen innerhalb einer Gruppe hinzufügen, die mit UND-Logik verknüpft sind. Sie können mehrere Bedingungsgruppen hinzufügen, die mit ODER-Logik verknüpft sind.

Aktionen Eine Aktion definiert, was geschieht, wenn die Bedingungen erfüllt sind. Die folgenden Aktionen sind verfügbar:

• SMS

• TTS-Anruf

• Erweiterter TTS-Anruf

• Ring-Anruf

• Wave-Anruf

• E-Mail

• WhatsApp

• Signal

Screenshot aus Menü > Workflows > +Add new workflow > Email Action

Der obige Screenshot zeigt ein Email Action Beispiel:

• E-Mail-Adressen: Geben Sie einen oder mehrere Empfänger ein und klicken Sie auf Add.

• Telefonbuchkontakte / Gruppen: Zielen Sie auf gespeicherte öffentliche Kontakte oder öffentliche Gruppen ab (nur öffentliche Einträge werden akzeptiert).

• Subject template und Message template: Erstellen Sie die ausgehende E-Mail mithilfe von Platzhaltern:

  • Verfügbare Platzhalter (wie angezeigt): {{sender}}, {{content}}

• Include attachments: Optionales Kontrollkästchen, um etwaige Anhänge weiterzuleiten.

Sie können mehrere Aktionen innerhalb eines Workflows hinzufügen, zum Beispiel: SMS senden und einen Anruf tätigen.

Dynamische Empfänger-Platzhalter

Wenn der Trigger auf Email gesetzt ist, stehen dynamische Empfänger-Platzhalter zur Verfügung, die es dem Workflow ermöglichen, die Nachricht automatisch an einen Empfänger weiterzuleiten, der aus dem Inhalt der eingehenden Nachricht abgeleitet wird. Der Empfänger kann abgeleitet werden aus:

• email identifier: aus der An-Adresse extrahierte Telefonnummer (z. B. wird aus +48123456789@domain.com +48123456789 entnommen).

• subject: verwendet einen E-Mail-Betreff, um eine Empfänger-Telefonnummer, eine Telefonbuchkontakt-ID oder eine Telefonbuchgruppen-ID zu extrahieren

SMS Forward

Die Funktion „SMS forward“ ermöglicht es, eingehende SMS-Nachrichten gemäß definierter Regeln an einen oder mehrere Empfänger weiterzuleiten.

Funktionskonfiguration

Die Funktion „SMS Forward“ ermöglicht das Hinzufügen vieler Weiterleitungsregeln. Jede Regel kann vom Benutzer aktiviert oder deaktiviert werden.

Screenshot aus dem Hauptfenster des Plugins

Für jede Regel kann der Benutzer Folgendes festlegen:

• Wann eingehende SMS weitergeleitet werden sollen (Rule type) und an welche Nummer(n) die Nachricht weitergeleitet werden soll (SMS Recipient).

• Ob die Absendernummer, von der die ursprüngliche SMS stammt, in der SMS enthalten sein soll oder nicht.

• Beim Definieren einer Regel kann der Benutzer den SMS Recipient auswählen (wer die weitergeleitete SMS erhält). Dies kann entweder eine Telefonnummer oder der Name einer Gruppe aus dem Telefonbuch sein.

• Der Benutzer kann im Plugin viele Weiterleitungsregeln definieren.

• Jede Regel wird unabhängig verarbeitet.

• Es kann eine Priorität (0-9) festgelegt werden, Nachrichten mit einer höheren Priorität werden früher in die Warteschlange eingereiht.

• Der Benutzer kann sich dafür entscheiden, einen benutzerdefinierten Text zusammen mit Platzhaltern einzufügen:

*{SENDER} - Absendernummer {MESSAGE} - Ursprüngliche Nachricht *

• Es besteht die Möglichkeit, jede Regel zu aktivieren/deaktivieren.

Screenshot des Formulars „Add/edit forwarding rule“

Sprachanruf

Auf eine SMS-Nachricht kann optional ein Wecksignal (Wake-up Call) oder ein Text-to-Speech-Anruf folgen. Dies kann in der Regeldefinition aktiviert werden. Diese Funktion erfordert ein Gerät mit einem aktiven Voice-Call-Add-on.

MQTT

MQTT ist ein Nachrichtenprotokoll für das Internet der Dinge (IoT). Es wurde als extrem leichtgewichtiger Publish/Subscribe-Nachrichtentransport konzipiert, der ideal ist, um entfernte Geräte mit minimaler Netzwerkbandbreite zu verbinden. MQTT wird heute in einer Vielzahl von Branchen eingesetzt, wie z. B. in der Automobilindustrie, der Fertigung, der Telekommunikation, der Öl- und Gasindustrie usw.

Mit der MQTT-Funktion auf SMSEagle können Sie MQTT in SMS und SMS in MQTT umwandeln. Sie können mehrere Umwandlungsregeln erstellen:

• wenn eine SMS mit einem vordefinierten Inhalt beim SMSEagle-Gateway eingeht, wird sie an MQTT weitergeleitet

• wenn eine Nachricht mit einem definierten Inhalt bei MQTT eingeht, kann das SMSEagle-Gateway sie als SMS an einen oder mehrere Empfänger senden

Funktionskonfiguration

Die Funktion „MQTT“ ermöglicht es Ihnen, mehrere Verarbeitungsregeln sowohl für das Subscribe- als auch für das Publish-Szenario zu definieren.

Screenshot vom Hinzufügen einer MQTT-Regel

Subscribe-Regeln

Screenshot vom MQTT-Subscribe-Fenster

Für jede Verarbeitungsregel kann der Benutzer Folgendes definieren:

1. ob die Weiterleitung immer gesendet werden soll oder nur für ein bestimmtes Topic/wenn die MQTT-Nachricht Folgendes enthält

2. den Text der ausgehenden SMS-Nachricht

3. den Empfänger der Nachricht (einzeln oder Gruppe)

4. bei Geräten mit mehreren Modems können Benutzer auch festlegen, von welchem Modem die SMS gesendet wird

Publish-Regeln

Screenshot vom MQTT-Publish-Fenster

Für jede Verarbeitungsregel kann der Benutzer Folgendes definieren:

1. ob die SMS-Weiterleitung immer gesendet werden soll oder nur für einen bestimmten Absender/Nachrichtentext

2. Host, Port und Topic des MQTT-Subscribers

3. bei Geräten mit mehreren Modems können Benutzer auch festlegen, von welchem Modem die SMS empfangen wird

WhatsApp

Die WhatsApp-Funktion auf dem SMSEagle-Gerät ermöglicht es Ihnen, WhatsApp-Nachrichten über die Web-GUI oder die APIv2 oder durch automatische Nachrichtenkonvertierung zu senden und zu empfangen. Nachdem Sie ein WhatsApp-Konto im Menü „Settings“ verbunden haben, können Sie WhatsApp-Nachrichten über das Menü „Compose“ senden. Sie können auch Automatisierungs-Workflows in Kombination mit anderen Quellen konfigurieren, wie z. B. E-Mails, SMS-Nachrichten oder Signal-Nachrichten. Diese sichere, lokal betriebene Erweiterung Ihres Messaging-Stacks ermöglicht die Echtzeit-Bearbeitung von Vorfällen und die Kundenkommunikation über den beliebten WhatsApp-Kanal. Da die Nachrichtenübermittlung auf Daten basiert, sollte Ihr Gerät über Ethernet oder mobile Daten mit dem Internet verbunden sein.

Die WhatsApp-Funktionalität ermöglicht es Benutzern, Nachrichten zu senden, die sowohl Text als auch Bilder enthalten. Unterstützte Bildformate sind JPEG, GIF, PNG und BMP, was eine flexible und umfangreiche Kommunikation ermöglicht.

HAFTUNGSAUSSCHLUSS

• Diese Integration funktioniert über eine legitime, benutzerauthentifizierte Sitzung von WhatsApp Web. Sie verwendet keine inoffizielle API oder ein per Reverse Engineering ermitteltes Protokoll.

• WhatsApp Inc. unterstützt oder billigt offiziell nicht die Nutzung automatisierter Systeme, Bots oder inoffizieller Clients für den Zugriff auf ihre Plattform.

• Benutzer sind dafür verantwortlich, die WhatsApp-Nutzungsbedingungen einzuhalten, einschließlich der Einschränkungen bezüglich Automatisierung und Integrationen von Drittanbietern.

• SMSEagle stellt diese Funktion wie besehen (as-is) bereit und kann keine unterbrechungsfreie Funktionalität garantieren, da sich die Plattform, Richtlinien oder technische Infrastruktur von WhatsApp ändern können.

• Die Nutzung dieser Funktion kann Einschränkungen oder Kontobeschränkungen unterliegen, die von WhatsApp auferlegt werden.

Durch die Aktivierung und Nutzung dieser Funktion erkennt der Benutzer die oben genannten Bedingungen an und akzeptiert sie.

WhatsApp ist eine Marke von Meta Platforms, Inc. Dieses Produkt steht in keiner Verbindung zu WhatsApp oder Meta Platforms und wird von diesen weder unterstützt noch gesponsert.

Einrichtung

Screenshot aus Menü > WhatsApp-Einstellungen

1. Gehen Sie im SMSEagle Web-GUI zu Menü WhatsApp > wählen Sie den Tab Settings und klicken Sie auf Show QR code

2. Öffnen Sie die WhatsApp-Anwendung auf Ihrem Mobiltelefon (sie muss bereits bei einem WhatsApp-Konto registriert sein), öffnen Sie das Kontextmenü (drei Punkte) und gehen Sie zu „Linked devices“.

3. Wählen Sie Link a device und scannen Sie den im SMSEagle Web-GUI angezeigten QR-Code.

4. Sobald die App gekoppelt ist, sind Sie bereit, WhatsApp-Nachrichten über SMSEagle zu senden/empfangen.

Screenshot aus Menü > WhatsApp-Einstellungen

Screenshot aus Menü > WhatsApp-Einstellungen

WhatsApp-Nachricht mit SMS/MMS-Fallback senden

Im Tab WhatsApp Settings können Sie einen Fallback auf SMS/MMS einstellen. Wenn die Nummer des Empfängers nicht bei WhatsApp registriert ist, sendet SMSEagle die Nachricht als SMS oder MMS (falls die Nachricht Anhänge enthält).

Bibliotheks-Updates SMSEagle verfügt über einen integrierten Mechanismus zur Aktualisierung der WhatsApp-Integrationsbibliothek. Da WhatsApp seine Plattform regelmäßig aktualisiert, sorgt eine aktuelle Bibliothek für dauerhafte Kompatibilität und einen unterbrechungsfreien Betrieb. Verfügbare Updates können im Tab WhatsApp Settings geprüft und angewendet werden.

Signal (Beta)

Signal ist eine sichere Messaging-App. Sie bietet verschlüsselte Nachrichten sowie Sprach- und Videoanrufe. Sicherheitsexperten empfehlen Signal, weil es Ende-zu-Ende-verschlüsselt ist. Dies stellt sicher, dass nur Ihr Gerät und das Gerät des Empfängers die von Ihnen gesendeten Nachrichten lesen können. Das Team hinter der Software ist gemeinnützig organisiert und wird durch Zuschüsse und Spenden unterstützt. Signal ist Open Source, das heißt, der Code ist öffentlich zugänglich.

SMSEagle-Geräte unterstützen Signal-Messaging beim Senden von Nachrichten über das Web-GUI oder die APIv2. Sie können auch Automatisierungs-Workflows in Kombination mit anderen Quellen konfigurieren, wie z. B. E-Mails, SMS-Nachrichten usw.

Um Signal zu nutzen, gehen Sie zu Menü Signal > Settings und registrieren Sie eine Telefonnummer, die in Ihrem SMSEagle-Gerät verwendet wird, wie im Knowledgebase-Artikel beschrieben: How to setup Signal on SMSEagle device. Das Messaging basiert auf Daten, daher sollte Ihr Gerät über Ethernet oder mobile Daten mit dem Internet verbunden sein.

Gesendete/empfangene Signal-Nachrichten finden Sie im Menü Signal > Conversations

Screenshot aus Menü Signal > Conversations

Webhooks (auch bekannt als Callback URL)

Mit der Webhooks-Funktion können Sie:

• eingehende Nachrichten an eine definierte URL-Adresse weiterleiten

• eine definierte URL-Adresse aufrufen, wenn sich der Status einer ausgehenden Nachricht geändert hat (Nachricht wurde gesendet/zugestellt oder es gab einen Sendefehler)

Ist die Funktion aktiviert, löst jede definierte Regel eine HTTP(S)-Anfrage an eine definierte URL aus. Die HTTP(S)-Anfrage kann vom Typ GET oder POST sein.

Funktionskonfiguration

Die Funktion „Webhooks“ erlaubt das Hinzufügen einer unbegrenzten Anzahl von Regeln. Jede Regel kann vom Benutzer aktiviert oder deaktiviert werden.

Screenshot aus den Webhooks-Einstellungen

Für jede neue Regel muss der Benutzer die erforderlichen Felder ausfüllen:

• Regelname

• Das Feld „URL“ definiert die entfernte Adresse Ihres Callback-Skripts

• Die Schaltfläche „Test URL“ ermöglicht es zu testen, ob Ihre Webhooks-Konfiguration korrekt ist. SMSEagle sendet eine Callback-Anfrage mit Testparametern und überprüft die Antwort des entfernten Servers

• „URL method“ ermöglicht die Auswahl, ob der Callback an Ihre URL mit der HTTP(S)-Methode GET oder POST erfolgt

• Trigger auswählen: bei eingehender Nachricht, bei eingehendem Anruf, bei gesendeter Nachricht, bei Zustellung der Nachricht, bei Sendefehler

• zum Ändern der Namen von Variablen in GET/POST

• Payload-Format für POST auswählen (form-data oder json)

• „Send request when“ legt fest, ob die Anfrage immer gesendet wird, nur wenn der SMS-Absender zu einem bestimmten Kontakt/einer bestimmten Gruppe gehört, oder nur wenn die eingehende Nachricht eine bestimmte Zeichenfolge enthält

• Optional können Sie den Wert „API key of your service“ definieren. Dieser wird an Ihre Callback-URL im Parameter ‚apikey‘ übergeben. Wenn Sie das Feld leer lassen, wird der Parameter ‚apikey‘ nicht an Ihre Callback-URL übergeben

• Expected HTTP Status Code(s): Legt fest, welche HTTP-Antwortcodes als erfolgreiche Webhook-Zustellung behandelt werden. Der Webhook gilt nur dann als OK, wenn der HTTP-Antwortstatus mit einem der angegebenen Codes übereinstimmt. Es können mehrere Statuscodes angegeben werden. Standard: 200

• Der Benutzer kann außerdem wählen, ob die Unterstützung für selbstsignierte SSL-Zertifikate aktiviert werden soll

Screenshot von Webhooks add or edit rule

Request-Parameter

Die per GET/POST an Ihre URL gesendete Anfrage enthält die folgenden Parameter: sender: Absendernummer timestamp: Zeitpunkt, zu dem SMSEagle die Nachricht empfangen/gesendet hat, im folgenden Format YYYYmmddHHiiss (Beispiel: 20140531092257) text: Inhalt der SMS-Nachricht attachments: (nur POST) MMS-Anhänge im Beispielformat [0 => [name => image.png, content-type => image/png, content => wfFWgwOlgBRwdWvsvs=]] (optional) text_binary: Binärinhalt der SMS-Nachricht msgid: SMSEagle-Nachrichten-ID modemno: Modemnummer, auf der die eingehende Nachricht empfangen wurde/von der die Nachricht gesendet wurde status: Nachrichtenstatus oid: Wert des OID-Identifikators, der der ausgehenden Nachricht mit übereinstimmender Telefonnummer zugewiesen wurde (optional) apikey: API-Schlüssel Ihres Dienstes (optional)

Erwartete HTTP-Antwort & Wiederholungsversuche

Nach dem Senden der HTTP(S)-GET/POST-Anfrage an Ihre Callback-URL erwartet SMSEagle die im Parameter „Expected HTTP Status Code(s)“ definierte HTTP-Antwort. Wird eine andere Antwort oder keine Antwort von Ihrer Callback-URL empfangen, wiederholt SMSEagle den Versuch 24 Stunden lang alle X Minuten. Das Wiederholungsintervall kann im Hauptfenster des Plugins festgelegt werden:

Zabbix-Bestätigung (ACK) per SMS

SMSEagle Webhooks ermöglicht die native Integration mit der Zabbix-API für eine bidirektionale Alarmbestätigung.

Bei entsprechender Konfiguration:

• Zabbix sendet einen Alarm über SMSEagle an die Empfänger

• Wenn der Empfänger auf die SMS antwortet, ruft SMSEagle automatisch die Zabbix-API auf, um den Alarm in Zabbix zu bestätigen

• Der Antworttext wird als Kommentar zum Zabbix-Problem hinzugefügt

Konfigurationsparameter in der Webhook-Regel:

• Method: „POST (Zabbix)“ auswählen, dann den Modus wählen:

  • Nur bestätigen (Acknowledge only)

  • Nur Bestätigung aufheben (Unacknowledge only)

  • Beides (ACK und NOACK — wird automatisch anhand des SMS-Präfixes erkannt)

• Zabbix-Server-URL

• Authentifizierungstyp:

  • API-Token (Zabbix ≥ 6.4)

  • Login/Passwort (für ältere Zabbix-Versionen)

• Erwartetes SMS-Antwortformat: ACK [eventid] [optionale Nachricht] oder NOACK [eventid] [optionale Nachricht]

Autoreply

Diese Funktion ermöglicht es, automatisch auf jede empfangene Nachricht mit einer definierten Textantwort zu reagieren.

Funktionskonfiguration

Die Funktion „Autoreply“ ermöglicht das Hinzufügen mehrerer Autoreply-Regeln. Jede Regel kann vom Benutzer aktiviert oder deaktiviert werden.

Screenshot aus dem Hauptfenster des Plugins

Für jede Regel kann der Benutzer Folgendes festlegen:

• Wann die Autoreply-Nachricht gesendet werden soll:

  • immer,

  • wenn die eingehende Nachricht einen definierten Text enthält,

  • und/oder wenn der Absender der Nachricht zu einem Phonebook-Kontakt/einer Gruppe gehört

  • wenn die eingehende SMS an ein ausgewähltes Modem geht

• Ob der Text der Autoreply-Nachricht als Unicode-Zeichen gesendet werden soll

Die Funktion ermöglicht außerdem die Definition eines Sendelimits für Autoreply-Nachrichten. Es ist möglich, eine Begrenzung von maximal 5 Nachrichten / 10 Minuten / Telefonnummer festzulegen.

Screenshot des Formulars „Add/edit autoreply rule“

Subscriptions (Newsletter)

Diese Funktion ermöglicht es, Newsletter-artige Abonnements per SMS zu aktivieren. Wenn jemand eine Nachricht mit einem definierten Text an Ihr SMSEagle sendet, wird die absendende Nummer automatisch zu einer Phonebook-Gruppe hinzugefügt. Diese Gruppe kann später verwendet werden, um Nachrichten über Web-GUI/API/Email To SMS zu senden. Die automatische Entfernung aus der Gruppe funktioniert auf die gleiche Weise: Wenn die eingehende SMS einen definierten Text enthält, wird die absendende Telefonnummer automatisch entfernt.

Screenshot der Funktion „Subscriptions“

Screenshot von Subscriptions > Add or edit subscriptions rule

Im Fenster „Add or edit subscriptions rule“:

• Sie können einen Regelnamen hinzufügen

• Wählen Sie eine Gruppe aus dem Phonebook aus

• Definieren Sie eine Phrase, die die Telefonnummer aus der eingehenden SMS zur Gruppe hinzufügt

• Definieren Sie die Phrase, die die Nummer aus der Gruppe entfernt

• Wählen Sie aus, ob bei der Phrase die Groß-/Kleinschreibung beachtet werden soll

Wenn über diese Funktion eine Telefonnummer zum SMSEagle-Telefonbuch hinzugefügt wird, wird zunächst ein Telefonbuchkontakt mit einem Namen erstellt: [REGELNAME] [TELEFONNUMMER]. Zum Beispiel: „Alert Sub +48123456789“. Anschließend wird der Kontakt zu einer definierten Telefonbuchgruppe hinzugefügt.

Periodische SMS

Die Funktion „Periodische SMS“ ermöglicht das Senden von SMS-Nachrichten oder USSD-Codes in einem gewünschten Zeitintervall. Der Benutzer kann viele Sendregeln definieren, und jede Regel wird unabhängig voneinander verarbeitet.

Funktionskonfiguration

Die Funktion „Periodische SMS“ ermöglicht das Hinzufügen vieler Sendregeln. Jede Regel kann vom Benutzer aktiviert oder deaktiviert werden.

Screenshot aus dem Hauptfenster des Plugins

Für jede Regel kann der Benutzer Folgendes definieren:

• Den Namen der Regel

• Sendeintervall (Stündlich, Täglich, Wöchentlich, Monatlich oder Jährlich)

• Nachrichtentyp (SMS, USSD-Code)

• Den Inhalt des SMS-Texts

• Die Empfänger (Telefonnummer(n), durch Komma getrennt, oder Gruppe(n) aus dem Telefonbuch)

Screenshot aus dem Fenster „Add new rule“

Sprachanruf

Auf eine SMS-Nachricht kann optional ein Weckruf oder ein Text-to-Speech-Anruf folgen. Dies kann in der Regeldefinition aktiviert werden. Die Funktion erfordert ein Gerät mit einem aktiven Voice-Call-Add-on.

Digitale Ein-/Ausgänge

Die digitalen Eingänge ermöglichen es dem Gerät, Signale von externen Sensoren oder Systemen zu empfangen und basierend auf dem Eingangsstatus automatisch den Versand einer SMS-Nachricht auszulösen. Die digitalen Ausgänge wiederum können verwendet werden, um an SMSEagle angeschlossene externe Geräte zu steuern und diese zu aktivieren, wenn bestimmte SMS-Nachrichten empfangen werden.

Das Modell MHD-8100 verfügt nicht über integrierte digitale Ein- oder Ausgangsschnittstellen. Diese Funktionalität kann jedoch mit dem Digital I/O Extender, einem optionalen Erweiterungsmodul, hinzugefügt werden. Der Extender bietet 32 konfigurierbare digitale I/O-Ports, von denen jeder einzeln als Eingang oder Ausgang eingestellt werden kann. Dies ermöglicht eine flexible Anpassung an eine Vielzahl von Anwendungsanforderungen. Das Modul wird über eine USB-Schnittstelle mit dem SMSEagle-Gerät verbunden.

Nach dem Anschließen:

• Zusätzliche DI/DO-Ports werden in der Regeldefinition verfügbar (Auswahl der Portnummer)

• Es gilt die gleiche Regellogik wie für integrierte Ports

• Der Status des externen I/O-Geräts ist im Menü Settings > Sysinfo sichtbar

Informieren Sie sich im SMSEagle Online-Shop oder beim Vertriebspartner-Netzwerk über den Digital I/O Extender (P/N: ACCDPIOKIT).

Konfiguration der DI/DO-Funktion

Die Funktion „Digital input/output“ ermöglicht die Definition von Regeln, die das Verhalten der digitalen Ein-/Ausgänge am SMSEagle-Gerät steuern. Der Benutzer kann mehrere Verarbeitungsregeln sowohl für Eingänge als auch für Ausgänge definieren.

Screenshot aus dem Plugin-Fenster

Digitale Eingänge

Für jede Verarbeitungsregel für digitale Eingänge kann der Benutzer Folgendes definieren:

• Den Namen der Regel

• Portnummer

• Zustand des Eingangssignals, der das Senden einer SMS-Nachricht auslöst (Feld „When input signal“)

• SMS-Text (Feld „Send SMS message“)

• Der Name des Empfängers aus dem Telefonbuch

• Alarm-Timeout. Dieser Wert definiert die Zeit zwischen aufeinanderfolgenden Alarmen. Wenn der Wert gesetzt ist und der Eingang während des Timeouts mehrmals ausgelöst wird, wird nur eine Alarmnachricht gesendet

Screenshot des Fensters „Add or edit rule“ für digitale Eingänge

Digitale Ausgänge

Für jede Verarbeitungsregel für digitale Ausgänge kann der Benutzer Folgendes definieren:

• Den Namen der Regel

• Portnummer

• Unter welcher Bedingung der digitale Ausgang gesetzt werden soll (alle eingehenden Nachrichten, wenn die eingehende SMS von einem bestimmten Kontakt im Telefonbuch stammt oder wenn der Text der eingehenden SMS einen bestimmten Wert enthält)

• Zustand des Ausgangssignals, der durch die eingehende SMS-Nachricht ausgelöst wird

• Dauer des Ausgangssignals in Sekunden (0 = ohne zeitliche Begrenzung)

• Verzögerung des Ausgangssignals, bevor das Signal gesetzt wird

• Definiert die ausgehende SMS, die gesendet wird, nachdem das Ausgangssignal ausgelöst wurde

Screenshot des Fensters „Add or edit rule“ für digitale Ausgänge

Sprachanruf

Auf eine durch eine Regel für digitale Eingänge/Ausgänge ausgelöste SMS-Nachricht kann optional ein Wake-up-Anruf oder ein Text-to-Speech-Anruf folgen. Dies kann in der Regeldefinition aktiviert werden. Die Funktion erfordert ein Gerät mit einem aktiven Voice-Call-Add-on.

LDAP

Die LDAP-Funktion ermöglicht den Zugriff auf Verzeichnisdienste: Active Directory (im Folgenden „AD“ genannt) und OpenLDAP. Die Funktion ermöglicht das Lesen von Verzeichniskontakten und -gruppen im SMSEagle Web-GUI. Optional ermöglicht sie die Authentifizierung am SMSEagle-Gerät über Verzeichnisdienste.

Funktionskonfiguration

Wählen Sie „LDAP“ im linken Menü des SMSEagle Web-GUI, um auf die Funktionskonfiguration zuzugreifen. Nach der Aktivierung der Funktion muss der Benutzer alle erforderlichen Felder entsprechend den AD-Einstellungen ausfüllen.

Im Feld „AD phone attribute“ muss der Benutzer auswählen, welches Telefonattribut aus AD im SMSEagle Web-GUI angezeigt werden soll.

Screenshot des Fensters „LDAP settings“

Klicken Sie auf „Save“ und „Test connection“, um sicherzustellen, dass SMSEagle mit dem AD-Server verbunden ist.

Screenshot, der eine erfolgreiche Verbindung zum AD-Server zeigt.

Sobald die Verbindung besteht, werden AD-Kontakt-/Gruppenvorschläge in ausgewählten Modulen des Web-GUI angezeigt. Beginnen Sie mit der Eingabe eines beliebigen Teils des Kontakt-/Gruppennamens oder der Nummer, um AD-Kontaktvorschläge anzuzeigen.

Geben Sie „LDAP“ ein, um alle im AD-Verzeichnis aufgelisteten Kontakte zu überprüfen.

Screenshot des Moduls „Compose“ mit aktivierter LDAP-Verbindung

LDAP-Verzeichnisvorschläge können in den Modulen „Compose“, „Autoreply“, „Digital input/output“, „Email To SMS“ und „Email To SMS Poller“ verwendet werden.

Authentifizierung bei SMSEagle über LDAP (optional)

Diese Funktion ermöglicht die Authentifizierung an Ihrem SMSEagle-Gerät über LDAP. Um sie zu nutzen:

• Erstellen Sie in Ihren Verzeichnisdiensten eine neue Gruppe für die SMSEagle-Admin-Rolle. Geben Sie den erstellten Gruppennamen im SMSEagle Web-GUI > LDAP > „Admin group name in LDAP“ ein

• Erstellen Sie in Ihren Verzeichnisdiensten eine neue Gruppe für die SMSEagle-Benutzerrolle. Geben Sie den erstellten Gruppennamen im SMSEagle Web-GUI > LDAP > „User group name in LDAP“ ein

• Setzen Sie den Parameter „Allow authentication to SMSEagle via LDAP“ auf „Enable“

• klicken Sie auf die Schaltfläche „Save“

• Je nach Verzeichnisstruktur Ihres LDAP-Servers müssen Sie bei OpenLDAP möglicherweise auch separate Distinguished Names für Benutzer und Gruppen angeben (falls sich diese unter unterschiedlichen Pfaden befinden)

Auf dem Anmeldebildschirm kann der Benutzer zwischen „Local“ oder „LDAP“-Authentifizierung wählen. Verwenden Sie einen der folgenden Parameter als Ihren Benutzer im SMSEagle-Anmeldeformular:

• Common Name

• givenName

• sAMAccountName

• displayName

• userPrincipalName

Bei der ersten Anmeldung mit dem LDAP-Authentifizierungstyp erstellt das System einen neuen, mit dem LDAP-Konto verknüpften Benutzer auf dem SMSEagle-Gerät. Diese Kontoeinstellungen werden bei jeder Anmeldung mit LDAP synchronisiert.

Allow/Deny List

Mit der Funktion „Allow/Deny List“ können Sie sowohl den eingehenden als auch den ausgehenden SMS-Verkehr Ihres SMSEagle-Geräts steuern. Durch die Angabe, welche Telefonnummern oder Nummernbereiche erlaubt oder gesperrt sind, können Sie sicherstellen, dass nur zugelassene Quellen Nachrichten an das Gerät senden können bzw. dass ausgehende Nachrichten nur an zugelassene Empfänger gesendet werden.

Die „Allow/Deny List“ arbeitet in einem von zwei sich gegenseitig ausschließenden Modi:

• Allow selected

• Deny selected

Es kann jeweils nur ein Modus aktiv sein.

Screenshot der Funktion „Allow/Deny List“

Modus: Allow selected

Im Modus Allow selected sind nur die Telefonnummern oder Nummernbereiche zulässig, die ausdrücklich in der Liste definiert sind. Alle anderen Nummern werden automatisch blockiert.

Verhalten:

• Eingehende SMS

Nur Nachrichten von Nummern, die in der Allow List aufgeführt sind, werden akzeptiert. Nachrichten von allen anderen Nummern werden abgelehnt.

• Ausgehende SMS Das Gerät kann Nachrichten nur an Nummern senden, die in der Allow List aufgeführt sind. Versuche, Nachrichten an andere Nummern zu senden, werden blockiert.

Typische Anwendungsfälle

• Beschränkung der Kommunikation auf eine bekannte Gruppe vertrauenswürdiger Nummern

• Beschränkung des ausgehenden Verkehrs auf genehmigte Empfänger

• Erstellung einer geschlossenen SMS-Umgebung für Integrationen, Automatisierung oder Tests

Beispiel

Wenn die Liste enthält:

• +48123456789

• +4420*

Dann:

• SMS-Verkehr ist nur zu und von dieser bestimmten Nummer +48123456789 sowie allen britischen Nummern, die mit +4420 beginnen, erlaubt

• Jede SMS mit anderen Nummern wird blockiert

Screenshot des Fensters „Add number to allow list“

Modus: Deny selected

Im Modus Deny selected sind standardmäßig alle Telefonnummern zugelassen, mit Ausnahme derjenigen, die ausdrücklich in der Liste definiert sind.

Verhalten:

• Eingehende SMS Nachrichten von Nummern, die in der Deny List aufgeführt sind, werden blockiert. Nachrichten von allen anderen Nummern werden akzeptiert.

• Ausgehende SMS Das Gerät kann keine Nachrichten an Nummern senden, die in der Deny List aufgeführt sind, kann aber Nachrichten an alle anderen Nummern senden.

Typische Anwendungsfälle:

• Blockieren unerwünschter oder missbräuchlicher Absender

• Verhinderung der SMS-Zustellung an bestimmte Ziele oder Nummernbereiche

• Ersetzen der herkömmlichen Blacklist-Filterung durch eine einheitliche Steuerung für eingehenden und ausgehenden Verkehr

Beispiel

Wenn die Liste enthält:

• +1555000000

• +31*

Dann:

• Nachrichten zu oder von diesen Nummern werden blockiert

• Aller andere SMS-Verkehr ist erlaubt

Screenshot des Fensters „Add number to deny list“

Stoppwort

Die STOP-Wort-Funktion bietet eine automatisierte Möglichkeit, unerwünschte SMS-Absender basierend auf dem Nachrichteninhalt zu blockieren. Wenn ein STOP-Wort definiert ist, überwacht das SMSEagle-Gerät eingehende SMS-Nachrichten auf dieses Schlüsselwort. Enthält eine eingehende Nachricht das definierte STOP-Wort, wird die Telefonnummer des Absenders automatisch zur Deny-Liste hinzugefügt. Infolgedessen wird jede weitere ein- oder ausgehende SMS-Kommunikation mit dieser Nummer gemäß den Regeln des ausgewählten Deny-Modus blockiert.

Diese Funktion ist besonders nützlich für:

• Automatische Bearbeitung von Opt-out- oder Abmeldeanfragen

• Blockieren von Absendern, die mit vordefinierten Schlüsselwörtern antworten (z. B. STOP, UNSUBSCRIBE)

• Reduzierung des manuellen Verwaltungsaufwands für blockierte Nummern

Screenshot des Fensters „Define STOP Word“

Hinweise:

• Die Allow/Deny-Liste gilt global für den SMS-Verkehr auf dem Gerät.

• Telefonnummern können als Einzelnummern oder Nummernbereiche mithilfe von Platzhaltern definiert werden. Für mehrere Nummern können folgende Platzhalter verwendet werden: *NUMBER, *NUMBER*, NUMBER* (wobei * beliebige Zeichen ersetzt)

SMPP

Short Message Peer-to-Peer (SMPP) ist ein in der Telekommunikationsbranche verwendetes Protokoll. Es handelt sich um ein offenes Industriestandardprotokoll, das eine Datenkommunikationsschnittstelle für die Übertragung von Kurznachrichtendaten zwischen External Short Messaging Entities (ESMEs) und SMSCs bereitstellt.

Das SMPP-Protokoll wird häufig verwendet, um Drittanbietern das Senden von Nachrichten an SMS-Gateways zur weiteren Verarbeitung zu ermöglichen.

Das SMSEagle-Gerät ist mit einem eingebetteten SMPP-Server ausgestattet. Es unterstützt SMPP in folgenden Szenarien:

• Empfang von SMS-Anfragen über SMPP und Versand von Nachrichten an den Mobilfunkanbieter über SIM und Funkmodul

• Empfang eingehender SMS vom Mobilfunkanbieter über das Funkmodul mit SIM und Weiterleitung der SMS an den SMPP-Client

Innerhalb der SMPP-Funktion ist es möglich:

1. SMS-Textnachrichten zu senden (max. 1300 Zeichen)

2. Zustellberichte zu empfangen

3. die Kodierung der Nachricht anzugeben (7-Bit-ASCII oder UTF-8 wird unterstützt)

4. eingehende Nachrichten zu empfangen und an den SMPP-Client weiterzuleiten

5. Modems auszuwählen, die zum Senden/Empfangen von SMS verwendet werden (nur für Multimodem-Geräte)

Screenshot aus dem Menü Settings > SMPP

Der SMPP-Server unterstützt SMPP Version 3.4.

Settings

Das Settings-Menü ist zur einfacheren Verwaltung in mehrere Tabs unterteilt.

Application Settings

Anwendungseinstellungen können unter dem Tab Settings > Application geändert werden.

• Sie können die Sprache der Anwendung auf Englisch, Französisch, Deutsch, Polnisch und Spanisch ändern

• Sie können die Landesvorwahl auf Ihr Land ändern (diese Einstellung wirkt sich nur auf die korrekte Zuordnung von Telefonnummern zu Telefonbucheinträgen aus)

• Sie können die Konversation so sortieren, dass Nachrichten entweder „Neueste zuerst“ oder „Älteste zuerst“ angezeigt werden

• Sie können die Konversationsansicht entweder auf „Table“ (Tabellenansicht) oder „Balloons“ (smartphone-ähnliche Ansicht) umstellen, wie im Kapitel Ordner beschrieben

• Sie können die Menge der auf einer Seite angezeigten Daten auf 10, 15, 20, 25, 50, 100, 250 oder Show all einstellen

• Sie können festlegen, ob Nachrichten dauerhaft gelöscht oder zunächst in den Papierkorb verschoben werden sollen

• Sie können den Empfang von Zustellberichten auf Yes, No oder Default (Einstellung des Netzbetreibers) setzen

• Sie können die Sichtbarkeit des Posteingangsinhalts auf All users, Only admins oder Only from assigned modems einstellen

• Sie können den Zugriff auf das Reporting-Modul auf All users oder Only admins einstellen

• Sie können eine Verzögerung zwischen dem Versenden von SMS in Sekunden festlegen (diese Einstellung kann in Fällen nützlich sein, in denen der Mobilfunkanbieter eine Nummer aufgrund von intensivem Datenverkehr blockiert. Hinweis: Das Festlegen einer Verzögerung zwischen dem SMS-Versand führt auch zu einer Verzögerung beim Empfang von SMS)

• Sie können den Zugriff auf die Datenbank für externe Anwendungen aktivieren oder deaktivieren

• Sie können die Überprüfung der Passwortkomplexität aktivieren/deaktivieren. Wenn aktiviert, muss das Benutzerpasswort mindestens 8 Zeichen lang sein und mindestens einen Kleinbuchstaben, einen Großbuchstaben, eine Zahl und ein Sonderzeichen enthalten

• Sie können die erzwungene MFA (Multifactor Authentication) für eine Benutzerrolle aktivieren: für alle Benutzer, nur neue Benutzer, oder es den Benutzern überlassen, ihre MFA-Einstellungen selbst zu wählen (Erzwingung deaktivieren)

IP-Einstellungen

IP-Einstellungen können unter dem Tab Settings > IP Settings geändert werden.

• Sie können Get IP address from DHCP aktivieren oder deaktivieren

• Sie können die IP-Adresse eingeben

• Sie können die Subnetzmaske eingeben

• Sie können die Gateway-IP-Adresse festlegen

• Sie können DNS 1 festlegen

• Sie können optional DNS 2 festlegen

• Sie können die MAC-Adresse Ihres Geräts einsehen

• Sie können den Hostname eingeben

• Sie können wählen, ob ein Proxy verwendet werden soll (Use proxy)

Allow/Deny Rules For Ip Addresses

Der Tab IP Settings enthält eine Option zur Definition von Zugriffskontrollregeln basierend auf IP-Adressen. Administratoren können eine Positivliste (Whitelist) oder Negativliste (Blacklist) von IP-Adressen oder Adressbereichen erstellen, die den Zugriff auf die SMSEagle Web-GUI und API erlauben oder blockieren. Diese Funktion hilft dabei, den Gerätezugriff nur auf vertrauenswürdige Netzwerksegmente zu beschränken. Trennen Sie mehrere Adressen durch ein Komma.

Hinweis: Mit dieser Einstellung werden alle Ports außer 22 blockiert.

Failover

Die Failover-Konfiguration wurde im Kapitel „Failover (HA-cluster) feature“ beschrieben.

Datum/Uhrzeit

Datum-/Uhrzeit-Einstellungen können unter dem Reiter Settings > Date/Time geändert werden

• Sie können das aktuelle Datum und die Uhrzeit des Geräts überprüfen

• Sie können Ihre Zeitzone einstellen

• Sie können die automatische Zeitsynchronisation mit einem NTP-Zeitserver einstellen, die automatische Zeitsynchronisation deaktivieren oder einen NTP-Server auf dem SMSEagle-Gerät erstellen (Datum und Uhrzeit werden vom 3G/4G-Netzwerk bezogen)

• Sie können die Adresse des NTP-Zeitservers einstellen (oder mehrere durch Komma getrennte Adressen)

Wartung

Wartungseinstellungen können unter dem Reiter Settings > Maintenance aufgerufen werden

• Sie können Ihr Gerät neu starten

• Sie können das Gerätemodem aktivieren oder deaktivieren

• Sie können die PIN Ihrer SIM-Karte eingeben

• Sie können die PUK Ihrer SIM-Karte eingeben

• Sie können erweiterte Modem-Protokolle für die Modem-Software aktivieren (Debug-Modus)

• Sie können den Signal-Untersuchungsmodus aktivieren (um den besten Antennenstandort zu finden)

• Sie können einstellen, dass eingehende Anrufe immer abgelehnt, angenommen oder ignoriert werden

Multi-Modem-Einstellungen werden im Kapitel Multi-modem features beschrieben.

Signal-Untersuchungsmodus

Diese Funktion ermöglicht es Ihnen, den besten Standort für die Antenne in Umgebungen mit schwacher Mobilfunksignalstärke zu finden. Wenn diese Funktion aktiviert ist, wird der Signalstärkewert auf dem SMSEagle-Dashboard alle 3 Sekunden aktualisiert. Dadurch können Sie verschiedene Antennenstandorte ausprobieren und den Ort mit dem besten Signal finden.

WARNUNG: Wenn der Signal-Untersuchungsmodus aktiviert ist, können Sie auf dem Gerät keine Nachrichten senden/empfangen.

Rufweiterleitung

Die Einstellungen für die Rufweiterleitung können unter dem Reiter Settings > Call forward aufgerufen werden.

• Sie können alle eingehenden Anrufe an eine gewählte Nummer weiterleiten lassen

MMS

MMS-Einstellungen können unter dem Reiter Settings > MMS aufgerufen werden.

• Sie können die MMS-Unterstützung aktivieren

• Sie können den APN-Wert einstellen

• Sie können den APN-Benutzernamen eingeben

• Sie können das APN-Passwort eingeben

• Sie können die MMSC festlegen

• Sie können den MMS-Proxy festlegen

• Sie können den MMS-Port festlegen

• Sie können einen Autoresponder für eingehende MMS-Nachrichten festlegen

• Sie können die MMS-Autoresponder-Nachricht eingeben

Sie können die Standardwerte für Ihren SIM-Anbieter über die Schaltfläche „Read APN Settings“ laden oder die auf der Website Ihres SIM-Betreibers gefundenen Werte eingeben.

Datenverbindung

Die Einstellungen für die Datenverbindung finden Sie unter dem Reiter Settings > Data conn.

Hier können Sie die mobile Datenverbindung Ihres Geräts steuern. Sie kann beispielsweise dazu verwendet werden, SMSEagle als Backup-Internetquelle zu nutzen. Die Datenverbindung ist für den normalen Betrieb von SMSEagle NICHT ERFORDERLICH. Lassen Sie sie deaktiviert (OFF), wenn Sie sie nicht verwenden möchten.

• Sie können den automatischen Neustart der Datenverbindung wählen

• Sie können den Internet-APN eingeben

• Sie können den APN-Benutzernamen eingeben

• Sie können das APN-Passwort eingeben

• Sie können die Zugangsnummer eingeben

• Sie können die IP-Adresse Ihres Geräts anzeigen

Sie können die Standardwerte für Ihren SIM-Anbieter über die Schaltfläche „Read APN Settings“ laden oder die auf der Website Ihres SIM-Betreibers gefundenen Werte eingeben.

SNMP

Die SNMP-Einstellungen finden Sie unter dem Reiter Settings > SNMP

• Sie können den SNMP-Dienst aktivieren/deaktivieren

• Sie können Ihren SNMP-Community-Namen festlegen (benutzerdefinierter Wert)

Der SNMP-Dienst wird nur benötigt, wenn Sie Ihr Gerät von externen Monitoring-Lösungen wie Network Monitoring Systemen usw. überwachen möchten. Weitere Informationen zu den benutzerdefinierten SNMP-Metriken, die auf dem SMSEagle-Gerät verfügbar sind, finden Sie im Kapitel SNMP agent.

SSL-Zertifikat und HTTPS-Weiterleitung

Die SSL-Einstellungen finden Sie unter dem Reiter Settings > SSL. Mit diesen Einstellungen können Sie ein SSL-Zertifikat auf Ihr Gerät hochladen und den Datenverkehr von HTTP zu HTTPS weiterleiten.

** SSL-Zertifikat** Standardmäßig ist das SMSEagle-Gerät mit einem selbstsignierten SSL-Zertifikat ausgestattet. Wenn Sie Ihr eigenes Zertifikat auf dem Gerät installieren möchten, besorgen Sie sich bitte eine gültige Zertifikatsdatei, die von einer Zertifizierungsstelle (Certificate Authority) ausgestellt wurde. Um das Zertifikat hochzuladen, geben Sie bitte die Zertifikatsdatei und den privaten Schlüssel im PEM-Format an. Das Zertifikat darf nicht passwortgeschützt sein.

Hinweis: Wenn Sie ein Let’s-Encrypt-Zertifikat verwenden möchten, folgen Sie bitte dieser Anleitung in unserer Wissensdatenbank.

Root-CA & vollständige Zertifikatskette (optional) Wenn Sie ein Root-CA- oder vollständiges Ketten-Zertifikat hinzufügen möchten, können Sie diese über die Steuerelemente „Root CA Certificate“ und „Full chain“ hochladen.

HTTP zu HTTPS weiterleiten Für optimale Sicherheit empfehlen wir, mit Ihrem SMSEagle ausschließlich HTTPS-Verbindungen zu verwenden. Sie können den Datenverkehr von HTTP zu HTTPS ganz einfach weiterleiten, indem Sie „Forward HTTP to HTTPS“ auf „Yes“ setzen.

CSR generieren

Diese Funktion vereinfacht den Prozess des Erhalts eines SSL-Zertifikats. Dabei werden zwei Dateien erstellt:

• CSR-Datei (Certificate Signing Request). Sie wird für das SSL-Zertifizierungsverfahren benötigt. Es handelt sich um eine Datei mit verschlüsseltem Text, der vom Server generiert wird, auf dem das Zertifikat laufen soll. Sie enthält Informationen, die im Zertifikat verwendet werden, wie z. B.: Name der Organisation, Domainname, Stadt, Land. Außerdem enthält sie den öffentlichen Schlüssel, der zur Verschlüsselung übertragener Informationen verwendet wird.

• Privater Schlüssel. Der private Schlüssel der CSR-Datei (Entschlüsselungsschlüssel) muss ausschließlich dem Zertifikatsinhaber vorbehalten bleiben. Diese Datei sollte zusammen mit dem SSL-Zertifikat hochgeladen werden.

Backup/Restore

Die Backup- und Restore-Einstellungen sind über den Tab Settings > Backup/Restore zugänglich

• Sie können eine Sicherung der Geräteeinstellungen erstellen

• Sie können automatische Backups auf SFTP/FTP(S) aktivieren

  • Sie können das Intervall für automatische Backups (täglich/wöchentlich/monatlich) und die Uhrzeit festlegen

  • Sie können auswählen, wie viele Backups aufbewahrt werden sollen (Backups löschen)

• Sie können Geräteeinstellungen aus einer zuvor gespeicherten Datei wiederherstellen

• Sie können zusätzlich die Datenbank wiederherstellen

*WARNUNG* Das Wiederherstellen von Backup-Einstellungen funktioniert nur mit derselben Geräte- und Softwareversion.

Updates

Die Update-Einstellungen sind über das Menü Settings > Tab Updates zugänglich.

Die SMSEagle-Software wird kontinuierlich weiterentwickelt. Wir hören auf unsere Kunden, und neue Versionen basieren auf den Anregungen/Wünschen unserer Kunden. Software-Updates werden häufig veröffentlicht und bieten Zugang zu neuen Funktionen sowie Korrekturen für gemeldete Probleme. Das Web-GUI bietet Ihnen die Möglichkeit, automatisch nach neuen Software-Updates zu suchen. Dies kann auf zwei Arten erfolgen:

Manuelle Prüfung

Um manuell nach verfügbaren Software-Updates zu suchen, gehen Sie zum Menü Settings > Tab Updates. Klicken Sie auf die Schaltfläche „Check for software update now“. Oben erscheint eine rote Sprechblase mit der Information, ob die Software aktuell ist.

Automatische Prüfung

Um die automatische Suche nach Software-Updates zu starten, gehen Sie zum Menü Settings > Tab Updates und aktivieren Sie die Option „Automatically check for software updates“. Dadurch werden periodische Prüfungen (einmal im Monat) auf verfügbare Software-Updates aktiviert. Wenn ein neues Update verfügbar ist, erscheint im Menü Settings> Sysinfo neben der aktuellen Softwareversionsnummer die Meldung „Update Available“.

Wenn Sie „Notify Admin about new software version by SMS“ auswählen, sendet das Gerät zusätzlich eine SMS an das Standard-Admin-Konto (sofern eine Telefonnummer im Konto eingetragen ist) mit einer Benachrichtigung über das neue Software-Update.

Benachrichtigung über ablaufenden technischen Support

Ähnlich wie bei der automatischen Prüfung auf Software-Updates liefert der Mechanismus zur Gültigkeitsprüfung des technischen Supports Informationen über das Ablaufdatum des technischen Supports. Einen Monat vor Ablauf eines Support-Pakets benachrichtigt Sie Ihr Gerät über das bevorstehende Ablaufdatum und stellt komfortabel einen Link zu unserem Online-Shop und unseren Vertriebspartnern bereit, bei denen Sie Ihr Paket verlängern können.

Screenshot von „General Settings-Updates“

Hinweis: Ihr SMSEagle-Gerät muss eine HTTPS-Verbindung zum Server updates.smseagle.eu haben, damit diese Funktion funktioniert.

Logs

Im Menü Settings > Logs verfügbar, zeigt dieser Bereich eine visuelle Darstellung der wichtigsten Gerätelogs.

Die folgenden Gerätelogs sind über das Web-GUI verfügbar:

1. Modem-Log

2. Datenbank-Log

3. System-Log

4. Anwendungs-Log

Sie können auch das vollständige Geräte-Log-Paket zur Fehlerbehebung und für den Support herunterladen. Dies kann über die Schaltfläche „Download device logs“ erfolgen

• Sie können wählen, ob Sie die Geräte-Logs der letzten 14 Tage, 30 Tage oder alle herunterladen möchten.

Sysinfo

Allgemeine Geräte- und Systeminformationen finden Sie im Menü Settings > Sysinfo.

Die Systeminformationen umfassen:

• Gerätemodell und Seriennummer (MAC)

• Softwareversion

• Modeminformationen: SIM-Status, Signalstärke, Netzwerkregistrierungsstatus, Modem-IMEI

• Verfügbarer Speicherplatz

Sie können SMS-Benachrichtigungen konfigurieren, die gesendet werden, wenn die Speicherplatznutzung einen bestimmten Wert erreicht. Die SMS-Benachrichtigung wird an die Telefonnummer gesendet, die dem Benutzer mit der Rolle Master Admin (id=1) zugewiesen ist.

Failover-Funktion (HA-Cluster)

„High-Availability-Cluster (auch bekannt als HA-Cluster oder Failover-Cluster) sind Gruppen von Computern (…), die mit minimaler Ausfallzeit zuverlässig genutzt werden können. Sie funktionieren, indem sie mithilfe von Hochverfügbarkeits-Software redundante Computer in Gruppen oder Clustern zusammenschließen, die auch dann weiterhin Dienste bereitstellen, wenn Systemkomponenten ausfallen. Ohne Clustering würde eine Anwendung nicht mehr verfügbar sein, wenn der Server, auf dem sie läuft, abstürzt, bis der abgestürzte Server repariert ist. HA-Clustering behebt diese Situation, indem Hardware-/Softwarefehler erkannt und die Anwendung sofort auf einem anderen System oder einem gesamten Knoten neu gestartet wird, ohne dass ein administrativer Eingriff erforderlich ist - ein Vorgang, der als Failover bezeichnet wird.“ (Quelle: Wikipedia)

SMSEagle-Geräte verfügen über einen eigenen Failover-Mechanismus, der auf einem HA-Cluster basiert. Diese Funktion ermöglicht es Ihnen, eine hohe Verfügbarkeit von SMSEagle-Geräten in kritischen Umgebungen sicherzustellen. Um Failover (HA-Cluster) zu aktivieren, benötigen Sie 2 Geräte (auch ‚Nodes‘ genannt). Die Failover-Funktion überwacht die im Cluster arbeitenden Geräte und erkennt Fehler bei den folgenden Diensten:

1. Apache2 WWW-Server

2. PostgreSQL-Datenbank

3. SNMP-Agent

4. Modem-Software (Gammu-SMSD-Daemon)

5. Erreichbarkeit (Antwort auf Ping) des gesamten Knotens.

Jeder Knoten in einem Cluster kann einen von drei Zuständen haben:

• Master: haupt-fehlerfreier Knoten in einem Cluster, standardmäßig über die virtuelle IP zugänglich

• Backup: zweiter fehlerfreier Knoten in einem Cluster, bereit und wartend, um den Master bei Bedarf zu ersetzen

• Fault: Knoten mit erkanntem Dienstfehler

Im Cluster gibt es ein MASTER-Gerät und ein BACKUP-Gerät. Auf den HA-Cluster wird über eine virtuelle IP-Adresse zugegriffen. Wenn der auf dem MASTER-Gerät laufende Daemon den Ausfall mindestens einer der beschriebenen Funktionen erkennt, schaltet er die IP-Zuweisung des Clusters sofort automatisch auf das BACKUP-Gerät (Node) um und gewährleistet so die kontinuierliche Nutzung des SMSEagle HA-Clusters für den Benutzer.

Die Geräte (Nodes) sollten sich im Netzwerk gegenseitig sehen können. Standardmäßig verwenden HA-Nodes die Multicast-IP-Adresse 224.0.0.18 für VRRP (Virtual Router Redundancy Protocol) zur Kommunikation zwischen den beiden Nodes. Befinden sich die Nodes im selben Netzwerk (gleiches Subnetz & gleicher IP-Bereich), ist keine zusätzliche Netzwerkkonfiguration erforderlich. Befinden sich die beiden Nodes hinter Firewalls, stellen Sie sicher, dass die Firewall so konfiguriert ist, dass sie Multicast und das VRRP-Protokoll (IP-Protokoll #112) zulässt.

So konfigurieren Sie Failover (HA-Cluster):

Der Failover-Cluster lässt sich einfach über die Web-GUI konfigurieren. Die Konfiguration erfolgt im Menü „Settings“ > Tab „Failover“. Die Konfiguration sollte auf beiden Geräten im HA-Cluster genau identisch sein. Bitte konfigurieren Sie zuerst das MASTER-Gerät, dann das BACKUP-Gerät. Für jedes Gerät im Failover-Cluster:

• Geben Sie die virtuelle IP-Adresse in das Feld „Virtual IP Address“ ein

• Geben Sie die IP-Adressen von Master und Backup ein (dies sollten die physischen Adressen Ihrer Geräte sein)

• Setzen Sie „Enable Failover cluster“ auf „Yes“

• Optional können Sie die Datenbankreplikation zwischen den Nodes aktivieren

Speichern Sie die Konfiguration. Starten Sie jedes Gerät nach dem Speichern neu.

Screenshot von „General Settings-Failover“

SMS-Benachrichtigung bei Statusänderungen

Die Failover-Funktion kann optional SMS-Benachrichtigungen senden, wenn sich der Cluster-Status ändert (z. B. wenn ein Node in den MASTER-Status wechselt, etwa: BACKUP > MASTER oder FAULT > MASTER). Dies ermöglicht es Administratoren, schnell auf Infrastrukturausfälle zu reagieren, ohne das Gerät manuell überwachen zu müssen. Die SMS-Benachrichtigung kann im Konfigurations-Tab „Failover“ aktiviert werden. Benachrichtigungen werden automatisch an die dem primären Admin-Konto (id=1) zugewiesene Telefonnummer gesendet.

Datenbankreplikation

Die Datenbankreplikation (optional) ermöglicht die automatische Replikation von Datenbankinhalten zwischen den Nodes vom MASTER zum BACKUP. In der aktuellen Softwareversion werden folgende Inhalte repliziert: Ordner (mit Nachrichten), Telefonbuchkontakte, Benutzer. Wir empfehlen, für eine nahtlose Replikation zwischen den Nodes dieselben Gerätemodelle zu verwenden.

Nach korrekter Konfiguration des HA-Clusters sollten Sie über dessen virtuelle IP-Adresse auf den Cluster zugreifen.

SNMP-Überwachung des HA-Clusters

Die Failover-Funktion verwendet KEEPALIVED-MIB für die SNMP-Überwachung.

Beispiel für das Auslesen des Wertes Gerätecluster-Status mit der NET-SNMP-Bibliothek

a) Befehl zum Auslesen des Ergebniswerts:* *snmpget -v 2c -c public ip-of-smseagle .1.3.6.1.4.1.9586.100.5.2.3.1.4.1

Ergebnis:* *KEEPALIVED-MIB::vrrpInstanceState.1 = INTEGER: master(2)

Kommentar: Der aktuelle Gerätestatus ist master