Dieses Kapitel behandelt den Abschnitt Automatisierung der Web-Oberfläche in der gleichen Reihenfolge, in der die Regeln dort angezeigt werden.

E-Mail zu SMS

E-Mail-zu-SMS-Regeln

Mit der Funktion E-Mail zu SMS können Sie eingehende E-Mails als SMS-Nachrichten an eine Telefonnummer oder an einen Kontakt/eine Gruppe aus Ihrem Telefonbuch weiterleiten.

Wo finde ich diese Funktion

Die Funktion ist an zwei Stellen in der WebGUI verteilt:

• Automatisierung > E-Mail > E-Mail zu SMS (/automation/email-to-sms) ist der Ort, an dem Sie Weiterleitungsregeln erstellen und verwalten.

• Einstellungen > Kanäle > E-Mail > E-Mail zu SMS (/settings/email/email-to-sms) ist der Ort, an dem Sie den Service aktivieren und konfigurieren, wie E-Mails in Nachrichten konvertiert werden – siehe E-Mail zu SMS unter Einstellungen.

Schritt 1: Understand the recipient address format

E-Mails müssen an eine speziell formatierte Adresse gesendet werden, damit SMSEagle weiß, wohin die Nachricht zugestellt werden soll.

Zur Weiterleitung an eine Telefonnummer:

PHONE_NUMBER@ADDRESS_OF_SMSEAGLE_GATEWAY

Beispiel: 999888777@gateway.smseagle.eu

Zur Weiterleitung an einen Kontakt oder eine Gruppe aus dem Telefonbuch (der Kontakt oder die Gruppe muss als öffentlich eingestellt sein):

NAME@ADDRESS_OF_SMSEAGLE_GATEWAY

Beispiel: work@gateway.smseagle.eu

Wenn der Kontakt- oder Gruppenname ein Leerzeichen enthält, verwenden Sie die URL-codierte Form: work%20group@gateway.smseagle.eu

Anstelle der Gateway-IP-Adresse können Sie einen Fully Qualified Domain Name verwenden, der unter Einstellungen > Kanäle > E-Mail > E-Mail zu SMS > Erweiterte Einstellungen > FQDN-Hostname eingestellt wird. Wenn dort LDAP-Kontakte verwenden aktiviert ist, wird dasselbe NAME@GATEWAY-Format auch Kontakte und Gruppen aufgelöst, die in LDAP / Active Directory definiert sind.

Standardmäßig wird der Inhalt der E-Mail zum Text der SMS. Dies hängt von der Einstellung Was ist mit dem E-Mail-Betreff zu tun unter Einstellungen ab: Der Betreff kann ignoriert, der Nachricht vorangestellt, zur Authentifizierung verwendet oder statt des Hauptteils gesendet werden.

Schritt 2: Create a new rule

Gehen Sie zu Automatisierung > E-Mail > E-Mail zu SMS und klicken Sie auf Create new rule. Ein Bereich mit dem Titel Add Email to SMS rule wird auf der rechten Seite angezeigt.

Feld	Beschreibung
Rule name *	Ein Name zur Identifizierung der Regel (erforderlich, max. 100 Zeichen)
Forward for *	Always send leitet jede eingehende E-Mail weiter, die dem Adressformat entspricht. Specified sender / message contains fügt Filterbedingungen hinzu, siehe Schritt 3.
Send using modem	Welches Modem das SMS sendet. Standard ist Default. Wird nur auf Geräten mit mehr als einem Modem angezeigt.
Stop phrase	Text starting from this phrase will be removed from the message (case sensitive)
Priorität	Sendpriorität von 0 bis 5. Nachrichten mit höherer Priorität werden zuerst verarbeitet.
Anruf nach SMS-Versand	Nein, Nur Klingelton, Ja - Text-zu-Sprache, or Ja - Text-zu-Sprache (erweitert). Die verfügbaren Optionen hängen von der Stimme und den TTS-Fähigkeiten Ihres Geräts ab.
Sprachmodell	Stimme für den Text-zu-Sprache-Anruf. Wird nur auf Geräten angezeigt, die erweiterte TTS unterstützen, und nur nach Auswahl von Ja - Text-zu-Sprache (erweitert).
UTF-8-Konvertierung erzwingen	Erzwingt die Konvertierung des Nachrichtentexts zu UTF-8
Gesprächsverlauf entfernen	Entfernt den zitierten Verlauf der E-Mail-Konversation aus dem Nachrichtentext

Klicken Sie auf Save, um die Regel zu erstellen, oder Cancel, um sie zu verwerfen.

Schritt 3: Filterbedingungen hinzufügen (optional)

Wenn Sie Specified sender / message contains unter Forward for auswählen, stehen drei unabhängige Bedingungen zur Verfügung, jede mit einem eigenen Kontrollkästchen und Textfeld:

• When incoming email address contains filtert nach der E-Mail-Adresse des Absenders

• When incoming messages subject contains filtert nach der E-Mail-Betreffzeile

• When incoming message content contains filtert nach dem E-Mail-Body-Text

Der Schalter Case sensitive gilt für alle aktivierten Bedingungen.

Sie können eine, zwei oder alle drei Bedingungen aktivieren. Die Regel wird nur ausgelöst, wenn alle aktivierten Bedingungen erfüllt sind.

Schritt 4: Vorhandene Regeln verwalten

Jede Regel wird als Karte in der E-Mail-zu-SMS-Liste angezeigt mit:

• dem Regelnamen

• der Weiterleitungsbedingung, z. B. Forward when incoming: email address contains: …, oder Always forward, wenn keine Bedingung festgelegt ist

• das Modem, das zum Versand verwendet wird

• die konfigurierte Stop-Phrase

• ein Ein-/Aus-Schalter zum Aktivieren oder Deaktivieren der Regel, ohne sie zu löschen

• ein ⋮ Menü mit Edit und Delete

Zusätzliche Steuerelemente in der Liste:

• Search filtert Regeln nach Namen.

• Das Auswählen von Regelkontrollkästchen enthüllt Massenaktionen: Enable / Disable und Delete.

• Mit den Paginierungssteuerelementen am unteren Rand können Sie zu einer Seite springen und ändern, wie viele Regeln pro Seite angezeigt werden.

Das Hilfefenster auf der rechten Seite erläutert die Formate der Empfängeradressen und enthält einen Button See more (Mehr anzeigen), der auf die Funktionsseite unter smseagle.eu verlinkt.

Email to SMS Poller

E-Mail-zu-SMS-Poller-Regeln

Email to SMS Poller prüft periodisch ein externes Postfach über POP3, IMAP oder IMAP mit OAuth2 (Microsoft 365 / Outlook) und konvertiert die dort gefundenen E-Mails gemäß den Email to SMS Poller-Regeln in SMS-Nachrichten. Im Gegensatz zu Email to SMS (das seinen eigenen Mailserver betreibt und aktiv Mails empfängt) greift der Poller auf ein vorhandenes Postfach zu, das Sie bereits haben.

Wo finde ich diese Funktion

Unter Automation > Email > Email to SMS Poller (/automation/email-to-sms-poller/) erstellen und verwalten Sie Regeln. Das Aktivieren des Dienstes und das Verbinden des Postfachs (POP3, IMAP oder IMAP + OAuth2 für Microsoft 365) erfolgt unter Email to SMS Poller in den Einstellungen.

Erstellen einer Regel

Klicken Sie auf Create new rule (Neue Regel erstellen). Regeln funktionieren hier genauso wie Email to SMS-Regeln – Sie benennen die Regel, wählen, ob sie alle eingeholten E-Mails weiterleitet oder nur solche, die bestimmte Sender-/Betreff-/Inhalts-Bedingungen erfüllen, und legen dieselben Pro-Regel-Optionen fest (Modem, Stoppphrase, Priorität, Anruf nach dem Versand).

SMS to Email

SMS to Email-Regeln

Was diese Funktion macht

SMS to Email leitet eingehende SMS- und MMS-Nachrichten an eine E-Mail-Adresse weiter, damit Sie diese in Ihrem Postfach lesen können, anstatt sich bei SMSEagle anzumelden.

Sie erstellen Regeln, die festlegen, welche Nachrichten weitergeleitet werden und wohin. Eine Regel kann alles weiterleiten oder nur Nachrichten von bestimmten Absendern oder nur Nachrichten, die einen bestimmten Satz enthalten.

Typische Anwendungen: Weiterleitung von Antworten von Außendienstmitarbeitern an ein gemeinsames Support-Postfach oder Archivierung von Benachrichtigungsbestätigungen in den E-Mail-Eingang eines Ticketsystems.

Bevor Sie beginnen

SMSEagle benötigt eine funktionierende Mail-Server-Konfiguration zum Versenden der E-Mails. Gehen Sie zu Settings > Channels > Email > SMTP Configuration und stellen Sie sicher, dass diese ausgefüllt und getestet ist – siehe SMTP Configuration. Ohne diese werden Regeln zwar abgeglichen, aber es kommt keine E-Mail an.

Wenn Sie die Weiterleitung auf Grundlage von Sender-Kontakten oder Gruppen durchführen möchten, müssen diese Kontakte und Gruppen im Phonebook als Public (Öffentlich) gekennzeichnet sein.

Schritt 1: SMS to Email-Seite öffnen

Gehen Sie in der Seitenleiste zu Automation > Email > SMS to Email.

Schritt 2: Erstellen Sie eine Regel

Klicken Sie auf Create new rule (Neue Regel erstellen) in der rechten oberen Ecke. Ein Seitenfenster wird geöffnet.

Benennen Sie die Regel

Geben Sie unter Rule name (Regelname) etwas Aussagekräftiges ein, z. B. Forward all to support (Alles an Support weiterleiten). Maximal 100 Zeichen.

Entscheiden Sie, welche Nachrichten weitergeleitet werden sollen

Wählen Sie Forward for (Weiterleiten für):

Option	Was es bedeutet
Always forward (Immer weiterleiten)	Jede eingehende SMS und MMS wird weitergeleitet.
Angegeben Absender / Nachricht	Nur Nachrichten, die die unten festgelegten Bedingungen erfüllen, werden weitergeleitet.

Wenn Sie Angegeben Absender / Nachricht gewählt haben, stehen zwei Bedingungen zur Verfügung. Sie können eine oder beide verwenden. Bei Verwendung beider Bedingungen muss eine Nachricht beide erfüllen, um weitergeleitet zu werden.

Wenn eingehende SMS von kommt Aktivieren Sie diese Option und wählen Sie die Kontakte oder Gruppen aus, deren Nachrichten weitergeleitet werden sollen. Beginnen Sie zu tippen, um zu suchen. Nur öffentliche Kontakte und Gruppen können hier ausgewählt werden.

Wenn Text der eingehenden SMS enthält Aktivieren Sie diese Option und geben Sie den zu suchenden Ausdruck ein, z. B. URGENT. Der Ausdruck kann überall im Nachrichtentext vorkommen. Aktivieren Sie Groß-/Kleinschreibung berücksichtigen, wenn urgent und URGENT als unterschiedlich behandelt werden sollen.

Beschränken Sie die Regel auf ein Modem (nur Multi-Modem-Geräte)

Wenn Ihr Gerät mehr als ein Modem hat, wird ein Feld Wenn Nachricht ankommt bei angezeigt. Lassen Sie es auf Beliebiges Modem oder wählen Sie ein bestimmtes Modem aus, sodass die Regel nur für Nachrichten gilt, die auf dieser SIM-Karte ankommen. Bei Single-Modem-Geräten wird dieses Feld nicht angezeigt.

Wählen Sie die Ziel-E-Mail-Adresse aus

Wählen Sie Art der E-Mail-Weiterleitung:

Option	Was es bedeutet
Zu fester E-Mail-Adresse	Jede übereinstimmende Nachricht geht an die eine Adresse, die Sie in E-Mail-Adresse weiterleiten an eingeben.
Zur E-Mail-Adresse des letzten sendenden Benutzers	Die Nachricht geht an die E-Mail-Adresse der Person, die zuletzt eine SMS an diese Telefonnummer über SMSEagle gesendet hat. Dies schließt die Schleife einer E-Mail-zu-SMS-Konversation. Geben Sie eine Standard-E-Mail-Adresse als Fallback ein, die verwendet wird, wenn kein letzter Absender vorhanden ist.

Legen Sie den E-Mail-Betreff fest

E-Mail-Betreff steuert die Betreffzeile der weitergeleiteten E-Mail. Sie können Platzhalter verwenden, die beim Versand der E-Mail durch reale Werte ersetzt werden:

Platzhalter	Ersetzt durch
{SENDER}	Die Telefonnummer, von der die SMS kam
{WORDS,X}	Die ersten X Wörter des Nachrichtentexts
{CHARS,X}	Die ersten X Zeichen des Nachrichtentexts

Beispiel: SMS von {SENDER}: {WORDS,5} erzeugt einen Betreff wie SMS von +48111222333: Temperaturalarm im Serverraum ausgelöst. Maximal 150 Zeichen.

Klicken Sie auf Save. Die Regel beginnt sofort mit neu eingegangenen Nachrichten zu wirken.

SMS Forward

Dialog zum Hinzufügen einer Weiterleitungsregel

Was diese Funktion macht

SMS Forward leitet eingehende SMS-Nachrichten an andere Personen weiter. Wenn eine Nachricht ankommt, sendet SMSEagle sie erneut an die von Ihnen gewählten Empfänger.

Sie können die Nachricht genau so weiterleiten, wie sie eingegangen ist, oder sie durch Ihren eigenen Text ersetzen. Sie können auch einen Sprachanruf auf die weitergeleitete SMS aufsetzen, damit eine Benachrichtigung nicht überschlafen wird.

Typische Einsatzbereiche: Alarmmeldungen von einer Maschine an das gesamte On-Call-Team senden, Nachrichten von einer gemeinsamen Nummer an die gerade diensthabende Person weitergeben, oder einen kurzen Maschinencode in einen lesbaren Satz für das Team umwandeln.

Bevor Sie beginnen

• Die Kontakte und Gruppen, an die Sie weiterleiten, müssen im Phonebook vorhanden sein. Kontakte und Gruppen, die als Weiterleitungsempfänger oder als Absenderbedingungen verwendet werden, müssen als Public gekennzeichnet sein.

• Entscheiden Sie, ob die Empfänger den ursprünglichen Wortlaut oder eine umformulierte Nachricht benötigen.

Schritt 1: Öffnen Sie die Seite SMS Forward

Gehen Sie in der Seitenleiste zu Automation > SMS > SMS Forward.

Schritt 2: Erstellen Sie eine Regel

Klicken Sie auf Create new rule (Neue Regel erstellen) in der rechten oberen Ecke. Ein Seitenfenster wird geöffnet.

Benennen Sie die Regel und legen Sie ihre Priorität fest

Rule name Etwas Aussagekräftiges, zum Beispiel Alarms to on-call team. Maximal 100 Zeichen.

Priority Eine Zahl von 0 bis 9. Nachrichten, die von einer höherprioritären Regel erzeugt werden, werden zum Versand früher in die Warteschlange eingefügt als Nachrichten von einer niedrigerprioritären Regel. Belassen Sie es bei der Standardeinstellung, es sei denn, Sie haben dringende Regeln, die Massenregeln übertreffen müssen.

Entscheiden Sie, welche Nachrichten weitergeleitet werden sollen

Wählen Sie Forward for (Weiterleiten für):

Option	Was es bedeutet
All incoming messages	Jede eingehende SMS wird weitergeleitet.
Angegeben Absender / Nachricht	Nur Nachrichten, die die unten festgelegten Bedingungen erfüllen, werden weitergeleitet.

Wenn Sie Angegeben Absender / Nachricht gewählt haben, stehen zwei Bedingungen zur Verfügung. Sie können eine oder beide verwenden. Bei Verwendung beider Bedingungen muss eine Nachricht beide erfüllen, um weitergeleitet zu werden.

When incoming SMS comes from Markieren Sie dies und wählen Sie die Absenderkontakte oder -gruppen unter Sender contacts aus. Hier können nur öffentliche Kontakte und Gruppen ausgewählt werden.

When incoming SMS text contains Markieren Sie dies und geben Sie den Ausdruck unter Text fragment ein, zum Beispiel ALARM. Der Ausdruck kann überall in der Nachricht vorkommen. Markieren Sie Case sensitive, wenn alarm und ALARM als unterschiedlich behandelt werden sollen.

Beschränken Sie die Regel auf ein Modem (nur Multi-Modem-Geräte)

Wenn Ihr Gerät mehr als ein Modem hat, erscheint ein Feld When messages comes to. Belassen Sie es bei der Standardeinstellung, oder wählen Sie ein bestimmtes Modem, damit die Regel nur auf Nachrichten angewendet wird, die auf dieser SIM-Karte eingehen. Bei Geräten mit nur einem Modem wird dieses Feld nicht angezeigt.

Wählen Sie, was die weitergeleitete Nachricht aussagt

Verwenden Sie Message content:

Option A: Original message

Die Empfänger erhalten den eingehenden Text unverändert. Eine zusätzliche Wahl erscheint, Message header:

Option	Ergebnis
Don’t include	Nur der ursprüngliche Text wird weitergeleitet.
Include sender	Die Telefonnummer des ursprünglichen Absenders wird der weitergeleiteten Nachricht hinzugefügt, damit die Empfänger wissen, woher sie stammt.

Option B: Custom text

Die Empfänger erhalten Ihren eigenen Text anstelle des ursprünglichen. Geben Sie ihn unter Custom message ein (maximal 500 Zeichen). Sie können Teile der ursprünglichen Nachricht mit Platzhaltern einfügen:

Platzhalter	Ersetzt durch
{SENDER}	Die Telefonnummer, von der die SMS kam
{MESSAGE}	Der vollständige Text der ursprünglichen Nachricht

Beispiel: Alarm from {SENDER}. Details: {MESSAGE} sendet einen lesbaren Satz, der um den Raw-Maschinentext konstruiert ist.

Wählen Sie die Empfänger

Wählen Sie unter Forward to die Kontakte oder Gruppen aus, die die Nachricht erhalten sollen. Geben Sie ein, um zu suchen. Dieses Feld ist erforderlich, eine Regel kann ohne mindestens einen Empfänger nicht gespeichert werden.

Optionalen Telefonanruf hinzufügen

Call after sending SMS bewirkt, dass das Gerät auch einen Sprachanruf an dieselben Empfänger tätigt. Die verfügbaren Optionen hängen von Ihrem Gerätemodell ab:

Option	Was passiert
Nein	Es wird kein Anruf getätigt. Dies ist die Standardeinstellung.
Nur Klingeln	Das Gerät ruft den Empfänger an und legt auf. Es wird kein Audio abgespielt.
Ja – Text-to-Speech	Das Gerät ruft an und liest den Nachrichtentext vor.
Ja – Text-to-Speech (erweitert)	Wie oben, jedoch mit einer wählbaren, natürlicheren Stimme. Wählen Sie die Stimme im Feld Voice model aus, das angezeigt wird.

Wenn Ihr Gerät Sprachanrufe nicht unterstützt, ist nur Nein verfügbar.

Klicken Sie auf Save. Die Regel beginnt sofort mit neu eingegangenen Nachrichten zu wirken.

Wie die Weiterleitung funktioniert

• Die Textbedingung ist eine Contains-Übereinstimmung, keine exakte Übereinstimmung. Eine Regel, die nach ALARM sucht, leitet eine Nachricht weiter, die ROOM 4 ALARM triggered lautet.

• Wenn mehrere Regeln auf dieselbe eingehende Nachricht zutreffen, leitet jede von ihnen separat weiter, sodass Empfänger mehr als eine SMS erhalten können. Halten Sie die Bedingungen unterschiedlich, um Duplikate zu vermeiden.

• Regeln gelten nur für Nachrichten, die eintreffen, nachdem die Regel erstellt und aktiviert wurde. Sie verarbeiten keine Nachrichten, die sich bereits im Posteingang befinden.

• Empfänger können aus eigenen Gründen übersprungen werden: Vacation mode beim Kontakt, eine Schicht, die derzeit außerhalb ihrer Zeiten liegt (siehe Shifts), oder die Nummer auf der Blacklist.

Vermeiden Sie Weiterleitungsschleifen. Leiten Sie Nachrichten nicht an eine Nummer weiter, die selbst an Ihr Gerät zurückleitet. Zwei Geräte, die aufeinander zeigen, senden sich gegenseitig immer wieder Nachrichten hin und her.

Autoreplies

Autoreply-Regeln und Optionen für Sendungslimit

Was diese Funktion macht

Autoreplies sendet eine automatische Textantwort auf eingehende SMS-Nachrichten.

Sie erstellen Regeln, die entscheiden, welche eingehenden Nachrichten eine Antwort erhalten und was die Antwort aussagt. Eine Regel kann auf alles antworten, oder nur auf Nachrichten von bestimmten Absendern, oder nur auf Nachrichten mit einer bestimmten Phrase.

Typische Anwendungen: Bestätigung, dass eine Bestellanfrage eingegangen ist, Mitteilung, dass die Nummer nachts unbeaufsichtigt ist, oder Antwort auf ein Stichwort mit festen Informationen wie Öffnungszeiten.

Bevor Sie beginnen

• Das Gerät muss SMS senden können. Überprüfen Sie, dass mindestens ein Modem verbunden und im Netz angemeldet ist.

• Wenn Sie nur an bestimmte Absender antworten möchten, müssen diese Kontakte und Gruppen im Phonebook als Public markiert sein.

Schritt 1: Öffnen Sie die Autoreplies-Seite

Gehen Sie in der Seitenleiste zu Automation > SMS > Autoreplies.

Auf der rechten Seite der Seite befindet sich ein Feld Autoreply options. Es enthält eine Einstellung, die für alle Regeln gilt und in Schritt 3 beschrieben ist.

Schritt 2: Erstellen Sie eine Regel

Klicken Sie auf Create new rule (Neue Regel erstellen) in der rechten oberen Ecke. Ein Seitenfenster wird geöffnet.

Benennen Sie die Regel

Geben Sie unter Rule name etwas Aussagekräftiges ein, z. B. Out of hours reply. Maximal 100 Zeichen.

Entscheiden Sie, welche Nachrichten beantwortet werden sollen

Wählen Sie Autoantwort senden für:

Option	Was es bedeutet
All incoming messages	Jede eingehende SMS erhält eine Antwort.
Angegeben Absender / Nachricht	Nur Nachrichten, die die unten festgelegten Bedingungen erfüllen, erhalten eine Antwort.

Wenn Sie Bestimmter Absender / Nachricht gewählt haben, stehen zwei Bedingungen zur Verfügung. Sie können eine oder beide verwenden. Wenn Sie beide verwenden, muss eine Nachricht beide Bedingungen erfüllen, um eine Antwort zu erhalten.

Wenn eingehende SMS von kommt Aktivieren Sie dies und wählen Sie die Kontakte oder Gruppen aus, die eine Antwort erhalten sollen. Geben Sie zur Suche an zu tippen. Nur öffentliche Kontakte und Gruppen können hier ausgewählt werden.

Wenn der eingehende SMS-Text enthält Aktivieren Sie dies und geben Sie den zu suchenden Ausdruck ein, z. B. PRICE. Der Ausdruck kann an beliebiger Stelle im Nachrichtentext vorkommen. Aktivieren Sie Groß-/Kleinschreibung beachten, wenn price und PRICE unterschiedlich behandelt werden sollen.

Beschränken Sie die Regel auf ein Modem (nur Multi-Modem-Geräte)

Wenn Ihr Gerät mehr als ein Modem hat, wird ein Feld Wenn Nachrichten zu kommt angezeigt. Lassen Sie es auf Beliebiges Modem, oder wählen Sie ein bestimmtes Modem, damit die Regel nur auf diesem SIM-Kartenschacht eingehende Nachrichten beantwortet. Bei Single-Modem-Geräten wird dieses Feld nicht angezeigt.

Schreiben Sie die Antwort

Autoantwortnachricht Der Text, der zurückgesendet wird. Maximal 2000 Zeichen. Der gleiche Text geht an alle, die diese Regel auslösen, daher halten Sie ihn allgemein.

Als Unicode senden Aktivieren Sie dies, wenn die Antwort Zeichen außerhalb des Standard-GSM-Alphabets enthält, z. B. polnische, deutsche oder kyrillische Buchstaben. Unicode-Nachrichten passen weniger Zeichen pro SMS-Teil.

Klicken Sie auf Save. Die Regel beginnt sofort mit neu eingegangenen Nachrichten zu wirken.

Schritt 3: Sendegrenze festlegen

Das Feld Autoantwortoptions auf der rechten Seite der Seite kontrolliert, wie oft das Gerät bereit ist, automatisch auf dieselbe Telefonnummer zu antworten:

Option	Ergebnis
Immer automatische Antworten senden	Jede passende Nachricht erhält eine Antwort, egal wie viele ankommen.
Senden auf maximal 5 Nachrichten / 10 Minuten / Telefonnummer begrenzen	Maximal 5 automatische Antworten gehen in 10 Minuten an dieselbe Telefonnummer. Weitere Nachrichten von dieser Nummer werden erst nach Ablauf des Zeitfensters beantwortet.

Wählen Sie die gewünschte Option aus und klicken Sie auf Speichern.

Die Verwendung der Grenze wird dringend empfohlen. Ohne sie können sich zwei Geräte, die beide automatisch antworten, gegenseitig antworten, was SMS-Gutschriften schnell aufbraucht. Die Grenze ist der Schutz davor.

Diese Einstellung ist global. Sie gilt für alle Autoantwortregel auf dem Gerät.

Wie Matching funktioniert

• Die Textbedingung ist ein enthält-Match, kein exaktes Match. Eine Regel, die nach PRICE sucht, beantwortet eine Nachricht mit dem Inhalt what is the PRICE of item 5.

• Wenn mehrere Regeln auf die gleiche eingehende Nachricht zutreffen, sendet jede von ihnen eine eigene Antwort, sodass der Absender mehr als eine SMS erhalten kann. Halten Sie die Bedingungen unterschiedlich, wenn Sie nur eine Antwort möchten.

• Regeln gelten nur für Nachrichten, die eintreffen, nachdem die Regel erstellt und aktiviert wurde. Sie verarbeiten keine Nachrichten, die sich bereits im Posteingang befinden.

Periodische SMS

Dialog zum Hinzufügen einer periodischen SMS-Regel

Was diese Funktion macht

Periodische SMS sendet eine Nachricht automatisch nach einem sich wiederholenden Zeitplan, ohne dass jemand auf „Senden

Sie können zwei Dinge planen:

• eine SMS an Telefonnummern oder eine Adressbuchgruppe, optional gefolgt von einem Telefonanruf,

• einen USSD-Code, der an Ihren Mobilfunkanbieter gesendet wird (z. B. um das Prepaid-Guthaben der SIM-Karte zu überprüfen).

Typische Anwendungen: eine tägliche „System aktiv“-Nachricht, eine wöchentliche Erinnerung an ein Bereitschaftsteam, eine monatliche Abfrage des Guthabens einer Prepaid-SIM.

Bevor Sie beginnen

• Wenn Sie an eine Gruppe senden möchten, muss die Gruppe in Phonebook > Groups existieren und als Public gekennzeichnet sein. Private Gruppen können hier nicht ausgewählt werden.

• Stellen Sie sicher, dass die Geräteuhr und die Zeitzone korrekt sind, da der Zeitplan der Gerätezeit folgt. Überprüfen Sie dies in Settings > Date/Time.

Schritt 1: Öffnen Sie die Seite „Periodic SMS“

Gehen Sie in der Seitenleiste zu Automation > SMS > Periodic SMS. Sie sehen die Liste der Regeln, die Sie bereits haben.

Schritt 2: Erstellen Sie eine Regel

Klicken Sie auf Create new rule (Neue Regel erstellen) in der rechten oberen Ecke. Ein Seitenfenster wird geöffnet.

Benennen Sie die Regel

Geben Sie unter Rule name etwas ein, das Sie später wiedererkennen, z. B. Daily heartbeat oder Monthly SIM balance. Maximum 100 Zeichen.

Legen Sie den Zeitplan fest

Wählen Sie ein Sending interval. Die Felder unter dem Auswahlfeld ändern sich je nachdem, was Sie wählen:

Interval	Was Sie festlegen	Beispiel
Hourly	At minute (in 5-Minuten-Schritten)	15 sendet um 00:15, 01:15, 02:15 und so weiter
Daily	At time	07:30 sendet jeden Morgen um 07:30 Uhr
Weekly	At week day und At time	Monday + 08:00 sendet jeden Montagmorgen
Monthly	At day of month und At time	1 + 09:00 sendet am ersten Tag jeden Monats
Annually	At month - day (Format mm-dd) und At time	12-24 + 10:00 sendet jeden 24. Dezember

Tage, die es nicht gibt: Wenn Sie etwas für den 31. Tag jeden Monats planen, wird es nicht in Monaten mit weniger Tagen versendet. Verwenden Sie den 28. oder einen früheren Tag, wenn die Nachricht jeden Monat versendet werden muss.

Wählen Sie das Modem (nur bei Multi-Modem-Geräten)

Wenn Ihr Gerät mehr als ein Modem hat, wird ein Feld Modem selection angezeigt. Lassen Sie es auf der Standardeinstellung, um SMSEagle die Auswahl zu überlassen, oder wählen Sie ein bestimmtes Modem, wenn die Nachricht über eine bestimmte SIM-Karte versendet werden muss. Bei Geräten mit einem Modem wird dieses Feld nicht angezeigt.

Wählen Sie aus, was versendet werden soll

Verwenden Sie den Schalter Message type am Anfang dieses Abschnitts:

Option A: SMS

1. Geben Sie den Text in SMS Text ein (maximal 2000 Zeichen).

2. Aktivieren Sie Send as Unicode, wenn der Text Zeichen außerhalb des Standard-GSM-Alphabets enthält, z. B. polnische, deutsche oder kyrillische Buchstaben. Beachten Sie, dass Unicode-Nachrichten weniger Zeichen pro SMS-Teil passen.

3. Wählen Sie unter Send to, wohin die Nachricht gesendet wird:

   • Public groups – geben Sie einen Gruppennamen ein und wählen Sie ihn aus der Liste aus. Sie können mehrere Gruppen hinzufügen.

   • Input manually – geben Sie die Telefonnummern ein. Trennen Sie mehrere Nummern durch Kommas, z. B. +48111222333,+48444555666.

   Sie müssen eines von beiden ausfüllen, sonst kann die Regel nicht gespeichert werden.

Option B: USSD Code

Geben Sie den Code in USSD code ein, z. B. *100#. Die Antwort des Betreibers kommt als eingehende Nachricht in Ihrem Posteingang an.

USSD-Codes werden über das Modem an Ihren Mobilfunkbetreiber gesendet. Die verfügbaren Codes hängen vom Betreiber ab, nicht von SMSEagle.

Optionalen Telefonanruf hinzufügen

Call after sending SMS veranlasst das Gerät, auch einen Sprachanruf an dieselben Empfänger zu tätigen, was für Warnmeldungen nützlich ist, die nicht übersehen werden dürfen. Die verfügbaren Optionen hängen von Ihrem Gerätemodell ab:

Option	Was passiert
Nein	Es wird kein Anruf getätigt. Dies ist die Standardeinstellung.
Nur Klingeln	Das Gerät ruft den Empfänger an und legt auf. Es wird kein Audio abgespielt.
Ja – Text-to-Speech	Das Gerät ruft an und liest den Nachrichtentext vor.
Ja – Text-to-Speech (erweitert)	Wie oben, jedoch mit einer wählbaren, natürlicheren Stimme. Wählen Sie die Stimme im Feld Voice model aus, das angezeigt wird.

Wenn Ihr Gerät Sprachanrufe nicht unterstützt, ist nur Nein verfügbar.

Klicken Sie auf Save. Die Regel wird in der Liste angezeigt und startet zur nächsten geplanten Zeit.

Subscriptions

Subscription rules

Was diese Funktion macht

Mit Subscriptions können sich Personen per SMS in eine Telefonbuchgruppe ein- und austragen, ähnlich wie bei einem Newsletter-Opt-in.

Sie definieren zwei Stichwörter: eines, das den Absender zu einer Gruppe hinzufügt, und eines, das ihn entfernt. Wenn jemand Ihre SMSEagle-Nummer mit einem dieser Stichwörter anschreibt, wird seine Telefonnummer automatisch zur Gruppe hinzugefügt oder entfernt. Sie können dann Nachrichten an diese Gruppe von Compose, der API oder E-Mail-zu-SMS senden.

Typische Anwendungen: eine öffentliche Warnliste, in die sich Bewohner eintragen können, oder eine Schichtkontaktliste, der sich Mitarbeiter selbst beitreten können, ohne dass ein Administrator tätig wird.

Bevor Sie beginnen

Erstellen Sie die Gruppe, der Nutzer beitreten können:

1. Gehen Sie zu Phonebook > Groups.

2. Klicken Sie auf Add new, geben Sie der Gruppe einen Namen und aktivieren Sie Set as Public Group.

3. Klicken Sie auf Save.

Nur öffentliche Gruppen können in einer Subscription-Regel verwendet werden.

Sie müssen Ihren Benutzern auch mitteilen, welche Nummer sie anschreiben sollen und welches Stichwort sie senden sollen. SMSEagle bewirbt dies nicht automatisch.

Schritt 1: Öffnen Sie die Subscriptions-Seite

Gehen Sie in der Seitenleiste zu Automation > SMS > Subscriptions.

Schritt 2: Erstellen Sie eine Regel

Klicken Sie oben rechts auf Create new rule. Ein Seitenpanel wird geöffnet. Füllen Sie die Felder aus:

Rule name Etwas, das Sie erkennen, z. B. Flood alerts opt-in. Maximal 100 Zeichen.

Groups Geben Sie ein und wählen Sie eine oder mehrere Gruppen aus. Abonnenten werden zu allen aufgelisteten Gruppen hinzugefügt oder entfernt. Nur öffentliche Gruppen können ausgewählt werden.

Telefonnummer zu Gruppen hinzufügen, wenn eingehende Nachricht gleich Das Schlüsselwort, das jemanden abonniert, z. B. JOIN oder START ALERTS. Das Schlüsselwort muss eindeutig für die Abonnementregel sein.

Telefonnummer aus Gruppen entfernen, wenn eingehende Nachricht gleich Das Schlüsselwort, das jemanden abmeldet, z. B. STOP oder LEAVE.

Groß-/Kleinschreibung beachten Lassen Sie dies deaktiviert, sodass join, Join und JOIN alle funktionieren. Aktivieren Sie dies nur, wenn das Schlüsselwort genau wie eingegeben übereinstimmen muss.

Klicken Sie auf Save.

Wie Matching funktioniert

Dies ist das wichtigste Detail, das Sie Ihren Benutzern mitteilen müssen:

Die gesamte eingehende Nachricht muss genau das Schlüsselwort sein. Nichts anderes darf sich in der Nachricht befinden.

Schlüsselwort ist JOIN	Ergebnis
Benutzer sendet JOIN	Abonniert
Benutzer sendet join	Abonniert (sofern Groß-/Kleinschreibung beachten nicht aktiviert ist)
Benutzer sendet Please JOIN me	Nichts passiert
Benutzer sendet JOIN ALERTS	Nichts passiert

Halten Sie deshalb Schlüsselwörter kurz und leicht zu tippen, und weisen Sie Ihre Benutzer an, nur das Schlüsselwort zu senden.

Was passiert, wenn sich jemand abonniert

• Wenn die Telefonnummer des Absenders bereits im Adressbuch vorhanden ist, wird dieser bestehende Kontakt zur Gruppe hinzugefügt.

• Wenn die Nummer nicht im Adressbuch vorhanden ist, erstellt SMSEagle automatisch einen neuen Kontakt dafür. Der Kontakt wird nach der Regel und der Telefonnummer benannt, z. B. Flood alerts opt-in +48111222333, und wird als privater Kontakt erstellt.

Wenn sich jemand abmeldet, wird er aus der Gruppe entfernt, aber der Kontakt selbst bleibt im Adressbuch.

Sie können jederzeit überprüfen, wer beigetreten ist: Gehen Sie zu Adressbuch > Gruppen, suchen Sie die Gruppe und öffnen Sie Kontakte verwalten.

Allow / Deny List

Allow / Deny List globale Optionen

Was diese Funktion macht

Die Allow / Deny List filtert SMS-Verkehr auf Ihrem Gerät nach Telefonnummer.

Sie führen eine Liste von Nummern und wählen, wie das Gerät sie behandelt:

Active mode	Was passiert
Allow selected	Nur die Nummern auf der Liste werden akzeptiert. Alles andere wird ignoriert.
Deny selected	Die Nummern auf der Liste werden ignoriert. Alles andere wird akzeptiert.
Disabled	Keine Filterung überhaupt. Die Liste wird gespeichert, aber nicht verwendet.

Typische Anwendungen: Blockieren einer Nummer, die das Gerät ständig mit Spam überflutet (Deny), oder Sperren eines Gateways, so dass nur Ihre eigenen Alarmsysteme damit kommunizieren können (Allow).

Es gibt auch eine STOP word-Option, die einen Absender automatisch zur Liste hinzufügt, wenn seine Nachricht einem von Ihnen definierten Ausdruck entspricht. Dies ist der Grund, warum ein Opt-out-Schlüsselwort wie STOP funktioniert.

Bevor Sie beginnen

Entscheiden Sie, welche Arbeitsrichtung Sie verwenden möchten. Allow selected und Deny selected verwenden zwei separate Listen, daher sind die Regeln, die Sie in einem Modus hinzufügen, im anderen Modus nicht sichtbar. Wenn Sie den Modus wechseln, wird die gesamte Liste gewechselt, nicht invertiert.

Schritt 1: Öffnen Sie die Seite Allow / Deny List

Gehen Sie in der Seitenleiste zu Automation > General > Allow / Deny List.

Auf der rechten Seite befindet sich ein Global options-Feld mit der Active mode-Einstellung und der STOP word-Konfiguration. Beide werden unten beschrieben.

Schritt 2: Wählen Sie den aktiven Modus

Stellen Sie im Global options-Feld Active mode auf Allow selected, Deny selected oder Disabled ein und klicken Sie auf Save. Die Seite wird neu geladen und zeigt die Liste an, die zu dem gewählten Modus gehört.

Während der Modus Disabled ist, zeigt die Seite eine Meldung „Filtering is disabled“ anstelle der Liste an, und Regeln können nicht hinzugefügt oder bearbeitet werden. Wechseln Sie zu Allow selected oder Deny selected, um sie erneut zu verwalten.

Schritt 3: Fügen Sie eine Nummer hinzu

Klicken Sie auf Create new in der oberen rechten Ecke. Ein Seitenpanel wird geöffnet.

Phone number Die Nummer, auf die diese Regel angewendet wird. Maximal 15 Zeichen. Nur Ziffern, + und * sind zulässig, und der Eintrag muss mindestens eine Ziffer enthalten.

Sie können eine ganze Reihe von Nummern abgleichen, indem Sie * als Platzhalter verwenden, der für beliebige Zeichen steht:

Muster	Entspricht
NUMBER	Genau diese Nummer
*NUMBER	Jede Nummer, die damit endet
NUMBER*	Jede Nummer, die damit anfängt
*NUMBER*	Jede Nummer, die sie enthält

Zum Beispiel deckt 48512* jede Nummer ab, die mit 48512 anfängt, und *12345678 entspricht demselben Teilnehmer unabhängig davon, welches Ländervorwahl-Format ankommt.

Description Eine kurze Notiz, die erklärt, warum die Nummer auf der Liste steht, zum Beispiel Spam oder Alarm panel, HQ. Erforderlich, maximal 255 Zeichen.

Klicken Sie auf Save.

Schritt 4: Importieren Sie eine Liste aus CSV

Wenn Sie die Nummern bereits in einer Tabellenkalkulation haben, klicken Sie stattdessen auf Import rules in der oberen rechten Ecke, anstatt sie einzeln hinzuzufügen.

1. Bereiten Sie eine UTF-8-codierte CSV-Datei mit genau zwei Spalten vor, mit den Überschriften Number und Reason.

2. Klicken Sie auf Import rules, ziehen Sie die Datei in den Upload-Bereich oder klicken Sie darauf, um zu durchsuchen.

3. Klicken Sie auf Import.

Die Nummern werden zur aktuell aktiven Liste hinzugefügt.

Schritt 5: Konfigurieren Sie das STOP-Wort (optional)

Das STOP-Wort fügt Absender automatisch zur Liste hinzu, sodass Personen durch Eingabe eines Schlüsselworts abmelden können.

Klicken Sie im Feld Global options neben STOP word auf Edit config. Ein Seitenpanel wird geöffnet. Wählen Sie Auto add number to list when:

Option	Was es bedeutet
Never	Das STOP-Wort ist deaktiviert. Nummern werden nur manuell oder durch Import hinzugefügt.
Incoming message equals to…	Die vollständige Nachricht muss genau der eingegebenen Phrase entsprechen.
Incoming message contains to…	Die Phrase kann überall in der Nachricht erscheinen.

Wenn Sie eine der beiden Matching-Optionen wählen, erscheinen zwei weitere Felder:

• Die Phrase selbst, maximal 160 Zeichen, zum Beispiel STOP.

• Autoreply message, maximal 160 Zeichen. Dieser Text wird an die Nummer zurückgesendet, nachdem sie zur Liste hinzugefügt wurde. Lassen Sie dieses Feld leer, wenn Sie die Abmeldung nicht bestätigen möchten.

Klicken Sie auf Save. Die Zusammenfassung im Feld Global options zeigt nun die aktive Bedingung und den Antwortext an.

Verwenden Sie „equals“ statt „contains“ für Abmelde-Schlüsselwörter. Mit contains würde eine gewöhnliche Nachricht wie please stop sending the night reports den Absender ebenfalls entfernen.

Wie die Filterung funktioniert

• Der Filter wird auf Nachrichten angewendet, die nach der Erstellung und Aktivierung der Regel eingehen. Er verarbeitet nicht bereits im Postfach vorhandene Nachrichten erneut.

• Eine deaktivierte Regel wird vollständig ignoriert, unabhängig davon, welcher Modus aktiv ist.

• Allow selected und Deny selected verwenden separate Listen. Wenn Sie den Modus wechseln und die Seite leer aussieht, betrachten Sie die andere Liste – nichts wurde gelöscht.

• Die STOP-Wort-Einstellung ist global: Sie gilt für die aktuell aktive Liste.

Workflows

Workflows – Übersicht

Workflows ermöglichen Ihnen, flexible Automatisierungsregeln zu erstellen, ohne dass Sie für jede Kombination von Trigger und Aktion eine separate Integration benötigen. Jeder Workflow besteht aus drei Teilen:

• Trigger – das Ereignis, das die Regel startet: eine eingehende SMS-, MMS-, E-Mail-, WhatsApp- oder Signal-Nachricht (oder ein Modem-Zustellungs-/Gesendet-/Sendungsfehler-Ereignis).

• Condition – optionale Logik, die entscheidet, ob die Regel für ein bestimmtes Ereignis ausgeführt werden soll.

• Action – was geschieht, wenn die Regel ausgeführt wird: Senden einer SMS-, MMS-, WhatsApp- oder Signal-Nachricht, oder Initiieren eines Anrufs, TTS-Anrufs oder Wave-Anrufs.

Wo finde ich diese Funktion

Automation > General > Workflows (/automation/workflows/).

Schritt 1: Erstellen Sie einen Workflow und wählen Sie einen Trigger

Klicken Sie auf Neue erstellen, geben Sie dem Workflow einen Namen und wählen Sie einen Trigger: Modem, E-Mail, Signal, WhatsApp, Modem (zugestellt), Modem (gesendet) oder Modem (Sendefehler).

Schritt 2: Bedingungsgruppen hinzufügen (optional)

Unter Bedingungsgruppen klicken Sie auf Gruppe hinzufügen, um eine oder mehrere Bedingungen hinzuzufügen, die das eingehende Ereignis erfüllen muss, bevor der Workflow ausgeführt wird. Lassen Sie diesen Bereich leer, wenn der Workflow für jedes Ereignis ausgeführt werden soll, das den Trigger erfüllt.

Schritt 3: Aktionen hinzufügen

Unter Aktionen klicken Sie auf Aktion hinzufügen, um zu definieren, was der Workflow bei der Ausführung tut – beispielsweise eine Antwort senden, die Nachricht an einen anderen Kanal weiterleiten oder einen Anruf tätigen.

Klicken Sie auf Workflow speichern, um ihn zu aktivieren.

Webhooks

Webhooks-Übersicht

Was diese Funktion macht

Ein Webhook veranlasst SMSEagle, Ihr System aufzurufen. Wenn auf dem Gerät etwas passiert (eine Nachricht kommt an, eine Nachricht wird gesendet, ein Zustellbericht kommt zurück, ein Anruf kommt herein), sendet das Gerät eine HTTP(S)-Anfrage an eine URL Ihrer Wahl und überträgt die Details als Parameter.

Dies ist die Methode, um SMS-Verkehr in ein Ticketing-System, ein CRM, einen Chatbot oder Ihre eigene Anwendung zu übertragen, ohne die API abzufragen.

Zwei Integrationen erhalten dedizierte Unterstützung:

Methode	Wofür sie gedacht ist
POST (3CX)	Senden von Nachrichten in ein 3CX-Telefonsystem.
POST (Zabbix)	Bestätigung von Zabbix-Ereignissen per SMS, damit ein Techniker mit ACK 12345 antworten kann, um eine Warnung zu schließen.

Bevor Sie beginnen

• Sie benötigen die URL, die die Anfragen empfängt und vom Gerät erreichbar ist. Lokale und private Adressen werden abgelehnt.

• Ihr Endpunkt sollte mit HTTP 200 OK antworten oder mit den Statuscodes, die Sie in der Regel konfigurieren.

• Für Zabbix benötigen Sie entweder ein API-Token (Zabbix 6.4 und neuer) oder einen Benutzernamen und ein Passwort.

Schritt 1: Webhooks-Seite öffnen

Gehen Sie in der Seitenleiste zu Automation > Allgemein > Webhooks.

Jede Regel zeigt ihre URL, wofür sie aktiviert wird und auf Multi-Modem-Geräten, auf welches Modem sie begrenzt ist. Jede Regel hat einen Schalter zum Aktivieren oder Deaktivieren, eine Bearbeiten-Aktion und eine Löschen-Aktion.

Das Feld Globale Optionen auf der rechten Seite enthält eine Einstellung, die für alle Regeln gilt und in Schritt 6 beschrieben ist.

Schritt 2: Erstellen Sie eine Regel

Klicken Sie auf Neue erstellen in der oberen rechten Ecke. Das Webhook-Formular wird als Vollseite mit drei Abschnitten geöffnet.

Schritt 3: Basiskonfiguration

Feld	Was Sie eingeben müssen
Regelname	Ein beschreibender Name mit maximal 100 Zeichen.
URL	Die Adresse zum Aufrufen, maximal 300 Zeichen, zum Beispiel https://example.com/webhook.
URL-Methode	GET, POST, POST (3CX) oder POST (Zabbix).
Content-Typ	Nur für einfaches POST: FormData oder JSON.
An (3CX)	Nur für POST (3CX): das Ziel in Ihrem 3CX-System.

Klicken Sie neben der URL auf Test connection, um sofort eine Beispielanfrage zu senden. Das Ergebnis wird unter dem Feld angezeigt und zeigt den zurückgekommenen HTTP-Status, damit Sie vor dem Speichern bestätigen können, dass der Endpunkt funktioniert.

Für GET und POST wird unter den Feldern ein Beispiel der Anforderungszeichenfolge angezeigt, damit Sie genau sehen können, was Ihr Endpunkt erhält.

Was die Anfrage enthält

Die Anfrage, die Ihr Endpunkt erhält, trägt die Ereignisdetails als Parameter. Einige werden für jedes Ereignis gesendet, andere nur für Nachrichten oder nur für Anrufe.

Immer gesendet

Parameter	Was es trägt
sender	Absendernummer.
timestamp	Wann SMSEagle die Nachricht empfangen oder gesendet hat, als YYYYmmddHHiiss, zum Beispiel 20140531092257.
msgid	Die SMSEagle-Nachrichten-ID.
modemno	Das Modem, auf dem die eingehende Nachricht empfangen wurde, oder das Modem, von dem die Nachricht gesendet wurde.
apikey	Der API-Schlüssel Ihres Service, falls Sie einen in den Security settings festgelegt haben. Optional.

Nur für SMS und MMS gesendet

Parameter	Was es trägt
text	Inhalt der SMS-Nachricht.
text_binary	Binärer Inhalt der SMS-Nachricht.
status	Nachrichtenstatus.
oid	Wert des OID-Identifikators, der einer ausgehenden Nachricht mit einer übereinstimmenden Telefonnummer zugewiesen ist. Optional.
attachments	MMS-Anhänge, zum Beispiel [0 => [name => image.png, content-type => image/png, content => wfFWgwOlgBRwdWvsvs=]]. Nur POST, da eine GET-Abfragezeichenfolge keine Dateidaten transportieren kann. Optional.

Wird nur für eingehende Sprachanrufe gesendet

Parameter	Was es trägt
status	Status des eingehenden Anrufs: accepted, rejected oder ignored.

Eine Regel wird für einen Ereignistyp ausgelöst, daher enthält eine Anfrage immer nur die Parameter dieses Typs. Eine Regel mit einem Incoming call-Auslöser sendet beispielsweise niemals text oder attachments.

SMSEagle erwartet, dass Ihr Endpunkt mit 200 [OK] antwortet, es sei denn, Sie erweitern dies mit Expected HTTP Status Code(s) in den Security settings.

Der Link Show Parameter description auf der Regelseite öffnet diese Liste in der Anwendung zusammen mit einer Beispiel-GET-Anfrage:

?sender=48601123123&timestamp=20140531092257&msgid=431&modemno=1&text=This+is+an+incoming+message

Parameternamen anpassen

Standardmäßig verwendet die Anfrage die oben aufgeführten SMSEagle-Parameternamen. Wenn Ihr Endpunkt andere erwartet, aktivieren Sie Customize parameter names und geben Sie neben jedem Parameter, den Sie umbenennen möchten, einen eigenen Namen ein. Alle Parameter in den drei Tabellen können umbenannt werden; diejenigen, die Sie leer lassen, behalten ihren Standardnamen.

Das Umbenennen ändert nur den Namen des Parameters in der Anfrage, nie seinen Wert oder den Zeitpunkt seiner Übermittlung.

Schritt 4: Auslösebedingungen

Send request for bestimmt, welches Ereignis den Webhook auslöst:

Option	Wird ausgelöst, wenn
Incoming message	Eine SMS oder MMS kommt an.
Sent message	Eine ausgehende Nachricht wurde gesendet.
Delivery report	Ein Lieferbericht kommt zurück.
Sending error	Eine ausgehende Nachricht ist fehlgeschlagen.
Incoming call	Ein Anruf kommt herein.

Send request when grenzt es weiter ein:

Option	Was es bedeutet
Always	Jedes Ereignis des gewählten Typs löst den Webhook aus.
Für angegebene Absender / wenn Text enthält	Nur Ereignisse, die die nachfolgenden Bedingungen erfüllen, lösen dies aus.

Wenn Sie die zweite Option gewählt haben, sind zwei Bedingungen verfügbar. Sie können eine oder beide verwenden, und ein Ereignis muss alle aktivierten Bedingungen erfüllen.

Wenn eingehende SMS von Aktivieren Sie dies und wählen Sie die Kontakte oder Gruppen aus. Nur öffentliche Kontakte und Gruppen werden akzeptiert.

Wenn eingehender SMS-Text enthält Aktivieren Sie dies und geben Sie die Phrase ein. Aktivieren Sie Case sensitive, wenn Groß- und Kleinschreibung unterschiedlich behandelt werden sollen. Diese Bedingung ist nicht für den Auslöser Incoming call verfügbar, da ein Anruf keinen Text hat.

Bei Multi-Modem-Geräten schränkt When message comes to/from die Regel auf ein einzelnes Modem ein. Lassen Sie es andernfalls auf Any modem.

Schritt 5: Sicherheitseinstellungen

Feld	Funktionsweise
API-Schlüssel Ihres Service	Ein optionaler Schlüssel, der mit der Anfrage gesendet wird, damit Ihr Endpunkt überprüfen kann, dass der Aufruf wirklich von Ihrem Gerät kommt.
Erwartete HTTP-Statuscodes	Welche Antworten als Erfolg zählen. Ein oder mehrere dreistellige Codes, durch Kommas getrennt, z. B. 200,201,202. Standard ist 200, Maximum 20 Zeichen.
Selbstsigniertes SSL-Zertifikat zulassen	Akzeptieren Sie ein Zertifikat, das nicht von einer öffentlichen Behörde signiert ist.
Peer überprüfen	Überprüfen Sie das Zertifikat des Servers.
Peer-Namen überprüfen	Überprüfen Sie, dass das Zertifikat dem Hostnamen entspricht.

Alles, was nicht den erwarteten Statuscodes entspricht, gilt als fehlgeschlagene Anfrage und wird gemäß dem globalen Wiederholungsintervall erneut versucht.

Zabbix-Regeln

Wenn Sie POST (Zabbix) als Methode gewählt haben, erscheinen zusätzliche Felder:

• Zabbix action - Acknowledge (ACK), Unacknowledge (NOACK) oder beide. Das Panel zeigt das SMS-Format, das das Gerät erwartet, z. B. ACK 12345 Problem resolved.

• Auth type - API Token (Zabbix 6.4 und neuer, empfohlen) oder Login/Password für ältere Versionen. Mit einem Token geben Sie ihn im API key-Feld ein; mit Login geben Sie Zabbix username und Zabbix password ein.

• Test values - eine Event ID und Message, die nur von Test connection verwendet werden, nie gespeichert.

Klicken Sie auf Save webhook.

Schritt 6: Wiederholungsintervall festlegen

Das Feld Global options auf der Regelseite enthält Retry interval after failed request in Minuten. Wenn eine Anfrage fehlschlägt, wartet das Gerät diese Zeit, bevor es erneut versucht.

Geben Sie eine ganze Anzahl von Minuten ein und klicken Sie auf Save. Die Einstellung ist global: Sie gilt für jede Webhook-Regel auf dem Gerät.

Verhalten von Webhooks

• Regeln gelten für Ereignisse, die nach der Erstellung und Aktivierung der Regel auftreten. Sie spielen keine vergangenen Nachrichten ab.

• Die Textbedingung ist eine Enthält-Übereinstimmung, keine exakte Übereinstimmung.

• Wenn mehrere Regeln dasselbe Ereignis erfüllen, sendet jede davon ihre eigene Anfrage, sodass eine Nachricht mehrere Endpunkte erreichen kann.

• Eine Anfrage zählt nur dann als erfolgreich, wenn der Antwortstatus einer der Erwarteten HTTP-Statuscodes ist. Alles andere, einschließlich gar keiner Antwort, ist ein Fehler und wird wiederholt.

• Test connection sendet eine Beispiel-Nutzlast, keine echte Nachricht, daher ist es sicher, gegen einen Produktions-Endpunkt auszuführen, der nur protokolliert.

MQTT

MQTT-Publish-Regeln

Was diese Funktion macht

MQTT ist das Messaging-Protokoll, das von den meisten IoT-Geräten, Sensoren und Gebäudeautomationssystemen verwendet wird. Geräte senden kurze Nachrichten an einen Broker, die jeweils mit einem Topic wie building/boiler/temperature gekennzeichnet sind. Jeder, der mit dem Broker verbunden ist, kann die Topics abhören, die ihn interessieren.

SMSEagle sitzt auf beiden Seiten dieser Konversation:

Regeltyp	Richtung	Funktionsweise
Subscribe	MQTT in SMS	Überwacht einen Broker und wandelt eingehende MQTT-Nachrichten in SMS-Nachrichten um, die an Ihre Mitarbeiter gesendet werden.
Publish	SMS in MQTT	Nimmt eingehende SMS-Nachrichten und veröffentlicht sie auf einem Broker, damit Ihr IoT-System darauf reagieren kann.

Typische Anwendungen: Umwandlung eines Sensoralarms in eine SMS an das Wartungsteam (Subscribe) oder Ermöglichung, dass ein Techniker einen Befehl textet, der vom Automatisierungssystem aufgegriffen wird (Publish).

Die beiden Regeltypen werden separat konfiguriert und sind nicht voneinander abhängig. Verwenden Sie den, den Sie benötigen.

Bevor Sie beginnen

Sie benötigen die Verbindungsdetails Ihres MQTT-Brokers: Hostadresse, Port und einen Benutzernamen und ein Passwort, falls der Broker diese benötigt – konfiguriert einmal unter MQTT in den Einstellungen, bevor Sie hier Subscribe-Regeln schreiben.

Für Subscribe-Regeln benötigen Sie auch die Liste der zu überwachenden Topics (ebenfalls in den Einstellungen festgelegt). Für Publish-Regeln benötigen Sie das Topic zum Veröffentlichen (pro Regel unten festgelegt).

---

Teil 1: Subscribe (MQTT in SMS)

Subscribe-Regeln wandeln eingehende MQTT-Nachrichten in SMS um, sobald die Broker-Verbindung selbst unter Einstellungen konfiguriert ist.

Schritt 1: Öffnen Sie die Subscribe-Regelseite

Gehen Sie in der Seitenleiste zu Automation > General > MQTT und wählen Sie dann Subscribe.

Schritt 2: Erstellen Sie eine Subscribe-Regel

Klicken Sie auf Create new rule (Neue Regel erstellen) in der rechten oberen Ecke. Ein Seitenfenster wird geöffnet.

Benennen Sie die Regel

Geben Sie in Rule name etwas Aussagekräftiges ein, zum Beispiel Boiler alarm to maintenance. Maximal 100 Zeichen.

Entscheiden Sie, auf welche MQTT-Nachrichten reagiert werden soll

Wählen Sie Forward for (Weiterleiten für):

Option	Was es bedeutet
Any message	Jede MQTT-Nachricht, die das Gerät empfängt, löst diese Regel aus.
Angegebenes Thema / Nachricht	Nur Nachrichten, die Ihre nachfolgenden Bedingungen erfüllen, lösen die Regel aus.

Wenn Sie Angegebenes Thema / Nachricht wählen, stehen zwei Bedingungen zur Verfügung. Sie können eine oder beide verwenden. Wenn Sie beide verwenden, muss eine Nachricht beide erfüllen.

Wenn eingehende Nachricht das Thema hat Aktivieren Sie dies und geben Sie das Thema in Topic ein, z. B. building/boiler.

Wenn eingehende Nachricht enthält Aktivieren Sie dies und geben Sie die Phrase in Message phrase ein, z. B. ALARM. Aktivieren Sie Case sensitive, wenn alarm und ALARM unterschiedlich behandelt werden sollen.

Wählen Sie die Empfänger

Wählen Sie in Forward to die Kontakte oder Gruppen aus, die die SMS erhalten sollen. Nur öffentliche Kontakte und Gruppen können hier ausgewählt werden. Dieses Feld ist erforderlich.

Schreiben Sie den SMS-Text

Message format steuert, was die SMS aussagt. Sie erstellen es aus der MQTT-Nachricht mit Platzhaltern:

Platzhalter	Ersetzt durch
{TOPIC}	Das Thema, auf dem die MQTT-Nachricht ankam
{MESSAGE}	Der Inhalt der MQTT-Nachricht

Die Standardeinstellung ist {TOPIC}: {MESSAGE}, was eine SMS wie building/boiler/temperature: 94 erzeugt. Sie können auch Ihren eigenen Satz um diese herum schreiben, z. B. Boiler warning on {TOPIC}, value {MESSAGE}.

Aktivieren Sie Send as Unicode, wenn der Text Zeichen außerhalb des Standard-GSM-Alphabets enthält, wie polnische, deutsche oder kyrillische Buchstaben.

Erweiterte Optionen

Klicken Sie auf Advanced options, um diesen Bereich zu erweitern. Sie benötigen dies nicht für eine grundlegende Einrichtung.

• Modem (nur Multi-Modem-Geräte) – senden Sie die SMS über eine bestimmte SIM-Karte statt über die Standardkarte.

• Call after sending SMS – führen Sie auch einen Sprachanruf an die gleichen Empfänger durch. Optionen sind No, Ring only, Yes - text to speech und Yes - text to speech (advanced), je nach den Funktionen Ihres Gerätemodells. Mit der erweiterten Option wählen Sie auch ein Voice model.

Klicken Sie auf Save. Die Regel beginnt ab sofort auf eingehende MQTT-Nachrichten zu reagieren.

So funktioniert die Subscribe-Zuordnung

• Die Topic-Bedingung ist eine contains-Zuordnung und ignoriert Groß- und Kleinschreibung. Eine Regel mit Topic boiler erfasst auch building/boiler/temperature.

• Das Kontrollkästchen Case sensitive gilt nur für die Nachrichtenphrase, nie für das Thema.

• Wenn mehrere Subscribe-Regeln die gleiche MQTT-Nachricht erfassen, sendet jede ihre eigene SMS.

---

Teil 2: Publish (SMS in MQTT)

Publish-Regeln verwenden nicht die MQTT-Serviceeinstellungen unter Settings. Jede Regel hat ihre eigene Broker-Verbindung, sodass verschiedene Regeln zu verschiedenen Brokern veröffentlichen können.

Schritt 1: Öffnen Sie die Seite „Publish rules“

Gehen Sie in der Seitenleiste zu Automation > General > MQTT und wählen Sie dann Publish.

Schritt 2: Erstellen Sie eine Publish-Regel

Klicken Sie auf Create new rule (Neue Regel erstellen) in der rechten oberen Ecke. Ein Seitenfenster wird geöffnet.

Benennen Sie die Regel

Geben Sie in Rule name etwas Aussagekräftiges ein, z. B. Technician commands to automation. Maximal 100 Zeichen.

Entscheiden Sie, welche SMS-Nachrichten veröffentlicht werden

Wählen Sie Forward for (Weiterleiten für):

Option	Was es bedeutet
Any message	Jede eingehende SMS wird an den Broker veröffentlicht.
Angegeben Absender / Nachricht	Nur Nachrichten, die den unten festgelegten Bedingungen entsprechen, werden veröffentlicht.

Wenn Sie Specified sender / message gewählt haben, sind die folgenden Bedingungen verfügbar. Sie können sie kombinieren, und eine Nachricht muss dann alle aktivierten Bedingungen erfüllen.

When incoming SMS comes from Aktivieren Sie dies und wählen Sie die Absenderkontakte oder -gruppen aus. Nur öffentliche Kontakte und Gruppen können hier ausgewählt werden.

When incoming SMS text contains Aktivieren Sie dies und geben Sie den Ausdruck unter Text fragment ein. Aktivieren Sie Case sensitive, wenn Groß- und Kleinbuchstaben als unterschiedlich behandelt werden sollen.

When messages comes to (nur Multi-Modem-Geräte) Lassen Sie es auf Any modem, oder wählen Sie ein bestimmtes Modem, damit nur auf dieser SIM-Karte ankommende Nachrichten veröffentlicht werden.

Das Einschränken einer Publish-Regel nach Absender ist eine sinnvolle Vorsichtsmaßnahme. Ohne eine Absenderbedingung kann jeder, der Ihre Nummer kennt, Inhalte in Ihr IoT-System einspeisen.

Geben Sie die Broker-Verbindung ein

Füllen Sie den Broker aus, an den diese Regel veröffentlicht:

Feld	Was Sie eingeben müssen
Host	Die Broker-Adresse, zum Beispiel test.host.io
Port	Der Broker-Port, zum Beispiel 1883. Der zulässige Bereich liegt zwischen 1 und 65535.
Username	Der Broker-Benutzer, falls erforderlich. Lassen Sie es leer für einen offenen Broker.
Password	Das Broker-Passwort, falls erforderlich.
Topic	Das Thema, in das veröffentlicht werden soll, zum Beispiel smseagle/incoming
TLS/SSL	Aktivieren Sie dies, wenn der Broker eine verschlüsselte Verbindung nutzt.
TLS certificate verification	Lassen Sie dies aktiviert, es sei denn, der Broker nutzt ein selbstsigniertes Zertifikat, das das Gerät nicht validieren kann.

Klicken Sie auf Save. Eingehende SMS-Nachrichten, die der Regel entsprechen, werden von nun an veröffentlicht.

Funktionsweise von Publish-Abgleich

• Die Textbedingung ist eine Enthält-Übereinstimmung, keine exakte Übereinstimmung.

• Wenn mehrere Publish-Regeln dieselbe SMS abgleichen, veröffentlicht jede von ihnen, sodass die Nachricht auf mehr als einem Broker oder Topic landen kann.

• Regeln gelten nur für Nachrichten, die eintreffen, nachdem die Regel erstellt und aktiviert wurde. Sie verarbeiten keine Nachrichten, die sich bereits im Posteingang befinden.

Inbox Rules

Übersicht über Inbox Rules

Inbox Rules sortieren eingehende Nachrichten automatisch in Ihre benutzerdefinierten Ordner (My Folders), anstatt alles im Hauptpostfach zu belassen.

Wo finde ich diese Funktion

Automation > Folders > Inbox Rules (/automation/inbox-rules/).

Konfigurieren einer Posteingangsregel

Klicken Sie auf Create new rule. Jede Regel kann nach Absendernummer, Nachrichteninhalt oder dem Modem, auf dem die Nachricht empfangen wurde, gefiltert werden. Eine Nachricht, die der Regel entspricht, wird in den von Ihnen gewählten Ordner verschoben.

Regeln werden in Prioritätsreihenfolge überprüft. Ziehen Sie eine Regel mit dem Griff neben ihrer ID nach oben oder unten, um zu steuern, welche Regel zuerst angewendet wird, und vergessen Sie nicht, Ihre Änderungen nach der Neuordnung zu speichern.

Cleanup Folders

Cleanup Folders-Übersicht

Cleanup Folders entfernt automatisch alte Nachrichten aus Ihren Ordnern, damit diese sich nicht unbegrenzt ansammeln.

Wo finde ich diese Funktion

Automation > Folders > Cleanup Folders (/automation/cleanup-folders/).

Konfigurieren einer Bereinigungsregel

Klicken Sie auf Create new rule, legen Sie einen Zeitplan fest (stündlich, täglich, wöchentlich, monatlich oder jährlich), wählen Sie die zu bereinigenden Ordner und das Alter aus, das eine Nachricht haben muss, bevor sie gelöscht wird. Sie können auch optional Modem- und Nachrichtenprotokolle nach dem gleichen Zeitplan bereinigen.