Automatyzacja

Ten rozdział obejmuje sekcję Automatyzacja interfejsu web, w tej samej kolejności, w jakiej zasady tam się pojawiają.

Email na SMS

Lista reguł Email to SMS z jedną regułą, obok pola informacyjnego Email to SMS — Reguły Email to SMS

Funkcja Email na SMS umożliwia przekazywanie przychodzących wiadomości e-mail jako SMS na numer telefonu lub kontakt/grupę z Twojej Książki adresowej.

Gdzie to znaleźć

Funkcja jest podzielona na dwa miejsca w WebGUI:

Automation > Email > Email to SMS (/automation/email-to-sms) to miejsce, w którym tworzysz i zarządzasz regułami przekazywania.
Settings > Channels > Email > Email to SMS (/settings/email/email-to-sms) to miejsce, w którym włączasz usługę i konfigurujesz sposób konwersji wiadomości e-mail na wiadomości – zobacz Email to SMS w Settings.

Krok 1: Zapoznaj się z formatem adresu odbiorcy

Wiadomości e-mail muszą być wysłane na specjalnie sformatowany adres, aby SMSEagle wiedział, gdzie dostarczyć wiadomość.

Aby przekazać na numer telefonu:

PHONE_NUMBER@ADDRESS_OF_SMSEAGLE_GATEWAY

Na przykład: 999888777@gateway.smseagle.eu

Aby przekazać na kontakt lub grupę z Książki adresowej (kontakt lub grupa muszą być ustawione jako public):

NAME@ADDRESS_OF_SMSEAGLE_GATEWAY

Na przykład: work@gateway.smseagle.eu

Jeśli nazwa kontaktu lub grupy zawiera spację, użyj jej formy zakodowanej w adresie URL: work%20group@gateway.smseagle.eu

Zamiast adresu IP bramy można użyć w pełni kwalifikowanej nazwy domeny ustawionej w Settings > Channels > Email > Email to SMS > Advanced settings > FQDN hostname. Jeśli tam włączono Use LDAP contacts, ten sam format NAME@GATEWAY również rozpoznaje kontakty i grupy zdefiniowane w LDAP / Active Directory.

Domyślnie treść wiadomości e-mail staje się tekstem SMS. Zależy to od ustawienia What to do with email subject w Settings: temat może być ignorowany, dołączony do tekstu wiadomości, użyty do uwierzytelnienia lub wysłany zamiast treści.

Krok 2: Utwórz nową regułę

Przejdź do Automation > Email > Email to SMS i kliknij Create new rule. Po prawej stronie otwiera się panel zatytułowany Add Email to SMS rule.

Pole	Opis
Rule name *	Nazwa identyfikująca regułę (wymagana, max 100 znaków)
Forward for *	Always send przekazuje każdą przychodzącą wiadomość e-mail pasującą do formatu adresu. Specified sender / message contains dodaje warunki filtrowania, zobacz Krok 3.
Send using modem	Który modem wysyła SMS. Domyślnie Default. Wyświetlane tylko na urządzeniach z więcej niż jednym modemem.
Stop phrase	Tekst rozpoczynający się od tego wariantu zostanie usunięty z wiadomości (z rozróżnianiem wielkości liter)
Priorytet	Priorytet wysyłania od 0 do 5. Wiadomości o wyższym priorytecie są przetwarzane w pierwszej kolejności.
Zadzwoń po wysłaniu SMS	Nie, Tylko dzwonienie, Tak - synteza mowy, lub Tak - synteza mowy (zaawansowana). Dostępne opcje zależą od głosu i możliwości TTS urządzenia.
Model głosu	Głos używany do połączenia syntezy mowy. Wyświetlany tylko dla urządzeń obsługujących zaawansowaną TTS i tylko po wybraniu Tak - synteza mowy (zaawansowana).
Wymuś konwersję do UTF-8	Wymusza konwersję tekstu wiadomości na UTF-8
Usuń historię konwersacji	Usuwa cytowaną historię rozmowy e-mailowej z tekstu wiadomości

Kliknij Save, aby utworzyć regułę, lub Cancel, aby ją odrzucić.

Krok 3: Dodaj warunki filtrowania (opcjonalnie)

Jeśli wybierzesz Specified sender / message contains w pozycji Forward for, staną się dostępne trzy niezależne warunki, każdy z własnym polem wyboru i polem tekstowym:

When incoming email address contains filtruje na podstawie adresu e-mail nadawcy
When incoming messages subject contains filtruje na podstawie wiersza tematu e-maila
When incoming message content contains filtruje na podstawie tekstu wiadomości e-mail

Przełącznik Case sensitive dotyczy wszystkich włączonych warunków.

Możesz włączyć jeden, dwa lub wszystkie trzy warunki. Reguła uruchamia się tylko wtedy, gdy wszystkie włączone warunki są spełnione.

Krok 4: Zarządzaj istniejącymi regułami

Każda reguła pojawia się jako karta na liście Email to SMS, pokazując:

nazwę reguły
warunek forwarding, na przykład Forward when incoming: email address contains: …, lub Always forward, gdy żaden warunek nie jest ustawiony
modem używany do wysyłania
skonfigurowaną frazę stopu
przełącznik włączenia/wyłączenia, aby włączyć lub wyłączyć regułę bez jej usuwania
menu ⋮ z opcjami Edit i Delete

Dodatkowe kontrolki na liście:

Search filtruje reguły według nazwy.
Zaznaczenie pól wyboru reguły ujawnia akcje zbiorcze: Enable / Disable i Delete.
Elementy kontroli stronicowania na dole umożliwiają przejście do strony i zmianę liczby reguł wyświetlanych na stronie.

Panel pomocy po prawej stronie wyjaśnia formaty adresów odbiorców, z przyciskiem See more odsyłającym do strony funkcji na smseagle.eu.

Email to SMS Poller

Email to SMS Poller okresowo sprawdza zewnętrzną skrzynkę pocztową za pośrednictwem POP3, IMAP lub IMAP z OAuth2 (Microsoft 365 / Outlook) i konwertuje znalezione e-maile na wiadomości SMS zgodnie z regułami Email to SMS Poller. W przeciwieństwie do Email to SMS (które uruchamia własny serwer pocztowy i aktywnie odbiera pocztę), Poller nawiązuje połączenie z istniejącą skrzynką pocztową, którą już posiadasz.

Gdzie to znaleźć

Automation > Email > Email to SMS Poller (/automation/email-to-sms-poller/) to miejsce, w którym tworzysz i zarządzasz regułami. Włączenie usługi i połączenie skrzynki pocztowej (POP3, IMAP lub IMAP + OAuth2 dla Microsoft 365) odbywa się w sekcji Email to SMS Poller w Ustawieniach.

Tworzenie reguły

Kliknij Create new rule. Reguły tutaj działają tak samo jak reguły Email to SMS - nazwij regułę, wybierz, czy przekazywać każdy pobrany e-mail, czy tylko e-maile spełniające warunki nadawcy/tematu/zawartości, i ustaw te same opcje dotyczące reguł (modem, fraza zatrzymania, priorytet, połączenie po wysłaniu).

SMS to Email

Co ta funkcja robi

SMS to Email przekazuje przychodzące wiadomości SMS i MMS na adres e-mail, dzięki czemu możesz je czytać w swojej skrzynce pocztowej zamiast logować się do SMSEagle.

Tworzysz reguły, które decydują, które wiadomości są przekazywane i dokąd trafiają. Reguła może przekazywać wszystko lub tylko wiadomości od określonych nadawców, lub tylko wiadomości zawierające określoną frazę.

Typowe zastosowania: przekazywanie odpowiedzi od pracowników terenowych do wspólnej skrzynki pomocy technicznej lub archiwizowanie potwierdzeń alertów do skrzynki odbiorczej systemu zgłoszeń.

Zanim zaczniesz

SMSEagle wymaga działającego serwera pocztowego do wysyłania e-maili. Przejdź do Settings > Channels > Email > SMTP Configuration i upewnij się, że jest wypełniony i przetestowany - zobacz SMTP Configuration. Bez niego reguły będą spełnione, ale e-mail nie dotrze.

Jeśli chcesz przekazywać na podstawie kontaktów lub grup nadawców, te kontakty i grupy muszą być oznaczone jako Public w Phonebook.

Krok 1: Otwórz stronę SMS to Email

Na pasku bocznym przejdź do Automation > Email > SMS to Email.

Krok 2: Utwórz regułę

Kliknij Create new rule w prawym górnym rogu. Otworzy się panel boczny.

Nazwij regułę

W polu Rule name wpisz coś opisowego, na przykład Forward all to support. Maksymalnie 100 znaków.

Zdecyduj, które wiadomości mają być przekazywane

Wybierz Forward for:

Opcja	Co to oznacza
Always forward	Każda przychodzące SMS i MMS jest przekazywana.
Określony nadawca / wiadomość	Tylko wiadomości spełniające poniższe warunki są przekazywane.

Jeśli wybrałeś Określony nadawca / wiadomość, dostępne stają się dwa warunki. Możesz użyć jednego lub obu. Jeśli użyjesz obu, wiadomość musi spełniać oba warunki, aby być przekazana.

Gdy przychodzące SMS pochodzą z Zaznacz to i wybierz kontakty lub grupy, których wiadomości powinny być przekazywane. Zacznij pisać, aby wyszukać. Tutaj można wybrać tylko publiczne kontakty i grupy.

Gdy tekst przychodzącego SMS zawiera Zaznacz to i wpisz frazę do wyszukania, na przykład URGENT. Fraza może pojawić się w dowolnym miejscu tekstu wiadomości. Zaznacz Rozróżniaj wielkość liter, jeśli urgent i URGENT powinny być traktowane jako różne.

Ogranicz regułę do jednego modemu (tylko urządzenia wielomodemowe)

Jeśli Twoje urządzenie ma więcej niż jeden modem, pojawia się pole Gdy wiadomość przybywa do. Zostaw je na Dowolny modem lub wybierz określony modem, aby reguła stosowała się tylko do wiadomości przychodzących na tę kartę SIM. Na urządzeniach jednomodemowych to pole nie jest wyświetlane.

Wybierz docelowy adres e-mail

Wybierz Typ przekazywania e-maila:

Opcja	Co to oznacza
Na stały adres e-mail	Każda pasująca wiadomość trafia na jeden adres, który wprowadzasz w Przekaż na adres e-mail.
Na e-mail ostatniego wysyłającego użytkownika	Wiadomość wraca na adres e-mail osoby, która ostatnio wysłała SMS na ten numer telefonu przez SMSEagle. Zamyka to pętlę w konwersacji e-mail-na-SMS. Wpisz Domyślny adres e-mail jako rezerwę, używany gdy nie ma ostatniego nadawcy w bazie danych.

Ustaw temat e-maila

Temat e-maila kontroluje linię tematu przekazywanego e-maila. Możesz używać symboli zastępczych, które są zastępowane wartościami rzeczywistymi podczas wysyłania e-maila:

Symbol zastępczy	Zastępowany przez
`{SENDER}`	Numer telefonu, z którego pochodzi SMS
`{WORDS,X}`	Pierwszych `X` słów tekstu wiadomości
`{CHARS,X}`	Pierwszych `X` znaków tekstu wiadomości

Przykład: SMS od {SENDER}: {WORDS,5} generuje temat taki jak SMS od +48111222333: Alarm temperatury w serwerowni. Maksymalnie 150 znaków.

Kliknij Save. Reguła zaczyna działać natychmiast na nowo otrzymane wiadomości.

SMS Forward

Co ta funkcja robi

SMS Forward przekazuje przychodzące wiadomości SMS innym osobom. Gdy wiadomość przybywa, SMSEagle wysyła ją ponownie do wybranych odbiorców.

Możesz przekazać wiadomość dokładnie taką, jaką została odebrana, lub zastąpić ją własnym tekstem. Możesz również dodać rozmowę głosową na górze przekazywanego SMS-a, aby alert nie został przespany.

Typowe zastosowania: wysyłanie wiadomości alarmowych z maszyny do całego zespołu dyżurnego, przekazywanie wiadomości z numeru współdzielonego osobie aktualnie pełniącej dyżur lub zamiana krótkiego kodu maszyny na czytelne zdanie dla zespołu.

Zanim zaczniesz

Kontakty i grupy, do których przekazujesz wiadomość, muszą istnieć w Książce adresowej. Kontakty i grupy używane jako odbiorcy przekazania lub jako warunki nadawcy muszą być oznaczone jako Public.
Zdecyduj, czy odbiorcy potrzebują oryginalnego tekstu czy przepisanej wiadomości.

Krok 1: Otwórz stronę SMS Forward

Na pasku bocznym przejdź do Automation > SMS > SMS Forward.

Krok 2: Utwórz regułę

Kliknij Create new rule w prawym górnym rogu. Otworzy się panel boczny.

Nazwij regułę i ustaw jej priorytet

Rule name Coś opisowego, na przykład Alarms to on-call team. Maksymalnie 100 znaków.

Priority Liczba od 0 do 9. Wiadomości wygenerowane przez regułę o wyższym priorytecie są kolejkowane do wysłania wcześniej niż wiadomości z reguły o niższym priorytecie. Zostaw na ustawieniu domyślnym, chyba że masz pilne reguły, które muszą wyprzedzić reguły zbiorcze.

Zdecyduj, które wiadomości mają być przekazywane

Wybierz Forward for:

Opcja	Co to oznacza
All incoming messages	Każdy przychodzący SMS jest przekazywany.
Określony nadawca / wiadomość	Tylko wiadomości spełniające poniższe warunki są przekazywane.

Jeśli wybrałeś Określony nadawca / wiadomość, dostępne stają się dwa warunki. Możesz użyć jednego lub obu. Jeśli użyjesz obu, wiadomość musi spełniać oba warunki, aby być przekazana.

When incoming SMS comes from Zaznacz to i wybierz kontakty nadawcy lub grupy w Sender contacts. Tutaj można wybrać tylko kontakty i grupy public.

When incoming SMS text contains Zaznacz to i wpisz frazę w Text fragment, na przykład ALARM. Fraza może pojawić się w dowolnym miejscu wiadomości. Zaznacz Case sensitive, jeśli alarm i ALARM powinny być traktowane jako różne.

Ogranicz regułę do jednego modemu (tylko urządzenia wielomodemowe)

Jeśli urządzenie ma więcej niż jeden modem, pojawia się pole When messages comes to. Zostaw je na ustawieniu domyślnym lub wybierz konkretny modem, aby reguła dotyczyła tylko wiadomości przychodzących na tę kartę SIM. Na urządzeniach z jednym modemem to pole nie jest wyświetlane.

Wybierz, co mówi przekazywana wiadomość

Użyj Message content:

Opcja A: Oryginalna wiadomość

Odbiorcy otrzymują przychodzący tekst bez zmian. Pojawia się jeden dodatkowy wybór, Message header:

Opcja	Wynik
Don’t include	Tylko oryginalny tekst jest przekazywany.
Include sender	Numer telefonu oryginalnego nadawcy jest dodawany do przekazywanej wiadomości, aby odbiorcy wiedzieli, skąd ona pochodzi.

Opcja B: Tekst niestandardowy

Odbiorcy otrzymują zamiast tego twój własny tekst. Wpisz go w Custom message (maksymalnie 500 znaków). Możesz wciągnąć części oryginalnej wiadomości za pomocą symboli zastępczych:

Symbol zastępczy	Zastępowany przez
`{SENDER}`	Numer telefonu, z którego pochodzi SMS
`{MESSAGE}`	Pełny tekst oryginalnej wiadomości

Przykład: Alarm from {SENDER}. Details: {MESSAGE} wysyła czytelne zdanie zbudowane wokół surowego tekstu maszyny.

Wybierz odbiorców

W Forward to wybierz kontakty lub grupy, które powinny otrzymać wiadomość. Zacznij pisać, aby wyszukać. To pole jest wymagane, reguła nie może być zapisana bez co najmniej jednego odbiorcy.

Opcjonalnie dodaj połączenie telefoniczne

Call after sending SMS powoduje, że urządzenie wykonuje również połączenie głosowe do tych samych odbiorców. Dostępne opcje zależą od modelu urządzenia:

Opcja	Co się dzieje
Nie	Połączenie nie jest wykonywane. To jest ustawienie domyślne.
Tylko dzwonienie	Urządzenie dzwoni do odbiorcy i rozłącza się. Żaden dźwięk nie jest odtwarzany.
Tak – zamiana tekstu na mowę	Urządzenie dzwoni i odczytuje tekst wiadomości.
Tak – zamiana tekstu na mowę (zaawansowana)	Tak jak wyżej, używając wybieralnego, bardziej naturalnego głosu. Wybierz głos w polu Voice model które się pojawi.

Jeśli urządzenie nie obsługuje połączeń głosowych, dostępna jest tylko opcja Nie.

Kliknij Save. Reguła zaczyna działać natychmiast na nowo otrzymane wiadomości.

Jak działa przekazywanie

Warunek tekstowy to dopasowanie zawiera, a nie dokładne dopasowanie. Reguła szukająca ALARM przekazuje wiadomość mówiącą ROOM 4 ALARM triggered.
Jeśli kilka reguł pasuje do tej samej przychodzącej wiadomości, każda z nich przekazuje oddzielnie, więc odbiorcy mogą otrzymać więcej niż jedną SMS-ową. Zachowaj odrębne warunki, aby uniknąć duplikatów.
Reguły mają zastosowanie tylko do wiadomości przychodzących po utworzeniu i włączeniu reguły. Nie przetwarzają one wiadomości już w skrzynce odbiorczej.
Odbiorcy mogą być nadal pominięci z własnych powodów: Vacation mode na kontakcie, zmiana, która jest aktualnie poza godzinami (patrz Shifts), lub numer będący na liście blokowanych.

Unikaj pętli przekazywania. Nie przekazuj wiadomości na numer, który sam przekazuje z powrotem do urządzenia. Dwa urządzenia wskazujące na siebie będą ciągle wysyłać wiadomości tam i z powrotem.

Odpowiedzi automatyczne

Lista reguł autoodpowiedzi z regułą domyślną i opcjami limitu wysyłania — Reguły autoodpowiedzi i opcje limitu wysyłania

Co ta funkcja robi

Autoodpowiedzi wysyłają automatyczną odpowiedź tekstową na przychodzące wiadomości SMS.

Tworzysz reguły, które decydują, które przychodźące wiadomości otrzymają odpowiedź i co ta odpowiedź mówi. Reguła może odpowiadać na wszystko, lub tylko na wiadomości od określonych nadawców, lub tylko na wiadomości zawierające określoną frazę.

Typowe zastosowania: potwierdzenie otrzymania żądania zamówienia, poinformowanie ludzi, że numer jest nienadzorowany w nocy, lub odpowiadanie na słowo kluczowe ustalonymi informacjami, takimi jak godziny otwarcia.

Zanim zaczniesz

Urządzenie musi być w stanie wysyłać SMS. Sprawdź, czy co najmniej jeden modem jest podłączony i zarejestrowany w sieci.
Jeśli chcesz odpowiadać tylko konkretnym nadawcom, te kontakty i grupy muszą być oznaczone jako Public w Phonebook.

Krok 1: Otwórz stronę Autoreplies

Na pasku bocznym przejdź do Automation > SMS > Autoreplies.

Po prawej stronie strony znajduje się pole Autoreply options. Zawiera jedno ustawienie mające zastosowanie do wszystkich reguł, opisane w Krok 3.

Krok 2: Utwórz regułę

Kliknij Create new rule w prawym górnym rogu. Otworzy się panel boczny.

Nazwij regułę

W Rule name wpisz coś opisowego, na przykład Out of hours reply. Maksymalnie 100 znaków.

Zdecyduj, które wiadomości powinny otrzymać odpowiedź

Wybierz Wyślij autoresponder dla:

Opcja	Co to oznacza
All incoming messages	Każda przychodząca SMS otrzyma odpowiedź.
Określony nadawca / wiadomość	Tylko wiadomości spełniające warunki ustawione poniżej otrzymają odpowiedź.

Jeśli wybrałeś Określony nadawca / wiadomość, dostępne będą dwa warunki. Możesz użyć jednego lub obu. Jeśli używasz obu, wiadomość musi spełniać oba warunki, aby otrzymać odpowiedź.

Gdy przychodząca SMS pochodzi od Zaznacz to pole i wybierz kontakty lub grupy, które powinny otrzymać odpowiedź. Zacznij pisać, aby wyszukać. Tutaj można wybrać tylko kontakty i grupy publiczne.

Gdy tekst przychodzącej SMS zawiera Zaznacz to pole i wpisz frazę do wyszukania, na przykład PRICE. Fraza może pojawić się gdziekolwiek w tekście wiadomości. Zaznacz Uwzględnianie wielkości liter, jeśli price i PRICE mają być traktowane jako różne.

Ogranicz regułę do jednego modemu (tylko urządzenia wielomodemowe)

Jeśli urządzenie ma więcej niż jeden modem, pojawi się pole Gdy wiadomości przychodzą do. Pozostaw je na Jakikolwiek modem lub wybierz konkretny modem, aby reguła odpowiadała tylko na wiadomości przychodzące na tę kartę SIM. Na urządzeniach z jednym modemem to pole nie jest wyświetlane.

Napisz odpowiedź

Wiadomość autorespondera Tekst, który jest wysyłany z powrotem. Maksymalnie 2000 znaków. Ten sam tekst trafia do wszystkich, którzy uruchamiają tę regułę, dlatego utrzymuj go ogólny.

Wyślij jako Unicode Zaznacz to, jeśli odpowiedź zawiera znaki spoza standardowego alfabetu GSM, takie jak polskie, niemieckie czy cyrylicę. Wiadomości Unicode mieszczą mniej znaków na część SMS.

Kliknij Save. Reguła zaczyna działać natychmiast na nowo otrzymane wiadomości.

Krok 3: Ustaw limit wysyłania

Pole Opcje autorespondera po prawej stronie strony kontroluje, jak często urządzenie jest skłonne auto-odpowiadać temu samemu numerowi telefonu:

Opcja	Wynik
Zawsze wysyłaj automatyczne odpowiedzi	Każda pasująca wiadomość otrzyma odpowiedź, niezależnie od liczby przychodów.
Ogranicz wysyłanie do maksymalnie 5 wiadomości / 10 minut / numer telefonu	Co najwyżej 5 automatycznych odpowiedzi trafia na ten sam numer telefonu w ciągu 10 minut. Dalsze wiadomości z tego numeru nie są odpowiadane, dopóki nie minie okres czasu.

Wybierz żądaną opcję i kliknij Zapisz.

Zdecydowanie zaleca się używanie limitu. Bez niego dwa urządzenia, które oba wysyłają autoresponder, mogą kończyć się, udzielając sobie nawzajem odpowiedzi w pętli, co szybko zużywa kredyty SMS. Limit jest zabezpieczeniem przed tym.

To ustawienie jest globalne. Dotyczy każdej reguły autorespondera na urządzeniu.

Jak działa dopasowanie

Warunek tekstu to dopasowanie zawiera, a nie dokładne dopasowanie. Reguła szukająca PRICE odpowiada wiadomości mówiącej what is the PRICE of item 5.
Jeśli kilka reguł pasuje do tej samej przychodzącej wiadomości, każda z nich wysyła swoją własną odpowiedź, więc nadawca może otrzymać więcej niż jedną SMS. Utrzymuj warunki oddzielne, jeśli chcesz tylko jedną odpowiedź.
Reguły mają zastosowanie tylko do wiadomości przychodzących po utworzeniu i włączeniu reguły. Nie przetwarzają one wiadomości już w skrzynce odbiorczej.

Okresowe SMS

Dodaj okno dialogowe reguły Periodic SMS z polami interwału, wiadomości i odbiorcy — Dodaj okno dialogowe Periodic SMS

Co ta funkcja robi

Periodic SMS wysyła wiadomość automatycznie zgodnie z harmonogramem powtarzającym się, bez konieczności kliknięcia przez kogoś przycisku Wyślij. Tworzysz regułę raz, a SMSEagle ciągle wysyła ją co godzinę, dzień, tydzień, miesiąc lub rok.

Możesz zaplanować dwie rzeczy:

SMS do numerów telefonu lub do grupy Phonebook, opcjonalnie na którą następuje rozmowa telefoniczna,
kod USSD wysłany do Twojego operatora mobilnego (na przykład w celu sprawdzenia salda przedpłaconej karty SIM).

Typowe zastosowania: dzienna wiadomość „system żyje”, tygodniowe przypomnienie dla zespołu dyżurnego, miesięczne sprawdzenie stanu konta na karcie SIM.

Zanim zaczniesz

Jeśli chcesz wysłać do grupy, grupa musi istnieć w Phonebook > Groups i być oznaczona jako Public. Prywatne grupy nie mogą być tutaj wybierane.
Upewnij się, że zegar urządzenia i strefa czasowa są poprawne, ponieważ harmonogram podlega czasowi urządzenia. Sprawdź to w Settings > Date/Time.

Krok 1: Otwórz stronę Periodic SMS

Na pasku bocznym przejdź do Automation > SMS > Periodic SMS. Zobaczysz listę reguł, które już masz.

Krok 2: Utwórz regułę

Kliknij Create new rule w prawym górnym rogu. Otworzy się panel boczny.

Nazwij regułę

W polu Rule name wpisz coś, co będziesz rozpoznawać później, na przykład Daily heartbeat lub Monthly SIM balance. Maksimum 100 znaków.

Ustaw harmonogram

Wybierz Sending interval. Pola poniżej selektora zmieniają się w zależności od tego, co wybierzesz:

Interwał	Co ustawiasz	Przykład
Hourly	At minute (w krokach 5-minutowych)	`15` wysyła o 00:15, 01:15, 02:15 itd.
Daily	At time	`07:30` wysyła każdego ranka o 07:30
Weekly	At week day i At time	`Monday` + `08:00` wysyła każdego poniedziałku rano
Monthly	At day of month i At time	`1` + `09:00` wysyła pierwszego dnia każdego miesiąca
Annually	At month - day (format `mm-dd`) i At time	`12-24` + `10:00` wysyła każdego 24 grudnia

Dni, które nie istnieją: jeśli zaplanowałeś wysyłkę na 31 dzień każdego miesiąca, nie zostanie wysłana w miesiącach krótszych. Użyj dnia 28 lub wcześniej, jeśli wiadomość musi być wysłana każdego miesiąca.

Wybierz modem (tylko urządzenia wielomodemowe)

Jeśli Twoje urządzenie ma więcej niż jeden modem, pojawi się pole Modem selection. Pozostaw je na wartości domyślnej, aby pozwolić SMSEagle wybrać, lub wybierz określony modem, jeśli wiadomość musi przejść przez konkretną kartę SIM. Na urządzeniach jednoprzewodowych to pole nie jest wyświetlane.

Wybierz, co wysłać

Użyj przełącznika Message type u góry tej sekcji:

Opcja A: SMS

Wpisz tekst w polu SMS Text (maksymalnie 2000 znaków).
Zaznacz Send as Unicode, jeśli tekst zawiera znaki spoza standardowego alfabetu GSM, takie jak litery polskie, niemieckie lub cyrylickie. Pamiętaj, że wiadomości Unicode mieszczą mniej znaków na część SMS.
W sekcji Send to wybierz, dokąd ma trafiać wiadomość:
- Public groups - zacznij pisać nazwę grupy i wybierz ją z listy. Możesz dodać kilka grup.
- Input manually - wpisz numery telefonów. Oddziel wiele numerów przecinkami, na przykład +48111222333,+48444555666.
Musisz wypełnić jedno z tych dwóch pól, w przeciwnym razie reguła nie może być zapisana.

Opcja B: USSD Code

Wpisz kod w polu USSD code, na przykład *100#. Odpowiedź od operatora pojawi się jako przychodząca wiadomość w twojej skrzynce odbiorczej.

Kody USSD są wysyłane przez modem do twojego operatora mobilnego. Dostępne kody zależą od operatora, nie od SMSEagle.

Opcjonalnie dodaj połączenie telefoniczne

Call after sending SMS powoduje, że urządzenie wykonuje również połączenie głosowe do tych samych odbiorców, co jest przydatne dla alertów, które nie mogą zostać przeoczone. Dostępne opcje zależą od modelu twojego urządzenia:

Opcja	Co się dzieje
Nie	Połączenie nie jest wykonywane. To jest ustawienie domyślne.
Tylko dzwonienie	Urządzenie dzwoni do odbiorcy i rozłącza się. Żaden dźwięk nie jest odtwarzany.
Tak – zamiana tekstu na mowę	Urządzenie dzwoni i odczytuje tekst wiadomości.
Tak – zamiana tekstu na mowę (zaawansowana)	Tak jak wyżej, używając wybieralnego, bardziej naturalnego głosu. Wybierz głos w polu Voice model które się pojawi.

Jeśli urządzenie nie obsługuje połączeń głosowych, dostępna jest tylko opcja Nie.

Kliknij Save. Reguła pojawi się na liście i rozpocznie działanie w następnym zaplanowanym czasie.

Subscriptions

Strona reguł subskrypcji, pusty stan z przyciskiem Create new rule — Subscription rules

Co ta funkcja robi

Subskrypcje pozwalają ludziom dołączać i opuszczać grupę z Phonebook poprzez wysłanie SMS, w ten sam sposób jak w przypadku opt-in do biuletynu.

Definiujesz dwa słowa kluczowe: jedno, które dodaje nadawcę do grupy, i jedno, które go usuwa. Gdy ktoś wyśle SMSa na twój numer SMSEagle z jednym z tych słów kluczowych, jego numer telefonu jest automatycznie dodawany lub usuwany z grupy. Następnie możesz wysyłać wiadomości do tej grupy z poziomu Compose, API lub Email to SMS.

Typowe zastosowania: publiczna lista alertów, do której mogą dołączyć mieszkańcy, lub lista powiadomień zmianowych, do której pracownicy mogą dołączyć bez udziału administratora.

Zanim zaczniesz

Utwórz grupę, do której będą dołączać użytkownicy:

Przejdź do Phonebook > Groups.
Kliknij Add new, nadaj grupie nazwę i zaznacz Set as Public Group.
Kliknij Save.

Tylko grupy publiczne mogą być używane w regule subskrypcji.

Musisz również powiedzieć swoim użytkownikom, na jaki numer wysłać wiadomość i jakie słowo kluczowe użyć. SMSEagle nie reklamuje tego automatycznie.

Krok 1: Otwórz stronę Subscriptions

Na pasku bocznym przejdź do Automation > SMS > Subscriptions.

Krok 2: Utwórz regułę

Kliknij Create new rule w prawym górnym rogu. Otworzy się panel boczny. Wypełnij pola:

Rule name Coś, co rozpoznasz, na przykład Flood alerts opt-in. Maksymalnie 100 znaków.

Groups Zacznij pisać i wybierz jedną lub więcej grup. Subskrybenci są dodawani do lub usuwani z wszystkich grup wymienionych tutaj. Można wybrać tylko grupy publiczne.

Dodaj numer telefonu do grup, gdy wiadomość przychodząca równa się Słowo kluczowe, które subskrybuje kogoś, na przykład JOIN lub START ALERTS. Słowo kluczowe musi być unikalne dla reguły subskrypcji.

Usuń numer telefonu z grup, gdy wiadomość przychodząca równa się Słowo kluczowe, które anuluje subskrypcję kogoś, na przykład STOP lub LEAVE.

Rozróżnianie wielkości liter Pozostaw niezaznaczone, aby join, Join i JOIN działały. Zaznacz tylko wtedy, gdy musisz, aby słowo kluczowe dokładnie pasowało do wpisanego tekstu.

Kliknij Save.

Jak działa dopasowanie

To jest najważniejszy szczegół do przekazania użytkownikom:

Cała wiadomość przychodząca musi być dokładnie słowem kluczowym. W wiadomości nie może być nic innego.

Słowo kluczowe to `JOIN`	Wynik
Użytkownik wysyła `JOIN`	Subskrybowane
Użytkownik wysyła `join`	Subskrybowane (chyba że Rozróżnianie wielkości liter jest zaznaczone)
Użytkownik wysyła `Please JOIN me`	Nic się nie dzieje
Użytkownik wysyła `JOIN ALERTS`	Nic się nie dzieje

Z tego powodu utrzymuj słowa kluczowe krótkie i łatwe do wpisania, i powiedz użytkownikom, aby wysyłali tylko słowo kluczowe.

Co się dzieje, gdy ktoś subskrybuje

Jeśli numer telefonu nadawcy znajduje się już w Książce adresowej, istniejący kontakt zostaje dodany do grupy.
Jeśli numer nie znajduje się w Książce adresowej, SMSEagle automatycznie tworzy dla niego nowy kontakt. Kontakt nosi nazwę reguły plus numer telefonu, na przykład Flood alerts opt-in +48111222333, i jest tworzony jako kontakt prywatny.

Gdy ktoś anuluje subskrypcję, zostaje usunięty z grupy, ale sam kontakt pozostaje w Książce adresowej.

Możesz sprawdzić, kto dołączył w dowolnym momencie: przejdź do Phonebook > Groups, znajdź grupę i otwórz Manage contacts.

Lista dozwolonych/zablokowanych

Strona listy dozwolonych/zablokowanych z opcjami trybu aktywnego i słowa STOP — Globalne opcje listy dozwolonych/zablokowanych

Co ta funkcja robi

Lista dozwolonych/zablokowanych filtruje ruch SMS na urządzeniu według numeru telefonu.

Prowadzisz listę numerów i wybierasz, jak urządzenie ją traktuje:

Tryb aktywny	Co się dzieje
Zezwalaj na zaznaczone	Akceptowane są tylko numery z listy. Wszystko inne jest ignorowane.
Deny selected	Numery na liście są ignorowane. Wszystko inne jest akceptowane.
Disabled	Brak filtrowania. Lista jest przechowywana, ale nie jest używana.

Typowe zastosowania: blokowanie numeru, który nieustannie spamuje urządzenie (Deny), lub zablokowanie bramy tak, aby mogły się z nią komunikować tylko własne systemy alarmowe (Allow).

Istnieje również opcja STOP word, która automatycznie dodaje nadawcę do listy, gdy jego wiadomość pasuje do zdefiniowanej frazy. To jest to, co sprawia, że słowo rezygnacji, takie jak STOP, działa.

Zanim zaczniesz

Zdecyduj, w którą stronę chcesz pracować. Allow selected i Deny selected używają dwóch oddzielnych list, więc reguły dodane w jednym trybie nie są widoczne w drugim. Przełączenie trybu przełącza całą listę, nie odwraca jej.

Krok 1: Otwórz stronę Allow / Deny List

Na pasku bocznym przejdź do Automation > General > Allow / Deny List.

Po prawej stronie znajduje się pole Global options zawierające ustawienie Active mode i konfigurację STOP word. Oba zostały opisane poniżej.

Krok 2: Wybierz tryb aktywny

W polu Global options ustaw Active mode na Allow selected, Deny selected lub Disabled, a następnie kliknij Save. Strona się przeładuje i wyświetli listę należącą do wybranego trybu.

Gdy tryb jest Disabled, strona wyświetla powiadomienie „Filtering is disabled” zamiast listy, a reguły nie mogą być dodawane ani edytowane. Przełącz na Allow selected lub Deny selected, aby zarządzać nimi ponownie.

Krok 3: Dodaj numer

Kliknij Create new w prawym górnym rogu. Otwiera się panel boczny.

Phone number Numer, do którego ma zastosowanie ta reguła. Maksymalnie 15 znaków. Dozwolone są tylko cyfry, + i *, a wpis musi zawierać co najmniej jedną cyfrę.

Możesz dopasować cały zakres numerów, używając * jako wildcardu, który reprezentuje dowolne znaki:

Wzorzec	Pasuje do
`NUMBER`	Dokładnie ten numer
`*NUMBER`	Dowolny numer kończący się na niego
`NUMBER*`	Dowolny numer zaczynający się od niego
`NUMBER`	Dowolny numer go zawierający

Na przykład 48512* obejmuje każdy numer zaczynający się od 48512, a *12345678 pasuje do tego samego abonenta niezależnie od tego, jaki format prefiksu kraju przybywa.

Description Krótka notatka wyjaśniająca, dlaczego numer znajduje się na liście, na przykład Spam lub Alarm panel, HQ. Wymagane, maksymalnie 255 znaków.

Kliknij Save.

Krok 4: Importuj listę z pliku CSV

Jeśli numerów już masz w arkuszu kalkulacyjnym, kliknij Import rules w prawym górnym rogu zamiast dodawać je jeden po jednym.

Przygotuj plik CSV zakodowany w UTF-8 z dokładnie dwoma kolumnami, z nagłówkami Number i Reason.
Kliknij Import rules, upuść plik w obszar przesyłania lub kliknij go, aby przeglądać.
Kliknij Import.

Numery są dodawane do aktualnie aktywnej listy.

Krok 5: Skonfiguruj słowo STOP (opcjonalnie)

Słowo STOP automatycznie dodaje nadawców do listy, dzięki czemu osoby mogą zrezygnować, wysyłając słowo kluczowe.

W polu Global options kliknij Edit config obok STOP word. Otworzy się panel boczny. Wybierz Auto add number to list when:

Opcja	Co to oznacza
Never	Słowo STOP jest wyłączone. Numery są dodawane tylko ręcznie lub przez import.
Incoming message equals to…	Cała wiadomość musi być dokładnie frazą, którą wpiszesz.
Incoming message contains to…	Fraza może pojawić się w dowolnym miejscu wiadomości.

Jeśli wybierzesz jedną z dwóch opcji dopasowania, pojawią się dwa dodatkowe pola:

Sama fraza, maksymalnie 160 znaków, na przykład STOP.
Autoreply message, maksymalnie 160 znaków. Ten tekst jest odsyłany do numeru po dodaniu go do listy. Pozostaw puste, jeśli nie chcesz potwierdzać rezygnacji.

Kliknij Save. Podsumowanie w polu Global options teraz pokazuje aktywny warunek i tekst autoodpowiedzi.

Użyj „equals” zamiast „contains” dla słów kluczowych rezygnacji. W przypadku contains, zwykła wiadomość taka jak please stop sending the night reports również usunie nadawcę.

Jak działa filtrowanie

Filtr jest stosowany do wiadomości przychodzących po utworzeniu i włączeniu reguły. Nie przetwarza ponownie wiadomości już w skrzynce odbiorczej.
Wyłączona reguła jest całkowicie ignorowana, niezależnie od tego, który tryb jest aktywny.
Allow selected i Deny selected prowadzą oddzielne listy. Jeśli przełączysz tryb, a strona wygląda na pustą, patrzysz na drugą listę, nic nie zostało usunięte.
Ustawienie słowa STOP jest globalne: dotyczy aktualnie aktywnej listy.

Workflows

Workflows umożliwiają tworzenie elastycznych reguł automatyzacji bez konieczności oddzielnej integracji dla każdej kombinacji wyzwalacza i akcji. Każdy workflow składa się z trzech części:

Trigger - zdarzenie, które uruchamia regułę: przychodząca wiadomość SMS, MMS, email, WhatsApp lub Signal (lub zdarzenie dostarczenia/wysłania/błędu wysyłania modemu).
Condition - opcjonalna logika decydująca, czy reguła powinna działać dla danego zdarzenia.
Action - co się dzieje po uruchomieniu reguły: wysłanie wiadomości SMS, MMS, WhatsApp lub Signal, lub zainicjowanie połączenia ring, TTS lub wave.

Gdzie to znaleźć

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

Krok 1: Utwórz workflow i wybierz wyzwalacz

Kliknij Create new, podaj Name przepływu pracy i wybierz Trigger: Modem, Email, Signal, WhatsApp, Modem (delivered), Modem (sent), lub Modem (sending error).

Krok 2: Dodaj grupy warunków (opcjonalnie)

W sekcji Condition groups kliknij Add group, aby dodać jeden lub więcej warunków, które zdarzenie przychodzące musi spełnić zanim przepływ pracy się uruchomi. Pozostaw to pole puste, jeśli przepływ pracy powinien uruchomić się dla każdego zdarzenia pasującego do triggera.

Krok 3: Dodaj akcje

W sekcji Actions kliknij Add action, aby zdefiniować, co robi przepływ pracy po uruchomieniu – na przykład wysłanie odpowiedzi, przekazanie wiadomości do innego kanału lub wykonanie połączenia.

Kliknij Save workflow, aby go aktywować.

Webhooks

Co ta funkcja robi

Webhook powoduje, że SMSEagle wywołuje Twój system. Za każdym razem, gdy coś się dzieje na urządzeniu (przychodzi wiadomość, wiadomość jest wysłana, powraca raport dostarczenia, przychodzi połączenie), urządzenie wysyła żądanie HTTP(S) do wybranego adresu URL, przesyłając szczegóły jako parametry.

W ten sposób można przesyłać ruch SMS do systemu ticketingowego, CRM-u, chatbota lub własnej aplikacji bez przesyłania ankiet do API.

Dwie integracje otrzymują dedykowane wsparcie:

Metoda	Do czego służy
POST (3CX)	Przesyłanie wiadomości do systemu telefonicznego 3CX.
POST (Zabbix)	Potwierdzanie zdarzeń Zabbix za pomocą SMS, aby inżynier mógł odpowiedzieć `ACK 12345` w celu zamknięcia alertu.

Zanim zaczniesz

Potrzebujesz adresu URL, który będzie odbierać żądania, dostępnego z urządzenia. Adresy lokalne i prywatne są odrzucane.
Twój endpoint powinien odpowiedzieć za pomocą HTTP 200 OK lub ze statusami, które konfigurujesz w regule.
W przypadku Zabbix potrzebujesz tokenu API (Zabbix 6.4 i nowsze) lub nazwy użytkownika i hasła.

Krok 1: Otwórz stronę Webhooks

Na pasku bocznym przejdź do Automation > General > Webhooks.

Każda reguła pokazuje jej adres URL, co ją uruchamia i, na urządzeniach z wieloma modemami, który modem jest do niej ograniczony. Każda reguła ma przełącznik do enable or disable, akcję Edit i akcję Delete.

Pole Global options po prawej stronie zawiera jedno ustawienie, które ma zastosowanie do wszystkich reguł, opisane w Krok 6.

Krok 2: Utwórz regułę

Kliknij Create new w prawym górnym rogu. Formularz webhook otwiera się na całej stronie z trzema sekcjami.

Krok 3: Konfiguracja podstawowa

Pole	Co wpisać
Rule name	Nazwa opisowa, maksymalnie 100 znaków.
URL	Adres do wywołania, maksymalnie 300 znaków, na przykład `https://example.com/webhook`.
Metoda URL	GET, POST, POST (3CX) lub POST (Zabbix).
Typ zawartości	Tylko dla zwykłego POST: FormData lub JSON.
To (3CX)	Tylko dla POST (3CX): miejsce docelowe w systemie 3CX.

Kliknij Test connection obok adresu URL, aby natychmiast wysłać żądanie przykładowe. Wynik pojawia się poniżej pola i informuje o statusie HTTP, który został zwrócony, dzięki czemu możesz potwierdzić, że punkt końcowy działa przed zapisaniem.

Dla GET i POST przykład ciągu żądania jest pokazany poniżej pól, dzięki czemu możesz zobaczyć dokładnie, co otrzyma Twój punkt końcowy.

Co zawiera żądanie

Żądanie, które otrzymuje Twój punkt końcowy, zawiera szczegóły zdarzenia jako parametry. Niektóre są wysyłane dla każdego zdarzenia, inne tylko dla wiadomości lub tylko dla połączeń.

Zawsze wysyłane

Parametr	Co nosi
`sender`	Numer nadawcy.
`timestamp`	Kiedy SMSEagle odbył lub wysłał wiadomość, jako `YYYYmmddHHiiss`, na przykład `20140531092257`.
`msgid`	Identyfikator wiadomości SMSEagle.
`modemno`	Modem, na którym odebrano wiadomość przychodzącą, lub ten, z którego wysłano wiadomość.
`apikey`	Klucz API Twojej usługi, jeśli ustawiłeś go w Security settings. Opcjonalnie.

Wysyłane tylko dla SMS i MMS

Parametr	Co nosi
`text`	Zawartość wiadomości SMS.
`text_binary`	Binarna zawartość wiadomości SMS.
`status`	Status wiadomości.
`oid`	Wartość identyfikatora OID przypisanego do wiadomości wychodzącej z pasującym numerem telefonu. Opcjonalne.
`attachments`	Załączniki MMS, na przykład `[0 => [name => image.png, content-type => image/png, content => wfFWgwOlgBRwdWvsvs=]]`. Tylko POST, ponieważ ciąg zapytania GET nie może zawierać danych pliku. Opcjonalne.

Wysyłane tylko dla przychodzących połączeń głosowych

Parametr	Co nosi
`status`	Status połączenia przychodzącego: `accepted`, `rejected` lub `ignored`.

Reguła uruchamia się dla jednego typu zdarzenia, dlatego żądanie zawiera tylko parametry tego typu. Reguła z wyzwalaczem Incoming call nigdy nie wysyła text ani attachments.

Niezależnie od metody, SMSEagle oczekuje od punktu końcowego odpowiedzi 200 [OK], chyba że rozszerzysz to za pomocą Expected HTTP Status Code(s) w Security settings.

Link Show Parameter description na stronie reguł otwiera tę samą listę wewnątrz aplikacji, wraz z przykładowym żądaniem GET:

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

Dostosowywanie nazw parametrów

Domyślnie żądanie wykorzystuje nazwy parametrów SMSEagle wymienione powyżej. Jeśli punkt końcowy oczekuje innych, zaznacz Customize parameter names i wpisz własną nazwę obok każdego parametru, który chcesz zmienić. Każdy parametr z trzech tabel można zmienić; te, które zostawisz puste, zachowają swoją nazwę domyślną.

Zmiana nazwy zmienia tylko name parametru w żądaniu, nigdy jego wartości ani kiedy jest wysyłane.

Krok 4: Warunki wyzwalacza

Send request for decyduje, które zdarzenie uruchamia webhook:

Opcja	Uruchamia się, gdy
Incoming message	Przychodzi SMS lub MMS.
Sent message	Wiadomość wychodząca została wysłana.
Delivery report	Wraca raport dostarczenia.
Sending error	Wiadomość wychodząca nie powiodła się.
Incoming call	Przychodzi połączenie.

Send request when zawęża to dalej:

Opcja	Co to oznacza
Always	Każde zdarzenie wybranego typu uruchamia webhook.
Dla określonych nadawców / gdy tekst zawiera	Tylko zdarzenia spełniające poniższe warunki je uruchamiają.

Jeśli wybrałeś drugą opcję, dostępne są dwa warunki. Możesz użyć jednego lub obu, a zdarzenie musi spełniać każdy włączony warunek.

Gdy przychodzący SMS pochodzi od Zaznacz to i wybierz kontakty lub grupy. Akceptowane są tylko kontakty publiczne i grupy.

Gdy tekst przychodzącego SMS zawiera Zaznacz to i wpisz frazę. Zaznacz Case sensitive, jeśli wielkość liter ma być traktowana inaczej. Ten warunek nie jest dostępny dla wyzwalacza Incoming call, ponieważ połączenie nie ma tekstu.

Na urządzeniach wielomodułowych When message comes to/from ogranicza regułę do jednego modułu. W przeciwnym razie pozostaw Any modem.

Krok 5: Ustawienia bezpieczeństwa

Pole	Co to robi
API key Twojej usługi	Opcjonalny klucz wysyłany z żądaniem, aby Twój endpoint mógł potwierdzić, że połączenie naprawdę pochodzi z urządzenia.
Oczekiwane kody stanu HTTP	Które odpowiedzi liczą się jako sukces. Jeden lub więcej kodów trzycyfrowych oddzielonych przecinkami, na przykład `200,201,202`. Domyślnie `200`, maksymalnie 20 znaków.
Zezwól na certyfikat SSL z podpisem własnym	Zaakceptuj certyfikat, który nie został podpisany przez publiczny urząd.
Verify peer	Sprawdź certyfikat serwera.
Verify peer name	Sprawdź, czy certyfikat pasuje do nazwy hosta.

Wszystko, co nie odpowiada oczekiwanym kodom stanu, liczy się jako nieudane żądanie i jest ponawiane zgodnie z globalnym interwałem ponawiania.

Reguły Zabbix

Jeśli wybrałeś POST (Zabbix) jako metodę, pojawiają się dodatkowe pola:

Zabbix action - Acknowledge (ACK), Unacknowledge (NOACK) lub oba. Panel pokazuje format SMS, który urządzenie będzie oczekiwać, na przykład ACK 12345 Problem resolved.
Auth type - API Token (Zabbix 6.4 i nowszy, rekomendowany) lub Login/Password dla starszych wersji. Z tokenem wpisujesz go w polu API key; z loginem wpisujesz Zabbix username i Zabbix password.
Test values - Event ID i Message używane tylko przez Test connection, nigdy nie zapisywane.

Kliknij Save webhook.

Krok 6: Ustaw interwał ponawiania

Pole Global options na stronie reguł zawiera Retry interval after failed request w minutach. Gdy żądanie nie powiedzie się, urządzenie czeka przez ten czas przed kolejną próbą.

Wpisz całkowitą liczbę minut i kliknij Save. Ustawienie jest globalne: dotyczy każdej reguły webhooku na urządzeniu.

Jak zachowują się webhooki

Reguły dotyczą zdarzeń zachodzących po utworzeniu i włączeniu reguły. Nie odtwarzają wcześniejszych wiadomości.
Warunek tekstowy jest dopasowaniem contains (zawiera), a nie dopasowaniem dokładnym.
Jeśli kilka reguł pasuje do tego samego zdarzenia, każda z nich wysyła własne żądanie, więc jedna wiadomość może dotrzeć do kilku punktów końcowych.
Żądanie jest uznawane za udane tylko wtedy, gdy kod stanu odpowiedzi jest jednym z Expected HTTP Status Code(s). Wszystko inne, w tym brak odpowiedzi, jest błędem i podlegać będzie ponowieniu.
Test connection wysyła przykładowy ładunek, a nie rzeczywistą wiadomość, więc można go bezpiecznie uruchomić względem produkcyjnego punktu końcowego, który tylko loguje.

MQTT

Co ta funkcja robi

MQTT to protokół komunikacyjny używany przez większość urządzeń IoT, czujników i systemów automatyki budynkowej. Urządzenia wysyłają krótkie wiadomości do brokera, każda oznakowana tematem takim jak building/boiler/temperature. Każdy połączony z brokerem może słuchać interesujących go tematów.

SMSEagle znajduje się po obu stronach tej rozmowy:

Typ reguły	Kierunek	Co to robi
Subscribe	MQTT do SMS	Słucha brokera i zmienia przychodzące wiadomości MQTT na wiadomości SMS wysyłane do Twoich ludzi.
Publish	SMS do MQTT	Przyjmuje przychodzące wiadomości SMS i publikuje je na brokerze, aby Twój system IoT mógł na nie reagować.

Typowe zastosowania: zmiana alarmu czujnika na SMS dla zespołu konserwacji (Subscribe) lub pozwolenie technikom wysyłanie polecenia tekstowego, które jest odbierane przez system automatyki (Publish).

Dwa typy reguł są konfigurowane oddzielnie i nie zależą od siebie. Używaj tego, którego potrzebujesz.

Zanim zaczniesz

Potrzebujesz szczegółów połączenia swojego brokera MQTT: adresu hosta, portu oraz nazwy użytkownika i hasła, jeśli broker ich wymaga - skonfigurowane jednorazowo w sekcji MQTT w Settings, przed napisaniem reguł Subscribe tutaj.

W przypadku reguł Subscribe potrzebujesz również listy tematów do słuchania (również ustawione w Settings). W przypadku reguł Publish potrzebujesz tematu do publikacji (ustawiony dla każdej reguły poniżej).

Część 1: Subscribe (MQTT do SMS)

Reguły Subscribe zamieniają przychodzące wiadomości MQTT na SMS, po skonfigurowaniu samego połączenia brokera w Settings.

Krok 2: Utwórz regułę Subscribe

Kliknij Create new rule w prawym górnym rogu. Otworzy się panel boczny.

Zdecyduj, na które wiadomości MQTT chcesz działać

Wybierz Forward for:

Opcja	Co to oznacza
Any message	Każda wiadomość MQTT, którą urządzenie otrzyma, wyzwala tę regułę.
Określony temat / wiadomość	Tylko wiadomości spełniające poniższe warunki ją wyzwalają.

Jeśli wybrałeś Określony temat / wiadomość, dostępne stają się dwa warunki. Możesz użyć jednego lub obu. Jeśli użyjesz obu, wiadomość musi spełniać oba.

Jeśli wiadomość przychodząca ma temat Zaznacz i wpisz temat w polu Topic, na przykład building/boiler.

Jeśli wiadomość przychodząca zawiera Zaznacz i wpisz frazę w polu Message phrase, na przykład ALARM. Zaznacz Case sensitive, jeśli alarm i ALARM powinny być traktowane jako różne.

Napisz tekst wiadomości SMS

Message format kontroluje zawartość SMS. Budujesz go z wiadomości MQTT, używając elementów zastępczych:

Symbol zastępczy	Zastępowany przez
`{TOPIC}`	Temat, na którym dotarła wiadomość MQTT
`{MESSAGE}`	Zawartość wiadomości MQTT

Domyślna wartość to {TOPIC}: {MESSAGE}, co daje SMS taki jak building/boiler/temperature: 94. Możesz też napisać własne zdanie wokół nich, na przykład Boiler warning on {TOPIC}, value {MESSAGE}.

Zaznacz Send as Unicode, jeśli tekst zawiera znaki spoza standardowego alfabetu GSM, takie jak polskie, niemieckie lub cyryliczne litery.

Opcje zaawansowane

Kliknij Advanced options, aby rozwinąć tę sekcję. Nie potrzebujesz jej do konfiguracji podstawowej.

Modem (tylko urządzenia wielomodemowe) – wyślij SMS przez określoną kartę SIM zamiast domyślnej.
Call after sending SMS – również wyślij połączenie głosowe do tych samych odbiorców. Dostępne opcje to No, Ring only, Yes - text to speech i Yes - text to speech (advanced), w zależności od możliwości Twojego modelu urządzenia. W opcji zaawansowanej wybierasz również Voice model.

Kliknij Save. Reguła zaczyna działać na wiadomościach MQTT otrzymanych od tego momentu.

Część 2: Publish (SMS do MQTT)

Reguły Publish nie używają ustawień serwisu MQTT w Settings. Każda reguła ma własne połączenie z brokerem, więc różne reguły mogą publikować do różnych brokerów.

Krok 1: Otwórz stronę reguł Publish

Na pasku bocznym przejdź do Automation > General > MQTT, a następnie wybierz Publish.

Krok 2: Utwórz regułę Publish

Kliknij Create new rule w prawym górnym rogu. Otworzy się panel boczny.

Nazwij regułę

W polu Rule name wpisz coś opisowego, na przykład Technician commands to automation. Maksymalnie 100 znaków.

Zdecyduj, które wiadomości SMS opublikować

Wybierz Forward for:

Opcja	Co to oznacza
Any message	Każda przychodząca wiadomość SMS jest publikowana do brokera.
Określony nadawca / wiadomość	Tylko wiadomości spełniające poniższe warunki są publikowane.

Jeśli wybrano opcję Specified sender / message, poniższe warunki stają się dostępne. Można je łączyć, a wiadomość musi wtedy spełniać wszystkie włączone warunki.

When incoming SMS comes from Zaznacz to i wybierz kontakty lub grupy nadawców. Tutaj można wybrać tylko kontakty i grupy public.

When incoming SMS text contains Zaznacz to i wpisz frazę w polu Text fragment. Zaznacz opcję Case sensitive, jeśli wielkie i małe litery mają być traktowane inaczej.

When messages comes to (tylko urządzenia wielomodemowe) Pozostaw na Any modem lub wybierz konkretny modem, aby publikować tylko wiadomości przychodzące na tę kartę SIM.

Ograniczenie reguły Publish przez nadawcę to rozsądna ochrona. Bez warunku nadawcy każdy, kto zna twój numer, może wprowadzić zawartość do systemu IoT.

Wprowadź połączenie brokera

Wypełnij brokera, do którego ta reguła publikuje:

Pole	Co wpisać
Host	Adres brokera, na przykład `test.host.io`
Port	Port brokera, na przykład `1883`. Dopuszczalny zakres to 1 do 65535.
Username	Użytkownik brokera, jeśli wymagany. Pozostaw puste dla otwartego brokera.
Password	Hasło do brokera, jeśli wymagane.
Topic	Temat do publikacji, na przykład `smseagle/incoming`
TLS/SSL	Włącz, jeśli broker używa szyfrowanego połączenia.
TLS certificate verification	Pozostaw włączone, jeśli broker nie używa certyfikatu z podpisem własnym, którego urządzenie nie może zweryfikować.

Kliknij Save. Przychodzące wiadomości SMS spełniające regułę są od teraz publikowane.

Jak działa dopasowanie Publish

Warunek tekstowy jest dopasowaniem contains (zawiera), a nie dopasowaniem dokładnym.
Jeśli kilka reguł Publish dopasowuje się do tej samej wiadomości SMS, każda z nich publikuje, więc wiadomość może trafić do więcej niż jednego brokera lub tematu.
Reguły mają zastosowanie tylko do wiadomości przychodzących po utworzeniu i włączeniu reguły. Nie przetwarzają one wiadomości już w skrzynce odbiorczej.

Inbox Rules

Inbox Rules automatycznie sortuje przychodzące wiadomości do niestandardowych folderów (My Folders), zamiast pozostawiać wszystko w głównym Inbox.

Gdzie to znaleźć

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

Konfigurowanie reguły skrzynki odbiorczej

Kliknij Create new rule. Każda reguła może dopasowywać się na podstawie numeru nadawcy, zawartości wiadomości lub modemu, na którym wiadomość dotarła; wiadomość pasująca do reguły jest przenoszana do wybranego folderu.

Reguły są sprawdzane w kolejności priorytetów. Przeciągnij regułę w górę lub w dół za pomocą uchwytu obok jej identyfikatora, aby kontrolować, która reguła jest stosowana jako pierwsza, i pamiętaj, aby zapisać zmiany po zmianie kolejności.

Czyszczenie folderów

Czyszczenie folderów automatycznie usuwa stare wiadomości z Twoich folderów, dzięki czemu nie gromadzą się w nieskończoność.

Gdzie to znaleźć

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

Konfigurowanie reguły czyszczenia

Kliknij Create new rule, następnie ustaw harmonogram (co godzinę, codziennie, co tydzień, co miesiąc lub co rok), wybierz, które foldery wyczyścić, i jak stara musi być wiadomość, zanim zostanie usunięta. Możesz również opcjonalnie wyczyścić dzienniki modemu i wiadomości w tym samym harmonogramie.