Automatisierung
Dieses Kapitel behandelt den Bereich Automatisierung der Weboberfläche in derselben Reihenfolge wie die Regeln dort angezeigt werden.
Email zu SMS
Mit der Funktion „Email zu SMS“ können Sie eingehende E-Mails als SMS-Nachrichten weiterleiten, entweder an eine Telefonnummer oder an einen Kontakt/eine Gruppe aus Ihrem Adressbuch.
Wo finden Sie es
Die Funktion ist an zwei Stellen in der WebGUI verteilt:
Automation > Email > Email zu SMS (
/automation/email-to-sms) ist der Ort, an dem Sie Weiterleitungsregeln erstellen und verwalten.Einstellungen > Kanäle > Email > Email zu SMS (
/settings/email/email-to-sms) ist der Ort, an dem Sie den Dienst aktivieren und konfigurieren, wie E-Mails in Nachrichten konvertiert werden – siehe Email zu SMS in Einstellungen.
Schritt 1: Verstehen Sie das Format der Empfängeradresse
E-Mails müssen an eine speziell formatierte Adresse gesendet werden, damit SMSEagle weiß, wohin die Nachricht zugestellt werden soll.
So leiten Sie an eine Telefonnummer weiter:
PHONE_NUMBER@ADDRESS_OF_SMSEAGLE_GATEWAY
Beispiel: 999888777@gateway.smseagle.eu
So leiten Sie an einen Kontakt oder eine Gruppe aus dem Adressbuch weiter (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 vollständig qualifizierten Domänennamen verwenden, der unter Einstellungen > Kanäle > Email > Email zu SMS > Erweiterte Einstellungen > FQDN-Hostname festgelegt ist. Wenn dort LDAP-Kontakte verwenden aktiviert ist, werden mit demselben NAME@GATEWAY-Format auch Kontakte und Gruppen aus LDAP/Active Directory aufgelöst.
Standardmäßig wird der Text der E-Mail zum SMS-Text. Dies hängt von der Einstellung Was soll mit dem E-Mail-Betreff geschehen in den Einstellungen ab: Der Betreff kann ignoriert, dem Nachrichtentext vorangestellt, zur Authentifizierung verwendet oder statt des Texts gesendet werden.
Schritt 2: Erstellen Sie eine neue Regel
Gehen Sie zu Automation > Email > Email zu SMS und klicken Sie auf Neue Regel erstellen. Ein Panel mit dem Titel Email-zu-SMS-Regel hinzufügen öffnet sich auf der rechten Seite.
Feld |
Beschreibung |
|---|---|
Regelname * |
Ein Name zur Identifizierung der Regel (erforderlich, max. 100 Zeichen) |
Weiterleiten für * |
Immer senden leitet jede eingehende E-Mail weiter, die dem Adressformat entspricht. Angefügte Absender/Nachricht enthält fügt Filterbedingungen hinzu, siehe Schritt 3. |
Stoppphrase |
Text ab dieser Phrase wird aus der Nachricht entfernt (Groß-/Kleinschreibung beachtet) |
Priorität |
Sendpriorität von 0 bis 5. Nachrichten mit höherer Priorität werden zuerst verarbeitet. |
Anruf nach dem Versand von SMS |
Nein, Nur Klingeln, Ja – Sprachsynthese, oder Ja – Sprachsynthese (erweitert). Die verfügbaren Optionen hängen von der Stimme und den TTS-Fähigkeiten Ihres Geräts ab. |
Sprachmodell |
Stimme für den Sprachsynthese-Anruf. Wird nur bei Geräten angezeigt, die erweiterte TTS unterstützen, und nur nach Auswahl von Ja – Sprachsynthese (erweitert). |
Erzwinge Konvertierung zu UTF-8 |
Erzwingt die Konvertierung des Nachrichtentexts zu UTF-8 |
Gesprächsverlauf entfernen |
Entfernt zitierte Verlaufsangaben der E-Mail-Konversation aus dem Nachrichtentext |
Klicken Sie auf Save, um die Regel zu erstellen, oder auf Cancel, um sie zu verwerfen.
Schritt 3: Filterbedingungen hinzufügen (optional)
Wenn Sie unter Forward for die Option Specified sender / message contains auswählen, stehen drei unabhängige Bedingungen zur Verfügung, jeweils mit einem Kontrollkästchen und einem Textfeld:
When incoming email address contains filtert nach der E-Mail-Adresse des Absenders
When incoming messages subject contains filtert nach der Betreffzeile der E-Mail
When incoming message content contains filtert nach dem E-Mail-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 erscheint als Karte in der Liste „Email to SMS
der Name der Regel
die Weiterleitungsbedingung, z. B. Forward when incoming: email address contains: …, oder Always forward, wenn keine Bedingung festgelegt ist
das für den Versand verwendete Modem
die konfigurierte Stoppphrase
ein Ein-/Ausschalter 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 Name.
Die Auswahl von Regel-Kontrollkästchen zeigt Massenaktionen an: Enable / Disable und Delete.
Mit den Paginierungssteuerelementen unten können Sie zu einer Seite springen und ändern, wie viele Regeln pro Seite angezeigt werden.
Das rechte Hilfefenster erklärt die Formate der Empfängeradresse, mit einer Schaltfläche See more, die auf die Seite dieser Funktion auf smseagle.eu verlinkt.
Email zu SMS Poller
Der Email zu SMS Poller prüft regelmäßig ein externes Postfach über POP3, IMAP oder IMAP mit OAuth2 (Microsoft 365 / Outlook) und konvertiert die dort gefundenen E-Mails gemäß den Email zu SMS Poller-Regeln in SMS-Nachrichten. Im Gegensatz zu Email zu SMS (das seinen eigenen Mail-Server betreibt und aktiv E-Mails empfängt) greift der Poller auf ein vorhandenes Postfach zu, das Sie bereits haben.
Wo finden Sie es
Automation > Email > Email zu SMS Poller (/automation/email-to-sms-poller/) ist der Ort, an dem Sie Regeln erstellen und verwalten. Das Aktivieren des Dienstes und das Verbinden des Postfachs (POP3, IMAP oder IMAP + OAuth2 für Microsoft 365) erfolgt unter Email zu SMS Poller in den Einstellungen.
Eine Regel erstellen
Klicken Sie auf Create new rule. Regeln funktionieren hier genauso wie Email zu SMS-Regeln - benennen Sie die Regel, wählen Sie, ob sie jede gescannte E-Mail weiterleitet oder nur solche, die Bedingungen für Absender/Betreff/Inhalt erfüllen, und legen Sie die gleichen Pro-Regel-Optionen fest (Modem, Stoppphrase, Priorität, Anruf nach dem Senden).
SMS zu Email
Was diese Funktion bewirkt
SMS zu Email leitet eingehende SMS- und MMS-Nachrichten an eine E-Mail-Adresse weiter, damit Sie diese in Ihrem Postfach lesen können, anstatt sich in SMSEagle anzumelden.
Sie erstellen Regeln, die festlegen, welche Nachrichten weitergeleitet werden und wohin sie gehen. Eine Regel kann alles weiterleiten oder nur Nachrichten von bestimmten Absendern oder nur Nachrichten, die einen bestimmten Ausdruck enthalten.
Typische Anwendungsfälle: Weiterleitung von Antworten von Feldpersonal an ein gemeinsames Support-Postfach oder Archivierung von Warnbestätigungen in einem Ticketing-System-Posteingang.
Bevor Sie beginnen
SMSEagle benötigt eine funktionierende Mail-Server-Konfiguration zum Senden 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 sie werden Regeln zwar abgeglichen, aber keine E-Mail kommt an.
Wenn Sie auf Basis von Sender-Kontakten oder -Gruppen weiterleiten möchten, müssen diese Kontakte und Gruppen im Phonebook als Public gekennzeichnet sein.
Schritt 1: SMS zu Email-Seite öffnen
Gehen Sie in der Seitenleiste zu Automation > Email > SMS to Email.
Schritt 2: Eine Regel erstellen
Klicken Sie oben rechts auf Create new rule. Ein Seitenpanel wird geöffnet.
Benennen Sie die Regel
Geben Sie unter Rule name einen aussagekräftigen Namen ein, z. B. Forward all to support. Maximum 100 Zeichen.
Entscheiden Sie, welche Nachrichten weitergeleitet werden sollen
Wählen Sie Forward for:
Option |
Bedeutung |
|---|---|
Always forward |
Jede eingehende SMS und MMS wird weitergeleitet. |
Specified sender / message |
Nur Nachrichten, die den unten festgelegten Bedingungen entsprechen, werden weitergeleitet. |
Wenn Sie Angegebener Absender / Nachricht wählen, sind zwei Bedingungen verfügbar. Sie können eine oder beide verwenden. Wenn Sie beide verwenden, muss eine Nachricht beide erfüllen, um weitergeleitet zu werden.
Wenn eingehende SMS von Aktivieren Sie dies und wählen Sie die Kontakte oder Gruppen aus, deren Nachrichten weitergeleitet werden sollen. Geben Sie zum Suchen etwas ein. Nur öffentliche Kontakte und Gruppen können hier ausgewählt werden.
Wenn eingehender SMS-Text enthält Aktivieren Sie dies und geben Sie die zu suchende Phrase ein, beispielsweise URGENT. Die Phrase kann überall im Nachrichtentext erscheinen. Aktivieren Sie Groß-/Kleinschreibung beachten, wenn urgent und URGENT als unterschiedlich behandelt werden sollen.
Wählen Sie die Ziel-E-Mail-Adresse
Wählen Sie Art der E-Mail-Weiterleitung:
Option |
Bedeutung |
|---|---|
An feste E-Mail-Adresse |
Jede passende Nachricht geht an die eine Adresse, die Sie in Weiterleiten an E-Mail-Adresse eingeben. |
An E-Mail des letzten sendenden Benutzers |
Die Nachricht wird an die E-Mail-Adresse der Person zurückgesendet, 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 Standardmailadresse als Fallback ein, die verwendet wird, wenn kein letzter Absender erfasst ist. |
Legen Sie den E-Mail-Betreff fest
Email subject steuert die Betreffzeile der weitergeleiteten E-Mail. Sie können Platzhalter verwenden, die beim Versenden der E-Mail durch tatsächliche Werte ersetzt werden:
Platzhalter |
Ersetzt durch |
|---|---|
|
Die Telefonnummer, von der die SMS stammt |
|
Die ersten |
|
Die ersten |
Beispiel: SMS from {SENDER}: {WORDS,5} erzeugt einen Betreff wie SMS from +48111222333: Server room temperature alarm triggered. Maximum 150 Zeichen.
Klicken Sie auf Save. Die Regel wird sofort auf neu empfangene Nachrichten angewendet.
SMS Forward
Was diese Funktion bewirkt
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 weitergeben, wie sie angekommen ist, oder sie durch Ihren eigenen Text ersetzen. Sie können auch einen Sprachanruf zusätzlich zur weitergeleiteten SMS hinzufügen, damit eine Benachrichtigung nicht übersehen werden kann.
Typische Anwendungen: Versand von Alarmmeldungen von einer Maschine an das gesamte On-Call-Team, Weitergabe von Nachrichten von einer gemeinsamen Nummer an die gerade zuständige Person oder Umwandlung eines kurzen Maschinencodes in einen verständlichen Satz für das Team.
Bevor Sie beginnen
Die Kontakte und Gruppen, an die Sie weiterleiten, müssen in dem Phonebook existieren. 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 Originalwortlaut oder eine umgeschriebene Nachricht benötigen.
Schritt 1: Öffnen Sie die Seite SMS Forward
Gehen Sie in der Seitenleiste zu Automation > SMS > SMS Forward.
Schritt 2: Eine Regel erstellen
Klicken Sie oben rechts auf Create new rule. Ein Seitenpanel wird geöffnet.
Nennen Sie die Regel und legen Sie ihre Priorität fest
Rule name Eine aussagekräftige Bezeichnung, z. B. Alarms to on-call team. Maximale Länge: 100 Zeichen.
Priority Eine Zahl von 0 bis 9. Nachrichten, die von einer Regel mit höherer Priorität erzeugt werden, werden früher zum Versand eingeplant als Nachrichten von einer Regel mit niedrigerer Priorität. Behalten Sie die Standardeinstellung bei, es sei denn, Sie haben dringende Regeln, die Massenversände überholen müssen.
Entscheiden Sie, welche Nachrichten weitergeleitet werden sollen
Wählen Sie Forward for:
Option |
Bedeutung |
|---|---|
All incoming messages |
Jede eingehende SMS wird weitergeleitet. |
Specified sender / message |
Nur Nachrichten, die den unten festgelegten Bedingungen entsprechen, werden weitergeleitet. |
Wenn Sie Angegebener Absender / Nachricht wählen, sind zwei Bedingungen verfügbar. Sie können eine oder beide verwenden. Wenn Sie beide verwenden, muss eine Nachricht beide erfüllen, um weitergeleitet zu werden.
When incoming SMS comes from Aktivieren Sie diese Option 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 Aktivieren Sie diese Option und geben Sie den Ausdruck unter Text fragment ein, z. B. ALARM. Der Ausdruck kann überall in der Nachricht vorkommen. Aktivieren Sie Case sensitive, wenn alarm und ALARM unterschiedlich behandelt werden sollen.
Legen Sie fest, was die weitergeleitete Nachricht enthalten soll
Verwenden Sie Message content:
Option A: Originalnachricht
Die Empfänger erhalten den eingehenden Text unverändert. Eine zusätzliche Option erscheint: Message header:
Option |
Ergebnis |
|---|---|
Don’t include |
Nur der Originaltext wird weitergeleitet. |
Include sender |
Die Telefonnummer des ursprünglichen Absenders wird zur weitergeleiteten Nachricht hinzugefügt, damit die Empfänger wissen, woher sie kommt. |
Option B: Benutzerdefinierter Text
Die Empfänger erhalten Ihren eigenen Text statt der Originalnachricht. Geben Sie ihn unter Custom message ein (maximale Länge: 500 Zeichen). Sie können Teile der Originalnachricht mit Platzhaltern einfügen:
Platzhalter |
Ersetzt durch |
|---|---|
|
Die Telefonnummer, von der die SMS stammt |
|
Der vollständige Text der Originalnachricht |
Beispiel: Alarm from {SENDER}. Details: {MESSAGE} sendet einen lesbaren Satz, der um den Maschinentext aufgebaut ist.
Wählen Sie die Empfänger
Wählen Sie unter Forward to die Kontakte oder Gruppen aus, die die Nachricht erhalten sollen. Beginnen Sie zu tippen, um zu suchen. Dieses Feld ist erforderlich; eine Regel kann nicht ohne mindestens einen Empfänger gespeichert werden.
Fügen Sie optional einen Sprachanruf hinzu
Call after sending SMS lässt das Gerät auch einen Sprachanruf an dieselben Empfänger tätigen. Die verfügbaren Optionen hängen von Ihrem Gerätemodell ab:
Option |
Was passiert |
|---|---|
No |
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 keine Audioausgabe wiedergegeben. |
Ja – Sprachausgabe |
Das Gerät ruft an und liest den Nachrichtentext vor. |
Ja – Sprachausgabe (erweitert) |
Dasselbe wie oben, mit einer auswählbaren, natürlicheren Stimme. Wählen Sie die Stimme im Feld Voice model aus, das angezeigt wird. |
Wenn Ihr Gerät keine Sprachanrufe unterstützt, ist nur Nein verfügbar.
Klicken Sie auf Save. Die Regel wird sofort auf neu empfangene Nachrichten angewendet.
So funktioniert die Weiterleitung
Die Textbedingung ist eine Contains-Übereinstimmung, keine exakte Übereinstimmung. Eine Regel, die nach
ALARMsucht, leitet eine Nachricht mit dem TextROOM 4 ALARM triggeredweiter.Wenn mehrere Regeln auf die gleiche eingehende Nachricht zutreffen, leitet jede von ihnen separat weiter, sodass Empfänger mehrere SMS erhalten können. Halten Sie die Bedingungen unterschiedlich, um Duplikate zu vermeiden.
Regeln gelten nur für Nachrichten, die nach der Erstellung und Aktivierung der Regel eingehen. Sie verarbeiten keine bereits im Posteingang vorhandenen Nachrichten.
Empfänger können aus ihren eigenen Gründen übersprungen werden: Abwesenheitsmodus im Kontakt, eine Schicht, die derzeit außerhalb ihrer Zeiten liegt (siehe Shifts), oder die Nummer auf der Ablehnungsliste.
Vermeiden Sie Weiterleitungsschleifen. Leiten Sie Nachrichten nicht an eine Nummer weiter, die ihrerseits an Ihr Gerät zurückleitet. Zwei Geräte, die aufeinander verweisen, senden sich gegenseitig immer wieder Nachrichten zu.
Automatische Antworten
Was diese Funktion bewirkt
Autoreplies sendet eine automatische Textantwort auf eingehende SMS-Nachrichten.
Sie erstellen Regeln, die festlegen, welche eingehenden Nachrichten eine Antwort erhalten und wie die Antwort aussieht. Eine Regel kann auf alles antworten oder nur auf Nachrichten von bestimmten Absendern oder nur auf Nachrichten mit einer bestimmten Phrase.
Typische Verwendungen: Bestätigung, dass eine Bestellanfrage eingegangen ist, Benachrichtigung der Personen, dass die Nummer nachts nicht besetzt ist, oder Beantwortung eines Schlüsselwortes mit festen Informationen wie Öffnungszeiten.
Bevor Sie beginnen
Das Gerät muss SMS senden können. Überprüfen Sie, dass mindestens ein Modem angeschlossen und im Netz registriert ist.
Wenn Sie nur auf bestimmte Absender antworten möchten, müssen diese Kontakte und Gruppen im Phonebook als Public gekennzeichnet sein.
Schritt 1: Öffnen Sie die Seite Autoreplies
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 auf alle Regeln angewendet wird und in Schritt 3 beschrieben wird.
Schritt 2: Eine Regel erstellen
Klicken Sie oben rechts auf Create new rule. Ein Seitenpanel wird geöffnet.
Benennen Sie die Regel
Geben Sie in Rule name etwas Aussagekräftiges ein, z. B. Out of hours reply. Maximum 100 Zeichen.
Entscheiden Sie, auf welche Nachrichten geantwortet werden soll
Wählen Sie Send autoreply for:
Option |
Bedeutung |
|---|---|
All incoming messages |
Jede eingehende SMS erhält die Antwort. |
Specified sender / message |
Nur Nachrichten, die die unten festgelegten Bedingungen erfüllen, erhalten eine Antwort. |
Wenn Sie Specified sender / message gewählt haben, werden zwei Bedingungen verfügbar. 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 Aktivieren Sie diese Option und wählen Sie die Kontakte oder Gruppen aus, die eine Antwort erhalten sollen. Beginnen Sie mit der Eingabe zum Suchen. Nur öffentliche Kontakte und Gruppen können hier ausgewählt werden.
Wenn eingehender SMS-Text enthält Aktivieren Sie diese Option und geben Sie den zu suchenden Ausdruck ein, beispielsweise PRICE. Der Ausdruck kann überall im Nachrichtentext vorkommen. Aktivieren Sie Case sensitive, wenn price und PRICE unterschiedlich behandelt werden sollen.
Schreiben Sie die Antwort
Autoreply-Nachricht Der Text, der zurückgesendet wird. Maximal 2000 Zeichen. Derselbe Text wird an alle gesendet, die diese Regel auslösen. Halten Sie ihn daher allgemein.
Als Unicode versenden Aktivieren Sie diese Option, wenn die Antwort Zeichen außerhalb des Standard-GSM-Alphabets enthält, wie polnische, deutsche oder kyrillische Buchstaben. Unicode-Nachrichten passen weniger Zeichen pro SMS-Teil.
Klicken Sie auf Save. Die Regel wird sofort auf neu empfangene Nachrichten angewendet.
Schritt 3: Sendegrenze festlegen
Das Feld Autoreply-Optionen auf der rechten Seite der Seite steuert, wie oft das Gerät bereit ist, dieselbe Telefonnummer automatisch zu beantworten:
Option |
Ergebnis |
|---|---|
Immer automatische Antworten versenden |
Jede übereinstimmende Nachricht erhält eine Antwort, egal wie viele ankommen. |
Versand auf maximal 5 Nachrichten / 10 Minuten / Telefonnummer begrenzen |
Höchstens 5 automatische Antworten gehen innerhalb von 10 Minuten an dieselbe Telefonnummer. Weitere Nachrichten von dieser Nummer werden nicht beantwortet, bis das Zeitfenster verstrichen ist. |
Wählen Sie die gewünschte Option und klicken Sie auf Save.
Es wird dringend empfohlen, die Begrenzung zu verwenden. Ohne diese können zwei Geräte, die beide automatisch antworten, sich gegenseitig in einer Schleife beantworten, was SMS-Guthaben schnell aufbraucht. Die Begrenzung ist der Schutz dagegen.
Diese Einstellung ist global. Sie gilt für alle Autoreply-Regeln auf dem Gerät.
Wie Matching funktioniert
Die Textbedingung ist ein enthält-Match, kein exakter Match. Eine Regel, die nach
PRICEsucht, beantwortet eine Nachricht mitwhat is the PRICE of item 5.Wenn mehrere Regeln auf dieselbe eingehende Nachricht zutreffen, sendet jede von ihnen ihre 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 nach der Erstellung und Aktivierung der Regel eingehen. Sie verarbeiten keine bereits im Posteingang vorhandenen Nachrichten.
Periodische SMS
Was diese Funktion bewirkt
Periodische SMS sendet eine Nachricht automatisch nach einem wiederholten Plan, ohne dass jemand auf Senden klicken muss. Sie erstellen eine Regel einmal, und SMSEagle sendet sie weiterhin jede Stunde, jeden Tag, jede Woche, jeden Monat oder jedes Jahr.
Sie können zwei Dinge planen:
eine SMS an Telefonnummern oder an eine Phonebook-Gruppe, optional gefolgt von einem Telefonanruf,
einen USSD-Code, der an Ihren Mobilfunkanbieter gesendet wird (um beispielsweise das Prepaid-Guthaben der SIM-Karte zu überprüfen).
Typische Anwendungen: eine tägliche „System aktiv“-Nachricht, eine wöchentliche Erinnerung an ein Schichtteam, eine monatliche Guthabenprüfung auf einer Prepaid-SIM.
Bevor Sie beginnen
Wenn Sie an eine Gruppe versenden möchten, muss die Gruppe in Phonebook > Groups vorhanden sein 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 Plan der Gerätezeit folgt. Überprüfen Sie dies in Settings > Date/Time.
Schritt 1: Öffnen Sie die Seite Periodische SMS
Gehen Sie in der Seitenleiste zu Automation > SMS > Periodic SMS. Sie sehen die Liste der Regeln, die Sie bereits haben.
Schritt 2: Eine Regel erstellen
Klicken Sie oben rechts auf Create new rule. Ein Seitenpanel wird geöffnet.
Benennen Sie die Regel
Geben Sie unter Rule name etwas ein, das Sie später erkennen werden, beispielsweise Daily heartbeat oder Monthly SIM balance. Maximal 100 Zeichen.
Den Zeitplan festlegen
Wählen Sie ein Sendungsintervall. Die Felder unterhalb des Selektors ändern sich je nach Ihrer Auswahl:
Intervall |
Was Sie einstellen |
Beispiel |
|---|---|---|
Stündlich |
Bei Minute (in 5-Minuten-Schritten) |
|
Täglich |
Um Zeit |
|
Wöchentlich |
Am Wochentag und Um Zeit |
|
Monatlich |
Am Tag des Monats und Um Zeit |
|
Jährlich |
Am Monat - Tag (Format |
|
Tage, die nicht existieren: Wenn Sie etwas für den 31. Tag eines jeden Monats einplanen, wird es in kürzeren Monaten nicht gesendet. Verwenden Sie den 28. Tag oder früher, wenn die Nachricht jeden Monat gesendet werden muss.
Wählen Sie aus, was gesendet werden soll
Verwenden Sie den Message type Schalter oben in diesem Abschnitt:
Option A: SMS
Geben Sie den Text in SMS Text ein (maximal 2000 Zeichen).
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 fassen.
Wählen Sie unter Send to aus, wohin die Nachricht gesendet wird:
Public groups - geben Sie einen Gruppennamen ein und wählen Sie ihn aus der Liste. 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 Ihren Posteingang.
USSD-Codes werden über das Modem an Ihren Mobilfunkbetreiber gesendet. Die verfügbaren Codes hängen vom Betreiber ab, nicht von SMSEagle.
Fügen Sie optional einen Sprachanruf hinzu
Anruf nach SMS-Versand veranlasst das Gerät auch, einen Sprachanruf an dieselben Empfänger zu tätigen, was für Benachrichtigungen nützlich ist, die nicht übersehen werden dürfen. Die verfügbaren Optionen hängen von Ihrem Gerätemodell ab:
Option |
Was passiert |
|---|---|
No |
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 keine Audioausgabe wiedergegeben. |
Ja – Sprachausgabe |
Das Gerät ruft an und liest den Nachrichtentext vor. |
Ja – Sprachausgabe (erweitert) |
Dasselbe wie oben, mit einer auswählbaren, natürlicheren Stimme. Wählen Sie die Stimme im Feld Voice model aus, das angezeigt wird. |
Wenn Ihr Gerät keine Sprachanrufe unterstützt, ist nur Nein verfügbar.
Klicken Sie auf Save. Die Regel wird in der Liste angezeigt und beginnt zu ihrer nächsten geplanten Zeit auszuführen.
Abos
Was diese Funktion bewirkt
Abos ermöglichen es Personen, sich durch Senden einer SMS zu einer Phonebook-Gruppe anzumelden oder abzumelden, ähnlich wie eine Newsletter-Anmeldung.
Sie definieren zwei Schlüsselwörter: eines, das den Absender zu einer Gruppe hinzufügt, und eines, das sie entfernt. Wenn jemand Ihre SMSEagle-Nummer mit einem dieser Schlüsselwörter anschreibt, wird die Telefonnummer automatisch zur Gruppe hinzugefügt oder entfernt. Sie können dann über Compose, die API oder E-Mail zu SMS Nachrichten an diese Gruppe versenden.
Typische Anwendungen: eine öffentliche Benachrichtigungsliste, bei der sich Einwohner anmelden können, oder eine Benachrichtigungsliste für Schichten, der sich Mitarbeiter selbst anmelden können, ohne dass ein Administrator eingreifen muss.
Bevor Sie beginnen
Erstellen Sie die Gruppe, bei der sich Personen anmelden werden:
Gehen Sie zu Phonebook > Groups.
Klicken Sie auf Add new, geben Sie der Gruppe einen Namen und aktivieren Sie Set as Public Group.
Klicken Sie auf Save.
Nur öffentliche Gruppen können in einer Abonnementregel verwendet werden.
Sie müssen Ihren Benutzern auch mitteilen, welche Nummer sie anschreiben sollen und welches Schlüsselwort sie senden sollen. SMSEagle kündigt dies nicht automatisch an.
Schritt 1: Öffnen Sie die Abos-Seite
Gehen Sie in der Seitenleiste zu Automation > SMS > Subscriptions.
Schritt 2: Eine Regel erstellen
Klicken Sie auf Create new rule in der oberen rechten Ecke. Ein Seitenpanel öffnet sich. Füllen Sie die Felder aus:
Rule name Etwas, das Sie erkennen werden, z. B. Flood alerts opt-in. Maximal 100 Zeichen.
Groups Beginnen Sie mit der Eingabe und wählen Sie eine oder mehrere Gruppen. Abonnenten werden zu allen aufgelisteten Gruppen hinzugefügt oder daraus entfernt. Es können nur öffentliche Gruppen ausgewählt werden.
Telefonnummer zu Gruppen hinzufügen, wenn eingehende Nachricht gleich Das Schlüsselwort, das jemanden abonniert, beispielsweise JOIN oder START ALERTS. Das Schlüsselwort muss für die Abonnementregel eindeutig sein.
Remove phone number from groups, when incoming message equals Das Schlüsselwort, das jemanden abmeldet, z. B. STOP oder LEAVE.
Case sensitive Lassen Sie dies deaktiviert, damit join, Join und JOIN alle funktionieren. Aktivieren Sie es nur, wenn das Schlüsselwort exakt übereinstimmen muss, wie eingegeben.
Klicken Sie auf Save.
Wie Matching funktioniert
Dies ist das wichtigste Detail, das Sie Ihren Benutzern mitteilen müssen:
Die gesamte eingehende Nachricht muss exakt das Schlüsselwort sein. Nichts anderes darf sich in der Nachricht befinden.
Schlüsselwort ist |
Ergebnis |
|---|---|
Benutzer schreibt |
Abonniert |
Benutzer sendet |
Abonniert (es sei denn, Case sensitive ist aktiviert) |
Benutzer sendet |
Nichts passiert |
Benutzer sendet |
Nichts passiert |
Halten Sie Schlüsselwörter daher kurz und leicht zu tippen, und teilen Sie Ihren Benutzern mit, dass sie nur das Schlüsselwort senden sollen.
Was passiert, wenn sich jemand anmeldet
Wenn die Telefonnummer des Absenders bereits im Telefonbuch vorhanden ist, wird dieser vorhandene Kontakt zur Gruppe hinzugefügt.
Wenn die Nummer nicht im Telefonbuch vorhanden ist, erstellt SMSEagle automatisch einen neuen Kontakt dafür. Der Kontakt wird nach der Regel plus 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 Telefonbuch erhalten.
Sie können jederzeit überprüfen, wer beigetreten ist: Gehen Sie zu Phonebook > Groups, suchen Sie die Gruppe und öffnen Sie Manage contacts.
Allow / Deny List
Was diese Funktion bewirkt
Die Allow / Deny List filtert SMS-Verkehr auf Ihrem Gerät nach Telefonnummer.
Sie führen eine Liste mit Nummern und wählen, wie das Gerät damit umgehen soll:
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. Die Liste wird beibehalten, aber nicht verwendet. |
Typische Anwendungsfälle: Blockieren einer Nummer, die das Gerät ständig mit Spam bombardiert (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. Das ermöglicht die Funktion eines Opt-out-Schlüsselworts wie STOP.
Bevor Sie beginnen
Entscheiden Sie, in welche Richtung Sie arbeiten möchten. Allow selected und Deny selected verwenden zwei separate Listen, sodass die Regeln, die Sie in einem Modus hinzufügen, nicht im anderen sichtbar sind. Das Wechseln des Modus wechselt die ganze Liste, es invertiert sie nicht.
Schritt 1: Öffnen Sie die Allow / Deny List-Seite
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 nachfolgend beschrieben.
Schritt 2: Wählen Sie den aktiven Modus
Stellen Sie im Feld Global options die Option Active mode auf Allow selected, Deny selected oder Disabled und klicken Sie auf Save. Die Seite lädt neu und zeigt die Liste, die zu dem gewählten Modus gehört.
Solange der Modus auf Disabled eingestellt ist, zeigt die Seite statt der Liste einen Hinweis „Filtering is disabled“ 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: Eine Nummer hinzufügen
Klicken Sie auf Create new in der oberen rechten Ecke. Ein Seitenpanel wird geöffnet.
Phone number Die Nummer, auf die sich diese Regel bezieht. Maximal 15 Zeichen. Nur Ziffern, + und * sind zulässig, und die Eingabe muss mindestens eine Ziffer enthalten.
Sie können eine ganze Nummernreihe abdecken, indem Sie * als Platzhalter verwenden, der für beliebige Zeichen steht:
Muster |
Stimmt überein mit |
|---|---|
|
Genau diese Nummer |
|
Jede Nummer, die damit endet |
|
Jede Nummer, die damit beginnt |
|
Jede Nummer, die dies enthält |
Beispielsweise deckt 48512* alle Nummern ab, die mit 48512 beginnen, und *12345678 stimmt mit demselben Teilnehmer überein, unabhängig welches Ländervorwahl-Format ankommt.
Description Eine kurze Notiz, die erklärt, warum sich die Nummer in der Liste befindet, z. B. Spam oder Alarm panel, HQ. Erforderlich, maximal 255 Zeichen.
Klicken Sie auf Save.
Schritt 4: Eine Liste aus CSV importieren
Wenn Sie die Nummern bereits in einer Tabellenkalkulation haben, klicken Sie statt sie einzeln hinzuzufügen auf Import rules in der oberen rechten Ecke.
Bereiten Sie eine UTF-8-kodierte CSV-Datei mit genau zwei Spalten vor, mit den Überschriften Number und Reason.
Klicken Sie auf Import rules, ziehen Sie die Datei in den Upload-Bereich oder klicken Sie darauf zum Durchsuchen.
Klicken Sie auf Import.
Die Nummern werden zur derzeit aktiven Liste hinzugefügt.
Schritt 5: Das STOP-Wort konfigurieren (optional)
Das STOP-Wort fügt Absender automatisch zur Liste hinzu, so dass Personen sich durch das Senden eines Schlüsselworts abmelden können.
Klicken Sie im Feld Global options auf Edit config neben STOP word. Ein Seitenpanel wird geöffnet. Wählen Sie Auto add number to list when:
Option |
Bedeutung |
|---|---|
Never |
Das STOP-Wort ist ausgeschaltet. Nummern werden nur manuell oder durch Import hinzugefügt. |
Incoming message equals to… |
Die gesamte Nachricht muss exakt der eingegebenen Phrase entsprechen. |
Eingehende Nachricht enthält… |
Die Phrase kann an beliebiger Stelle in der Nachricht vorkommen. |
Wenn Sie eine der beiden Matching-Optionen wählen, erscheinen zwei weitere Felder:
Die Phrase selbst, maximal 160 Zeichen, zum Beispiel
STOP.Autoreply-Nachricht, maximal 160 Zeichen. Dieser Text wird an die Nummer zurückgesendet, nachdem sie der Liste hinzugefügt wurde. Lassen Sie dieses Feld leer, wenn Sie keine Bestätigung des Opt-out senden möchten.
Klicken Sie auf Save. Die Zusammenfassung im Feld Global options zeigt nun die aktive Bedingung und den Autoreply-Text.
Verwenden Sie „equals“ statt „contains“ für Opt-out-Schlüsselwörter. Mit contains würde eine gewöhnliche Nachricht wie
please stop sending the night reportsden Absender ebenfalls entfernen.
So funktioniert die Filterung
Der Filter wird auf Nachrichten angewendet, die nach der Erstellung und Aktivierung der Regel eintreffen. Er verarbeitet nicht bereits im Posteingang vorhandene Nachrichten erneut.
Eine deaktivierte Regel wird vollständig ignoriert, unabhängig davon, welcher Modus aktiv ist.
Allow selected und Deny selected verwalten 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 Liste, die derzeit aktiv ist.
Workflows
Mit Workflows können Sie flexible Automatisierungsregeln 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-/Sent-/Sending-Error-Ereignis).
Condition – optionale Logik, die bestimmt, 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 Ring-Anrufs, TTS-Anrufs oder Wave-Anrufs.
Wo finden Sie es
Automation > General > Workflows (/automation/workflows/).
Schritt 1: Einen Workflow erstellen und einen Trigger auswählen
Klicken Sie auf Create new, geben Sie dem Workflow einen Name und wählen Sie einen Trigger: Modem, Email, Signal, WhatsApp, Modem (delivered), Modem (sent) oder Modem (sending error).
Schritt 2: Bedingungsgruppen hinzufügen (optional)
Klicken Sie unter Condition groups auf Add group, um eine oder mehrere Bedingungen hinzuzufügen, die das eingehende Ereignis erfüllen muss, bevor der Workflow ausgeführt wird. Lassen Sie dieses Feld leer, wenn der Workflow für jedes Ereignis ausgeführt werden soll, das dem Trigger entspricht.
Schritt 3: Aktionen hinzufügen
Klicken Sie unter Actions auf Add action, um festzulegen, was der Workflow bei der Ausführung tut – zum Beispiel eine Antwort senden, die Nachricht an einen anderen Kanal weiterleiten oder einen Anruf tätigen.
Klicken Sie auf Save workflow, um den Workflow zu aktivieren.
Webhooks
Was diese Funktion bewirkt
Ein Webhook veranlasst SMSEagle, Ihr System aufzurufen. Immer wenn etwas auf dem Gerät geschieht (eine Nachricht kommt an, eine Nachricht wird gesendet, ein Lieferbericht kommt zurück, ein Anruf kommt herein), sendet das Gerät eine HTTP(S)-Anfrage an eine von Ihnen gewählte URL mit den Details als Parameter.
So können Sie SMS-Datenverkehr ohne API-Abfragen in ein Ticketingsystem, ein CRM, einen Chatbot oder Ihre eigene Anwendung übertragen.
Zwei Integrationen erhalten dedizierte Unterstützung:
Methode |
Wofür sie gedacht ist |
|---|---|
POST (3CX) |
Übermittlung von Nachrichten an eine 3CX-Telefonanlage. |
POST (Zabbix) |
Bestätigung von Zabbix-Ereignissen per SMS, damit ein Ingenieur |
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 Endpoint sollte mit HTTP 200 OK oder mit den in der Regel konfigurierten Statuscodes antworten.
Für Zabbix benötigen Sie entweder ein API-Token (Zabbix 6.4 und neuere Versionen) oder einen Benutzernamen und ein Passwort.
Schritt 1: Webhooks-Seite öffnen
Gehen Sie in der Seitenleiste zu Automation > General > Webhooks.
Jede Regel zeigt ihre URL und wofür sie ausgelöst wird. Jede Regel verfügt über einen Schalter zum Aktivieren oder Deaktivieren, eine Edit-Aktion und eine Delete-Aktion.
Das Feld Global options auf der rechten Seite enthält eine Einstellung, die für alle Regeln gilt und in Schritt 6 beschrieben ist.
Schritt 2: Eine Regel erstellen
Klicken Sie auf Create new in der oberen rechten Ecke. Das Webhook-Formular wird als vollständige Seite mit drei Abschnitten geöffnet.
Schritt 3: Grundkonfiguration
Feld |
Was Sie eingeben müssen |
|---|---|
Rule name |
Ein aussagekräftiger Name, maximal 100 Zeichen. |
URL |
Die aufzurufende Adresse, maximal 300 Zeichen, z. B. |
URL method |
GET, POST, POST (3CX) oder POST (Zabbix). |
Content type |
Nur für einfaches POST: FormData oder JSON. |
To (3CX) |
Nur für POST (3CX): das Ziel in Ihrem 3CX-System. |
Klicken Sie auf Test connection neben der URL, um sofort eine Beispielanfrage zu senden. Das Ergebnis wird unterhalb des Feldes angezeigt und zeigt den HTTP-Status, damit Sie bestätigen können, dass der Endpunkt funktioniert, bevor Sie speichern.
Für GET und POST wird unter den Feldern ein Beispiel der Anfrageparameter angezeigt, damit Sie genau sehen können, was Ihr Endpunkt empfängt.
Was die Anfrage enthält
Die Anfrage, die Ihr Endpunkt empfängt, enthält 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 er enthält |
|---|---|
|
Absendernummer. |
|
Zeitpunkt, zu dem SMSEagle die Nachricht empfangen oder gesendet hat, als |
|
Die SMSEagle-Nachrichten-ID. |
|
Das Modem, auf dem die eingehende Nachricht empfangen wurde, oder das Modem, von dem die Nachricht gesendet wurde. |
|
Der API-Schlüssel Ihres Dienstes, falls Sie einen in den Security settings eingestellt haben. Optional. |
Nur für SMS und MMS gesendet
Parameter |
Was er enthält |
|---|---|
|
Inhalt der SMS-Nachricht. |
|
Binärer Inhalt der SMS-Nachricht. |
|
Nachrichtenstatus. |
|
Wert der OID-Kennung, die einer ausgehenden Nachricht mit einer übereinstimmenden Telefonnummer zugewiesen ist. Optional. |
|
MMS-Anhänge, zum Beispiel |
Nur für eingehende Sprachanrufe gesendet
Parameter |
Was er enthält |
|---|---|
|
Status des eingehenden Anrufs: |
Eine Regel wird für einen Ereignistyp ausgelöst, daher enthält eine Anfrage nur jeweils die Parameter dieses Typs. Eine Regel mit dem Trigger Eingehender Anruf sendet beispielsweise niemals text oder attachments.
SMSEagle erwartet unabhängig von der Methode, dass Ihr Endpunkt mit 200 [OK] antwortet, sofern Sie dies nicht mit Expected HTTP Status Code(s) in den Sicherheitseinstellungen erweitern.
Der Link Show Parameter description auf der Seite „rules“ öffnet diese Liste in der Anwendung zusammen mit einer GET-Beispielanfrage:
?sender=48601123123×tamp=20140531092257&msgid=431&modemno=1&text=This+is+an+incoming+message
Parameternamen anpassen
Standardmäßig verwendet die Anfrage die oben aufgelisteten SMSEagle-Parameternamen. Falls Ihr Endpunkt andere erwartet, aktivieren Sie Customize parameter names und geben Sie Ihren Namen neben jedem Parameter ein, den Sie umbenennen möchten. Alle Parameter in den drei Tabellen können umbenannt werden; die, die Sie leer lassen, behalten ihren Standardnamen.
Das Umbenennen ändert nur den Parameter name in der Anfrage, niemals seinen Wert oder den Zeitpunkt seiner Übermittlung.
Schritt 4: Triggerbedingungen
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 versendet. |
Delivery report |
Ein Zustellbericht kommt zurück. |
Sending error |
Eine ausgehende Nachricht ist fehlgeschlagen. |
Incoming call |
Ein Anruf kommt ein. |
Send request when grenzt dies weiter ein:
Option |
Bedeutung |
|---|---|
Always |
Jedes Ereignis des gewählten Typs löst den Webhook aus. |
For specified senders / when text contains |
Nur Ereignisse, die die folgenden Bedingungen erfüllen, lösen ihn aus. |
Wenn Sie die zweite Option gewählt haben, stehen zwei Bedingungen zur Verfügung. Sie können eine oder beide verwenden, und ein Ereignis muss alle aktivierten Bedingungen erfüllen.
When incoming SMS comes from Aktivieren Sie dies und wählen Sie die Kontakte oder Gruppen. Es werden nur öffentliche Kontakte und Gruppen akzeptiert.
When incoming SMS text contains Aktivieren Sie dies und geben Sie die Phrase ein. Aktivieren Sie Case sensitive, wenn Groß- und Kleinschreibung unterschiedlich behandelt werden sollen. Diese Bedingung ist für den Trigger Incoming call nicht verfügbar, da ein Anruf keinen Text hat.
Schritt 5: Sicherheitseinstellungen
Feld |
Zweck |
|---|---|
API key of your 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. |
Erwarteter HTTP-Statuscode(s) |
Welche Antworten gelten als erfolgreich. Ein oder mehrere dreistellige Codes, durch Kommas getrennt, beispielsweise |
Selbstsigniertes SSL-Zertifikat zulassen |
Akzeptieren Sie ein Zertifikat, das nicht von einer öffentlichen Zertifizierungsstelle signiert ist. |
Peer überprüfen |
Überprüfen Sie das Zertifikat des Servers. |
Peer-Namen überprüfen |
Überprüfen Sie, ob 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, werden zusätzliche Felder angezeigt:
Zabbix-Aktion - Acknowledge (ACK), Unacknowledge (NOACK) oder beides. Das Panel zeigt das SMS-Format an, das das Gerät erwartet, beispielsweise
ACK 12345 Problem resolved.Auth-Typ - API Token (Zabbix 6.4 und neuer, empfohlen) oder Anmeldename/Passwort für ältere Versionen. Mit einem Token geben Sie ihn im Feld API-Schlüssel ein; bei Anmeldename geben Sie Zabbix-Benutzername und Zabbix-Passwort ein.
Testwerte - eine Event-ID und Nachricht, die nur von Verbindung testen verwendet werden, werden niemals gespeichert.
Klicken Sie auf Webhook speichern.
Schritt 6: Wiederholungsintervall festlegen
Das Feld Globale Optionen auf der Regelseite enthält Wiederholungsintervall nach fehlgeschlagener Anfrage in Minuten. Wenn eine Anfrage fehlschlägt, wartet das Gerät diese Zeit lang, bevor es erneut versucht.
Geben Sie eine ganze Anzahl von Minuten ein und klicken Sie auf Speichern. Die Einstellung ist global: Sie gilt für alle Webhook-Regeln auf dem Gerät.
Verhalten von Webhooks
Regeln gelten für Ereignisse, die nach dem Erstellen und Aktivieren der Regel auftreten. Sie spielen keine Nachrichten der Vergangenheit ab.
Die Textbedingung ist eine enthält-Abfrage, keine genaue Übereinstimmung.
Wenn mehrere Regeln auf dasselbe Ereignis zutreffen, sendet jede von ihnen ihre eigene Anfrage, sodass eine Nachricht mehrere Endpunkte erreichen kann.
Eine Anfrage gilt 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.
Verbindung testen sendet ein Beispiel-Payload, keine echte Nachricht, daher kann es sicher gegen einen Produktionsendpunkt ausgeführt werden, der nur protokolliert.
MQTT
Was diese Funktion bewirkt
MQTT ist das Nachrichtenprotokoll, 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 Thema wie building/boiler/temperature versehen sind. Jeder, der mit dem Broker verbunden ist, kann die Themen überwachen, die ihn interessieren.
SMSEagle sitzt auf beiden Seiten dieser Konversation:
Regeltyp |
Richtung |
Zweck |
|---|---|---|
Abonnieren |
MQTT in SMS |
Überwacht einen Broker und konvertiert eingehende MQTT-Meldungen in SMS-Nachrichten, die an Ihre Benutzer versendet werden. |
Veröffentlichen |
SMS in MQTT |
Nimmt eingehende SMS-Nachrichten auf und veröffentlicht sie auf einem Broker, damit Ihr IoT-System darauf reagieren kann. |
Typische Anwendungsfälle: Umwandlung einer Sensor-Alarmmeldung in eine SMS an das Wartungsteam (Abonnieren) oder Ermöglichung einer Textnachricht eines Technikers, die vom Automatisierungssystem erfasst wird (Veröffentlichen).
Die beiden Regeltypen werden separat konfiguriert und sind voneinander unabhängig. Verwenden Sie den für Sie benötigten Typ.
Bevor Sie beginnen
Sie benötigen die Verbindungsdetails Ihres MQTT-Brokers: Hostadresse, Port und einen Benutzernamen und ein Passwort, falls der Broker diese erfordert – einmalig konfiguriert unter MQTT in Einstellungen, bevor Sie hier Abonnieren-Regeln schreiben.
Für Abonnieren-Regeln benötigen Sie auch die Liste der zu überwachenden Themen (ebenfalls in Einstellungen definiert). Für Veröffentlichen-Regeln benötigen Sie das Thema, in das veröffentlicht wird (pro Regel festgelegt, unten).
Teil 1: Abonnieren (MQTT in SMS)
Abonnieren-Regeln konvertieren eingehende MQTT-Meldungen in SMS, sobald die Broker-Verbindung selbst unter Einstellungen konfiguriert ist.
Schritt 1: Öffnen Sie die Seite der Abonnieren-Regeln
Gehen Sie in der Seitenleiste zu Automation > Allgemein > MQTT und wählen Sie Abonnieren.
Schritt 2: Erstellen Sie eine Abonnieren-Regel
Klicken Sie oben rechts auf Create new rule. Ein Seitenpanel wird geöffnet.
Benennen Sie die Regel
Geben Sie in Rule name einen aussagekräftigen Namen ein, z. B. Boiler alarm to maintenance. Maximum 100 Zeichen.
Entscheiden Sie, auf welche MQTT-Meldungen reagiert werden soll
Wählen Sie Forward for:
Option |
Bedeutung |
|---|---|
Any message |
Jede MQTT-Meldung, die das Gerät empfängt, löst diese Regel aus. |
Specified topic / message |
Nur Meldungen, die den unten festgelegten Bedingungen entsprechen, lösen die Regel aus. |
Wenn Sie Specified topic / message gewählt haben, stehen zwei Bedingungen zur Verfügung. Sie können eine oder beide verwenden. Wenn Sie beide verwenden, muss eine Meldung beide erfüllen.
When incoming message has topic Aktivieren Sie dies und geben Sie das Thema in Topic ein, z. B. building/boiler.
When incoming message contains Aktivieren Sie dies und geben Sie den Ausdruck in Message phrase ein, z. B. ALARM. Aktivieren Sie Case sensitive, wenn alarm und ALARM als 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 bestimmt, was die SMS aussagt. Sie erstellen ihn aus der MQTT-Meldung mit Platzhaltern:
Platzhalter |
Ersetzt durch |
|---|---|
|
Das Thema, zu dem die MQTT-Nachricht eingetroffen ist |
|
Der Inhalt der MQTT-Nachricht |
Die Standardeinstellung ist {TOPIC}: {MESSAGE}, was eine SMS wie building/boiler/temperature: 94 erzeugt. Sie können auch einen eigenen Satz um diese Elemente 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 diese Funktion nicht für ein einfaches Setup.
Call after sending SMS – platziert auch einen Sprachanruf zu denselben Empfängern. Die Optionen sind No, Ring only, Yes - text to speech und Yes - text to speech (advanced), je nach Modell Ihres Geräts. Mit der erweiterten Option wählen Sie auch ein Voice model.
Klicken Sie auf Save. Die Regel beginnt ab sofort mit MQTT-Nachrichten zu arbeiten.
Wie die Subscribe-Zuordnung funktioniert
Die Topic-Bedingung ist eine contains-Zuordnung und ignoriert Groß- und Kleinschreibung. Eine Regel mit dem Thema
boilerpasst auch zubuilding/boiler/temperature.Das Kontrollkästchen Case sensitive gilt nur für die Nachrichtentextphrase, niemals für das Thema.
Wenn mehrere Subscribe-Regeln auf dieselbe MQTT-Nachricht passen, sendet jede von ihnen ihre eigene SMS.
Teil 2: Publish (SMS in MQTT)
Publish-Regeln verwenden nicht die MQTT-Diensteinstellungen unter Settings. Jede Regel hat ihre eigene Broker-Verbindung, daher können verschiedene Regeln zu verschiedenen Brokern publishen.
Schritt 1: Öffnen Sie die Seite für Publish-Regeln
Gehen Sie in der Seitenleiste zu Automation > General > MQTT und wählen Sie dann Publish.
Schritt 2: Erstellen Sie eine Publish-Regel
Klicken Sie oben rechts auf Create new rule. Ein Seitenpanel wird geöffnet.
Benennen Sie die Regel
Geben Sie unter Rule name einen aussagekräftigen Namen ein, z. B. Technician commands to automation. Maximal 100 Zeichen.
Entscheiden Sie, welche SMS-Nachrichten publishen sollen
Wählen Sie Forward for:
Option |
Bedeutung |
|---|---|
Any message |
Jede eingehende SMS wird zum Broker publishen. |
Specified sender / message |
Nur Nachrichten, die Ihre nachstehenden Bedingungen erfüllen, werden publishen. |
Wenn Sie Specified sender / message gewählt haben, werden die nachstehenden 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 Sender-Kontakte 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 die Textphrase unter Text fragment ein. Aktivieren Sie Case sensitive, wenn Groß- und Kleinschreibung unterschiedlich behandelt werden sollen.
Das Beschränken einer Publish-Regel durch den 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, zu dem diese Regel publishen soll:
Feld |
Was Sie eingeben müssen |
|---|---|
Host |
Die Broker-Adresse, z. B. |
Port |
Der Broker-Port, zum Beispiel |
Benutzername |
Der Broker-Benutzer, falls erforderlich. Lassen Sie dieses Feld leer für einen offenen Broker. |
Passwort |
Das Broker-Passwort, falls erforderlich. |
Thema |
Das Thema, in das veröffentlicht werden soll, zum Beispiel |
TLS/SSL |
Aktivieren Sie diese Option, wenn der Broker eine verschlüsselte Verbindung verwendet. |
TLS-Zertifikatvalidierung |
Lassen Sie diese Option aktiviert, es sei denn, der Broker verwendet ein selbstsigniertes Zertifikat, das das Gerät nicht validieren kann. |
Klicken Sie auf Save. Eingehende SMS-Nachrichten, die der Regel entsprechen, werden ab sofort veröffentlicht.
Funktionsweise der Veröffentlichungsabstimmung
Die Textbedingung ist eine enthält-Abfrage, keine genaue Übereinstimmung.
Wenn mehrere Veröffentlichungsregeln derselben SMS entsprechen, veröffentlicht jede von ihnen, sodass die Nachricht auf mehreren Brokern oder Themen landen kann.
Regeln gelten nur für Nachrichten, die nach der Erstellung und Aktivierung der Regel eingehen. Sie verarbeiten keine bereits im Posteingang vorhandenen Nachrichten.
Inbox-Regeln
Inbox-Regeln sortieren eingehende Nachrichten automatisch in Ihre benutzerdefinierten Ordner (My Folders), anstatt alles in der Hauptablage zu belassen.
Wo finden Sie es
Automation > Folders > Inbox Rules (/automation/inbox-rules/).
Konfigurieren einer Inbox-Regel
Klicken Sie auf Create new rule. Jede Regel kann nach Absendernummer, Nachrichteninhalt oder dem Modem abgestimmt werden, über das die Nachricht eingegangen ist; eine Nachricht, die der Regel entspricht, wird in den von Ihnen gewählten Ordner verschoben.
Regeln werden in der Prioritätsreihenfolge überprüft. Verschieben Sie eine Regel mithilfe des Griffs neben ihrer ID nach oben oder unten, um zu steuern, welche Regel zuerst angewendet wird. Denken Sie daran, Ihre Änderungen nach dem Neuordnen zu speichern.
Ordner bereinigen
Cleanup Folders entfernt alte Nachrichten automatisch aus Ihren Ordnern, damit diese sich nicht unbegrenzt ansammeln.
Wo finden Sie es
Automation > Folders > Cleanup Folders (/automation/cleanup-folders/).
Konfigurieren einer Bereinigungsregel
Klicken Sie auf Create new rule, legen Sie dann einen Zeitplan fest (stündlich, täglich, wöchentlich, monatlich oder jährlich), wählen Sie aus, welche Ordner bereinigt werden sollen, und geben Sie an, wie alt eine Nachricht sein muss, bevor sie gelöscht wird. Sie können optional auch Modem- und Nachrichtenprotokolle nach dem gleichen Zeitplan bereinigen.