Automatyzacja

Ten rozdział obejmuje sekcję Automatyzacja interfejsu internetowego w tej samej kolejności, w jakiej reguły się tam 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 przekierowanie przychodzących wiadomości e-mail jako wiadomości SMS na numer telefonu lub do kontaktu/grupy z Twojego Phonebooka.

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 przekierowywania.
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 na SMS w Ustawieniach.

Krok 1: Zrozumienie formatu adresu odbiorcy

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

Aby przekierować na numer telefonu:

PHONE_NUMBER@ADDRESS_OF_SMSEAGLE_GATEWAY

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

Aby przekierować na kontakt lub grupę z Phonebooka (kontakt lub grupa musi być ustawiona jako publiczna):

NAME@ADDRESS_OF_SMSEAGLE_GATEWAY

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

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

Zamiast adresu IP bramy możesz użyć w pełni kwalifikowaną nazwę domeny ustawioną w Settings > Channels > Email > Email to SMS > Advanced settings > FQDN hostname. Jeśli tam jest włączona opcja Use LDAP contacts, ten sam format NAME@GATEWAY również rozwiązuje kontakty i grupy zdefiniowane w LDAP / Active Directory.

Domyślnie treść wiadomości e-mail staje się tekstem SMS-a. Zależy to od ustawienia What to do with email subject w Ustawieniach: przedmiot może być ignorowany, dołączony na początku tekstu wiadomości, używany do uwierzytelniania 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
Nazwa reguły *	Nazwa do identyfikacji reguły (wymagana, maks. 100 znaków)
Przekieruj dla *	Always send przekierowuje każdą przychodzącą wiadomość e-mail pasującą do formatu adresu. Specified sender / message contains dodaje warunki filtrowania, zobacz Krok 3.
Wyślij za pomocą modemu	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 wyrażenia zostanie usunięty z wiadomości (uwzględnia wielkość 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 konwersji tekstu na mowę. Wyświetlany tylko w urządzeniach obsługujących zaawansowany TTS i tylko po wybraniu opcji Tak - synteza mowy (zaawansowana).
Wymuś konwersję do UTF-8	Wymusza konwersję tekstu wiadomości do UTF-8
Usuń historię konwersacji	Usuwa cytowaną historię konwersacji e-mail 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 sekcji Forward for, dostępne będą trzy niezależne warunki, każdy z własnym polem wyboru i polem tekstowym:

When incoming email address contains filtruje wg adresu e-mail nadawcy
When incoming messages subject contains filtruje wg linii tematu e-mail
When incoming message content contains filtruje wg tekstu treś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 jest uruchamiana 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 zawierająca:

nazwę reguły
warunek przekierowania, na przykład Forward when incoming: email address contains: …, lub Always forward gdy nie ustawiono warunku
modem używany do wysyłania
skonfigurowaną frazę stop
przełącznik włączenia/wyłączenia umożliwiający włączanie lub wyłączanie reguły bez usuwania jej
menu ⋮ z opcjami Edit i Delete

Dodatkowe kontrolki na liście:

Search filtruje reguły wg nazwy.
Zaznaczenie pól reguł ujawnia akcje zbiorcze: Enable / Disable i Delete.
Formanty kontroli paginacji na dole pozwalają przejść do strony i zmienić liczbę reguł wyświetlanych na stronę.

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

Email to SMS Poller

Email to SMS Poller okresowo sprawdza zewnętrzną skrzynkę pocztową przez POP3, IMAP lub IMAP z OAuth2 (Microsoft 365 / Outlook) i konwertuje znalezione wiadomości e-mail 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 łączy się 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 Ustawienia.

Tworzenie reguły

Kliknij Create new rule. Reguły tutaj działają w taki sam sposób jak reguły Email to SMS - nazwij regułę, wybierz czy ma przesyłać każdą pobraną wiadomość e-mail czy tylko te spełniające warunki nadawcy/tematu/zawartości, i ustaw te same opcje dla każdej reguły (modem, fraza stopu, priorytet, połączenie po wysłaniu).

SMS to Email

Co ta funkcja robi

SMS to Email przesyła przychodzące wiadomości SMS i MMS na adres e-mail, aby móc je czytać w swojej skrzynce pocztowej zamiast logować się do SMSEagle.

Tworzysz reguły, które decydują, które wiadomości są przesyłane i gdzie idą. Reguła może przesyłać wszystko, lub tylko wiadomości od określonych nadawców, lub tylko wiadomości zawierające określoną frazę.

Typowe zastosowania: przesyłanie odpowiedzi od pracowników terenowych do współdzielonej skrzynki wsparcia lub archiwizowanie potwierdzeń alertów do skrzynki e-mail systemu biletów.

Przed rozpoczęciem

SMSEagle wymaga działającej konfiguracji serwera pocztowego do wysyłania wiadomości e-mail. Przejdź do Settings > Channels > Email > SMTP Configuration i upewnij się, że jest wypełnione i przetestowane - zobacz SMTP Configuration. Bez tego reguły będą się zgadzać, ale żadna wiadomość e-mail nie dotrze.

Jeśli chcesz przesyłać na podstawie kontaktów lub grup nadawcy, 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ć przesyłane

Wybierz Forward for:

Opcja	Co to oznacza
Always forward	Każda wiadomość 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 są dwa warunki. Możesz użyć jednego lub obu. Gdy użyjesz obu, wiadomość musi spełnić oba, aby być przekazaną.

Gdy wiadomość SMS pochodzi od Zaznacz to i wybierz kontakty lub grupy, których wiadomości powinny być przekazane. Zacznij pisać, aby wyszukać. Tutaj można wybrać tylko publiczne kontakty i grupy.

Gdy tekst wiadomości 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 Czułość na wielkość liter, jeśli urgent i URGENT mają 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ść dociera do. Zostaw je na Dowolny modem lub wybierz określony modem, aby reguła dotyczyła tylko wiadomości przychodzących na tę kartę SIM. Na urządzeniach jednomodeemowych to pole nie jest wyświetlane.

Wybierz docelowy adres e-mail

Wybierz Typ przekazywania poczty e-mail:

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

Ustaw temat e-maila

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

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

Przykład: SMS od {SENDER}: {WORDS,5} tworzy temat taki jak SMS od +48111222333: Alarm temperatury w serwerowni uruchomiony. 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ść przychodzi, SMSEagle wysyła ją dalej do wybranych przez Ciebie odbiorców.

Możesz przekazać wiadomość dokładnie taką, jaka przyszła, lub zastąpić ją własnym tekstem. Możesz także dodać połączenie głosowe na górze przekazanej wiadomości SMS, aby alert nie mógł być przespany.

Typowe zastosowania: wysyłanie komunikatów alarmowych z maszyny do całego zespołu pełniącego dyżur, przekazywanie komunikatów z udostępnionego numeru osobie aktualnie pełniącej dyżur, lub zamienianie krótkiego kodu maszynowego na czytelne zdanie dla zespołu.

Przed rozpoczęciem

Kontakty i grupy, do których wykonujesz przekazywanie, muszą istnieć w Phonebook. Kontakty i grupy używane jako odbiorcy przekazywania lub jako warunki nadawcy muszą być oznaczone jako Public.
Zdecyduj, czy odbiorcy potrzebują oryginalnego sformułowania 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ą umieszczane w kolejce do wysłania wcześniej niż wiadomości z reguły o niższym priorytecie. Pozostaw domyślnie, chyba że masz pilne reguły, które muszą wyprzedzić reguły masowe.

Zdecyduj, które wiadomości mają być przesyłane

Wybierz Forward for:

Opcja	Co to oznacza
All incoming messages	Każda przychodząca wiadomość SMS 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 są dwa warunki. Możesz użyć jednego lub obu. Gdy użyjesz obu, wiadomość musi spełnić oba, aby być przekazaną.

When incoming SMS comes from Zaznacz to pole i wybierz kontakty nadawcy lub grupy w Sender contacts. Tylko public kontakty i grupy mogą być tu wybrane.

When incoming SMS text contains Zaznacz to pole i wpisz frazę w Text fragment, na przykład ALARM. Fraza może pojawić się gdziekolwiek w 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. Pozostaw je na domyślnie, 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 powinna mówić przekazana wiadomość

Użyj Message content:

Opcja A: Oryginalną wiadomość

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

Opcja	Rezultat
Don’t include	Tylko oryginalny tekst jest przekazywany.
Include sender	Numer telefonu oryginalnego nadawcy jest dodany do przekazanej wiadomości, dzięki czemu odbiorcy wiedzą, skąd ona pochodzi.

Opcja B: Tekst niestandardowy

Odbiorcy otrzymują Twój własny tekst zamiast oryginału. Wpisz go w Custom message (maksymalnie 500 znaków). Możesz wciągnąć fragmenty 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 maszynowego.

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 głosowe

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	Nie jest wykonywane żadne połączenie. To jest ustawienie domyślne.
Tylko dzwonienie	Urządzenie dzwoni do odbiorcy i się rozłącza. Żaden dźwięk nie jest odtwarzany.
Tak - synteza mowy	Urządzenie dzwoni i odczytuje tekst wiadomości.
Tak - synteza mowy (zaawansowana)	To samo co powyżej, ale z użyciem 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 przekierowanie

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

Unikaj pętli przekierowań. Nie przekierowuj wiadomości na numer, który sam przekierowuje z powrotem do twojego urządzenia. Dwa urządzenia wskazujące na siebie będą się 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 wiadomości przychodzące otrzymają odpowiedź i co ta odpowiedź będzie zawierać. 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 nie jest obsługiwany w nocy, lub odpowiadanie na słowo kluczowe za pomocą stałych informacji, takich jak godziny otwarcia.

Przed rozpoczęciem

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 na określonych nadawców, 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, które ma 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 mają być obsługiwane

Wybierz Wyślij automatyczną odpowiedź 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 ustawione poniżej warunki otrzymają odpowiedź.

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

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

Gdy tekst przychodzącej SMS zawiera Zaznacz to i wpisz frazę do wyszukania, na przykład PRICE. Fraza może pojawić się w dowolnym miejscu w tekście wiadomości. Zaznacz Rozróżniaj wielkość liter, jeśli price i PRICE 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 Gdy wiadomości przychodzą do. Zostaw je na Dowolny modem lub wybierz określony modem, aby reguła odpowiadała tylko na wiadomości przychodzące na daną kartę SIM. Na urządzeniach z jednym modemem to pole nie jest wyświetlane.

Napisz odpowiedź

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

Wyślij jako Unicode Zaznacz to, jeśli odpowiedź zawiera znaki spoza standardowego alfabetu GSM, takie jak litery polskie, niemieckie lub cyrylickie. 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 automatycznej odpowiedzi po prawej stronie strony kontroluje, jak często urządzenie chce automatycznie odpowiadać temu samemu numerowi telefonu:

Opcja	Rezultat
Zawsze wysyłaj automatyczne odpowiedzi	Każda pasująca wiadomość otrzymuje odpowiedź, niezależnie od tego, ile ich przychodzi.
Ogranicz wysyłanie do maksymalnie 5 wiadomości / 10 minut / numer telefonu	Maksymalnie 5 automatycznych odpowiedzi trafia do tego samego numeru telefonu w ciągu 10 minut. Dalsze wiadomości z tego numeru nie są obsługiwane, dopóki okno się nie zamknie.

Wybierz żądaną opcję i kliknij Save.

Zalecane jest stosowanie limitu. Bez niego dwa urządzenia, które oba automatycznie odpowiadają, mogą skończyć odpowiadając sobie nawzajem w pętli, co szybko zużywa kredyty SMS. Limit jest zabezpieczeniem przed tym.

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

Jak działa dopasowanie

Warunek tekstowy to dopasowanie zawiera, a nie dopasowanie dokładne. Reguła szukająca PRICE odpowiada na wiadomość mówiącą 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 własną odpowiedź, więc nadawca może otrzymać więcej niż jedną SMS. Utrzymuj warunki odrębne, jeśli chcesz tylko jedną odpowiedź.
Reguły dotyczą tylko wiadomości przychodzących po utworzeniu i włączeniu reguły. Nie przetwarzają wiadomości już znajdujące się w skrzynce odbiorczej.

Periodyczne SMS

Okno dialogowe dodawania reguły periodycznej SMS z polami interwału, wiadomości i odbiorcy — Okno dialogowe dodawania reguły periodycznej SMS

Co ta funkcja robi

Periodyczne SMS wysyłają wiadomość automatycznie zgodnie z harmonogramem powtarzającym się, bez konieczności kliknięcia Send przez kogokolwiek. Tworzysz regułę raz, a SMSEagle wysyła ją co godzinę, dzień, tydzień, miesiąc lub rok.

Możesz zaplanować dwie rzeczy:

SMS na numery telefonów lub do grupy z książki adresowej, opcjonalnie następnie połączenie telefoniczne,
kod USSD wysłany do operatora sieci komórkowej (na przykład w celu sprawdzenia salda prepłacone karty SIM).

Typowe zastosowania: dzienna wiadomość „system działa”, cotygodniowe przypomnienie dla zespołu dyżurnego, miesięczna kontrola salda na karcie przedpłaconej.

Przed rozpoczęciem

Jeśli chcesz wysłać do grupy, grupa musi istnieć w Phonebook > Groups i być zaznaczona jako Public. Grupy prywatne nie można tu wybrać.
Upewnij się, że zegar i strefa czasowa urządzenia są prawidłowe, ponieważ harmonogram podąża za czasem 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 rozpoznasz później, na przykład Daily heartbeat lub Monthly SIM balance. Maksymalnie 100 znaków.

Ustaw harmonogram

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

Interval	Co ustawiasz	Przykład
Hourly	At minute (w krokach 5-minutowych)	`15` wysyła o 00:15, 01:15, 02:15 i tak dalej
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żdy poniedziałek 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 zaplanuj coś na 31 dzień każdego miesiąca, nie będzie wysłane w miesiącach, które są krótsze. Użyj dnia 28 lub wcześniej, jeśli wiadomość musi być wysłana co miesiąc.

Wybierz modem (tylko urządzenia z wieloma modemami)

Jeśli twoje urządzenie ma więcej niż jeden modem, pojawia się pole Modem selection. Zostaw je na ustawieniu domyślnym, aby SMSEagle wybrała, lub wybierz konkretny modem, jeśli wiadomość musi przejść przez konkretną kartę SIM. Na urządzeniach z jednym modemem to pole nie jest wyświetlane.

Wybierz co wysłać

Użyj przełącznika Typ wiadomości na górze 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 polskie, niemieckie lub cyrylickie litery. Pamiętaj, że wiadomości Unicode mogą zawierać mniej znaków na jedną część SMS.
W sekcji Send to wybierz, dokąd ma trafić wiadomość:
- Public groups - zacznij wpisywać 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 dwóch pól, w przeciwnym razie reguła nie może być zapisana.

Opcja B: Kod USSD

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

Kody USSD są wysyłane przez modem do Twojego operatora komórkowego. Dostępne kody zależą od operatora, a nie od SMSEagle.

Opcjonalnie dodaj połączenie głosowe

Call after sending SMS powoduje, że urządzenie wykonuje również połączenie głosowe do tych samych odbiorców, co jest przydatne w alertach, których nie można pominąć. Dostępne opcje zależą od modelu urządzenia:

Opcja	Co się dzieje
Nie	Nie jest wykonywane żadne połączenie. To jest ustawienie domyślne.
Tylko dzwonienie	Urządzenie dzwoni do odbiorcy i się rozłącza. Żaden dźwięk nie jest odtwarzany.
Tak - synteza mowy	Urządzenie dzwoni i odczytuje tekst wiadomości.
Tak - synteza mowy (zaawansowana)	To samo co powyżej, ale z użyciem 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 zacznie działać w następnym zaplanowanym czasie.

Subskrypcje

Strona reguł subskrypcji, pusty stan z przyciskiem Create new rule — Reguły subskrypcji

Co ta funkcja robi

Subskrypcje umożliwiają ludziom dołączenie do grupy Phonebook i opuszczenie jej poprzez wysłanie SMS, podobnie jak funkcja opt-in w newsletterze.

Definiujesz dwa słowa kluczowe: jedno dodające nadawcę do grupy i jedno je usuwające. Gdy ktoś wyśle SMS do Twojego numeru SMSEagle z jednym z tych słów kluczowych, jego numer telefonu jest automatycznie dodawany do grupy lub usuwany z niej. 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, na którą mogą się zapisać mieszkańcy, lub lista powiadomień zmianowych, do której pracownicy mogą się dołączyć sami bez administratora.

Przed rozpoczęciem

Utwórz grupę, do której będą się subskrybować 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ż poinformować użytkowników, na jaki numer wysłać wiadomość i jakie słowo kluczowe użyć. SMSEagle nie robi tego automatycznie.

Krok 1: Otwórz stronę Subskrypcji

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 się będzie pamiętać, na przykład Flood alerts opt-in. Maksymalnie 100 znaków.

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

Dodaj numer telefonu do grup, gdy wiadomość przychodzącą równa się Słowo kluczowe, które zapisuje 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 jest równa Słowo kluczowe, które wypisuje kogoś, na przykład STOP lub LEAVE.

Rozróżniaj wielkość liter Pozostaw niezaznaczone, aby join, Join i JOIN wszystkie działały. Zaznacz tylko wtedy, gdy słowo kluczowe musi dokładnie odpowiadać wpisanemu tekstowi.

Kliknij Save.

Jak działa dopasowanie

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

Cała wiadomość przychodząca musi być dokładnie słowem kluczowym. Nic więcej nie może być w wiadomości.

Słowo kluczowe to `JOIN`	Rezultat
Użytkownik wysyła `JOIN`	Zasubskrybowany
Użytkownik wysyła `join`	Zasubskrybowany (chyba że Rozróżniaj wielkość 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 wybieraj krótkie i łatwe do wpisania słowa kluczowe i powiedz użytkownikom, aby wysyłali tylko słowo kluczowe.

Co się dzieje, gdy ktoś się subskrybuje

Jeśli numer telefonu nadawcy jest już w Książce adresowej, istniejący kontakt jest dodawany 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ś się wypisuje, jest usuwany z grupy, ale sam kontakt pozostaje w Książce adresowej.

W dowolnym momencie możesz sprawdzić, kto się zapisał: przejdź do Phonebook > Groups, znajdź grupę i otwórz Manage contacts.

Lista dozwolonych / niedozwolonych

Strona Allow / Deny List z opcjami globalnym trybem Active i słowem STOP — Globalne opcje listy dozwolonych / niedozwolonych

Co ta funkcja robi

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

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

Tryb aktywny	Co się dzieje
Zezwalaj wybranemu	Przyjmowane są tylko numery na liście. Wszystko inne jest ignorowane.
Zabroń wybranemu	Numery na liście są ignorowane. Wszystko inne jest przyjmowane.
Wyłączone	Brak filtrowania. Lista jest zachowywana, ale nie jest używana.

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

Istnieje również opcja STOP word, która automatycznie dodaje nadawcę do listy, gdy jego wiadomość jest zgodna ze zdefiniowaną frazą. To jest to, co powoduje działanie słowa kluczowego opt-out, takiego jak STOP.

Przed rozpoczęciem

Zdecyduj, w jaki sposób chcesz pracować. Allow selected i Deny selected wykorzystują dwie oddzielne listy, 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 są 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 przeładuje się, wyświetlając listę należącą do wybranego trybu.

Gdy tryb to Disabled, strona wyświetla komunikat „Filtering is disabled

Krok 3: Dodaj numer

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

Phone number Numer, do którego odnosi się 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 symbolu wieloznacznego, który reprezentuje dowolne znaki:

Wzór	Dopasowuje
`NUMBER`	Dokładnie ten numer
`*NUMBER`	Dowolny numer kończący się na nim
`NUMBER*`	Dowolny numer zaczynający się na nim
`NUMBER`	Dowolny numer zawierający go

Na przykład 48512* obejmuje każdy numer zaczynający się od 48512, a *12345678 dopasowuje tego samego abonenta niezależnie od formatu prefiksu kraju, który przychodzi.

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: Zaimportuj listę z CSV

Jeśli masz już numery 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 dwiema kolumnami, zatytułowanymi Number i Reason.
Kliknij Import rules, upuść plik do obszaru 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 dodaje nadawców do listy automatycznie, 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 tą 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 wysyłany zwrotnie do numeru po dodaniu go do listy. Pozostaw puste, jeśli nie chcesz potwierdzać rezygnacji.

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

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

Jak działa filtrowanie

Filtr jest stosowany do wiadomości przychodzących po utworzeniu i włączeniu reguły. Nie przeprocesowuje wiadomości już znajdujących się w skrzynce odbiorczej.
Wyłączona reguła jest całkowicie ignorowana, niezależnie od aktywnego trybu.
Allow selected i Deny selected prowadzą oddzielne listy. Jeśli zmienisz tryb i strona wygląda na pustą, patrzysz na inną listę — nic nie zostało usunięte.
Ustawienie słowa STOP jest globalne: dotyczy aktualnie aktywnej listy.

Workflows

Workflows pozwalają budować elastyczne reguły automatyzacji bez potrzeby osobnej 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ące SMS, MMS, email, WhatsApp lub Signal (lub zdarzenie modemu dotyczące dostarczenia/wysłania/błędu wysyłania).
Condition - opcjonalna logika decydująca, czy reguła powinna zostać uruchomiona dla danego zdarzenia.
Action - co się dzieje, gdy reguła zostaje uruchomiona: wysłanie SMS, MMS, WhatsApp lub Signal, lub inicjacja 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 dla 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ć przed uruchomieniem przepływu pracy. Pozostaw puste, jeśli przepływ pracy powinien działać 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, przekierowanie wiadomości na inny kanał lub odebranie połączenia.

Kliknij Save workflow, aby aktywować go.

Webhooks

Co ta funkcja robi

Webhook powoduje, że SMSEagle wywołuje Twój system. Za każdym razem, gdy coś się stanie na urządzeniu (nadejdzie wiadomość, wiadomość zostanie wysłana, powróci raport dostarczenia, przyjdzie połączenie), urządzenie wysyła żądanie HTTP(S) na wybrany przez Ciebie adres URL, zawierające szczegóły jako parametry.

Dzięki temu można pushować ruch SMS do systemu ticketów, CRM, chatbota lub własnej aplikacji bez konieczności odpytywania API.

Dwie integracje otrzymują dedykowane wsparcie:

Metoda	Do czego służy
POST (3CX)	Pushowanie wiadomości do systemu telefonicznego 3CX.
POST (Zabbix)	Potwierdzanie zdarzeń Zabbix przez SMS, dzięki czemu inżynier może odpowiedzieć `ACK 12345`, aby zamknąć alert.

Przed rozpoczęciem

Potrzebujesz adresu URL, który będzie odbierać żądania, osiągalnego z urządzenia. Adresy lokalne i prywatne są odrzucane.
Twój endpoint powinien odpowiedzieć kodem HTTP 200 OK lub z jakimikolwiek kodami stanu, które skonfigurujesz 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 wyświetla jej adres URL, dla czego się uruchamia i, na urządzeniach wielomodemowych, do którego modemu jest ograniczona. Każda reguła ma przełącznik do włączenia lub wyłączenia, 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ę jako pełna strona z trzema sekcjami.

Krok 3: Konfiguracja podstawowa

Pole	Co wpisać
Rule name	Opisowa nazwa, 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.
Do (3CX)	Tylko dla POST (3CX): miejsce docelowe w systemie 3CX.

Kliknij Test connection obok adresu URL, aby natychmiast wysłać żądanie próbne. Wynik pojawi się poniżej pola i pokaże otrzymany kod stanu HTTP, dzięki czemu można potwierdzić, że punkt końcowy działa, zanim zapiszesz.

Dla GET i POST przykład ciągu żądania pokazany jest poniżej pól, aby dokładnie zobaczyć, 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`	Gdy SMSEagle odebrał 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 modem, z którego wysłano wiadomość.
`apikey`	Klucz API Twojej usługi, jeśli ustawiłeś go w Ustawieniach bezpieczeństwa. 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 przypisana do wiadomości wychodzące 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ż łańcuch zapytania GET nie może zawierać danych pliku. Opcjonalne.

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

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

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

Niezależnie od metody, SMSEagle oczekuje od Twojego punktu końcowego odpowiedzi 200 [OK], chyba że rozszerzysz to z użyciem Expected HTTP Status Code(s) w Ustawieniach bezpieczeństwa.

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 używa nazw parametrów SMSEagle wymienionych powyżej. Jeśli Twój punkt końcowy oczekuje innych, zaznacz Customize parameter names i wpisz swoją własną nazwę obok każdego parametru, który chcesz zmienić. Każdy parametr z trzech tabel można zmienić; te, które pozostawisz puste, zachowają swoją domyślną nazwę.

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

Krok 4: Warunki wyzwalania

Send request for decyduje, które zdarzenie aktywuje 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 go uruchamiają.

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

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

Gdy tekst przychodzącej SMS zawiera Zaznacz to i wpisz frazę. Zaznacz Case sensitive jeśli należy traktować wielkie i małe litery jako różne. Ten warunek nie jest dostępny dla wyzwalacza Incoming call, ponieważ połączenie nie ma tekstu.

Na urządzeniach wielomodemowych, When message comes to/from ogranicza regułę do jednego modemu. W przeciwnym razie pozostaw Any modem.

Krok 5: Ustawienia bezpieczeństwa

Pole	Co robi
Klucz API Twojej usługi	Opcjonalny klucz wysyłany z żądaniem, dzięki czemu punkt końcowy może zweryfikować, że połączenie naprawdę pochodzi z Twojego urządzenia.
Oczekiwany kod(y) statusu HTTP	Które odpowiedzi liczą się jako powodzenie. Jeden lub więcej trzycyfrowych kodów 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 jest podpisany przez publiczny urząd.
Weryfikuj partnera	Sprawdź certyfikat serwera.
Weryfikuj nazwę partnera	Sprawdź, czy certyfikat jest zgodny z nazwą hosta.

Wszystko, co nie odpowiada oczekiwanym kodom statusu, liczą się jako żądanie nie powiodło się i jest ponawiane zgodnie z globalnym interwałem ponowień.

Reguły Zabbix

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

Zabbix action - Acknowledge (ACK), Unacknowledge (NOACK) lub obie. Panel pokazuje format SMS, którego oczekuje urządzenie, na przykład ACK 12345 Problem resolved.
Auth type - API Token (Zabbix 6.4 i nowsze, zalecane) lub Login/Password dla starszych wersji. Z tokenem wpisujesz go w pole API key; przy logowaniu wpisujesz Zabbix username i Zabbix password.
Test values - Event ID i Message używane tylko przez Test connection, nigdy niebuforowane.

Kliknij Save webhook.

Krok 6: Ustaw interwał ponowienia

Pole Global options na stronie reguł zawiera Retry interval after failed request, w minutach. Gdy żądanie się nie powiedzie, urządzenie czeka tyle czasu, zanim spróbuje ponownie.

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

Jak działają webhooks

Reguły dotyczą zdarzeń zachodzących po utworzeniu i włączeniu reguły. Nie odtwarzają one przeszłych wiadomości.
Warunek tekstowy to dopasowanie typu contains (zawiera), a nie dokładne dopasowanie.
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 liczy się jako pomyślne tylko wtedy, gdy kod statusu odpowiedzi jest jednym z Expected HTTP Status Code(s) (Oczekiwanych kodów statusu HTTP). Wszystko inne, w tym brak odpowiedzi, jest niepowodzeniem i zostaje ponowione.
Test connection (Testuj połączenie) wysyła przykładowy ładunek, a nie rzeczywistą wiadomość, więc bezpiecznie można go uruchomić na produkacyjnym punkcie końcowym, który tylko rejestruje.

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 oznaczona tematem (topic) takim jak building/boiler/temperature. Każdy podłączony do brokera może nasłuchiwać interesujących go tematów.

SMSEagle znajduje się po obu stronach tej rozmowy:

Typ reguły	Kierunek	Co robi
Subscribe	MQTT do SMS	Nasłuchuje brokera i przekształca przychodzące wiadomości MQTT w wiadomości SMS wysyłane do Twoich użytkowników.
Publish	SMS do MQTT	Pobiera przychodzące wiadomości SMS i publikuje je do brokera, aby Twój system IoT mógł na nich zareagować.

Typowe zastosowania: przekształcenie alarmu czujnika w SMS dla zespołu serwisowego (Subscribe) lub umożliwienie technikowi wysłania polecenia tekstem, które zostanie odebrane przez system automatyki (Publish).

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

Przed rozpoczęciem

Potrzebujesz szczegółów połączenia brokera MQTT: adresu hosta, portu oraz nazwy użytkownika i hasła, jeśli broker ich wymaga – skonfigurowane raz w sekcji MQTT w Settings, zanim napiszesz tutaj reguły Subscribe.

W przypadku reguł Subscribe potrzebna jest również lista tematów do nasłuchiwania (również ustawiona w Settings). W przypadku reguł Publish potrzebny jest temat do publikowania (ustawiony dla każdej reguły poniżej).

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

Reguły Subscribe przekształcają przychodzące wiadomości MQTT w SMS, gdy samo połączenie brokera jest skonfigurowane 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 zareagować

Wybierz Forward for:

Opcja	Co to oznacza
Any message	Każda wiadomość MQTT otrzymywana przez urządzenie wyzwala tę regułę.
Określony temat / wiadomość	Tylko wiadomości spełniające ustawione warunki ją wyzwolą.

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

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

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

Napisz tekst SMS-a

Message format kontroluje, co mówi SMS. Budujesz go z wiadomości MQTT, używając zamienników:

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

Domyślnie jest {TOPIC}: {MESSAGE}, co daje SMS-a taką jak building/boiler/temperature: 94. Możesz również 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 litery polskie, niemieckie lub cyrylica.

Opcje zaawansowane

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

Modem (tylko urządzenia wielomodemowe) – wyślij SMS-a przez określoną kartę SIM zamiast domyślnej.
Call after sending SMS – wykonaj również 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 tego, co obsługuje Twój model urządzenia. Przy opcji zaawansowanej wybierasz również Voice model.

Kliknij Save. Reguła zaczyna działać na wiadomościach MQTT otrzymywanych od teraz.

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

Reguły Publish nie używają ustawień usługi MQTT w ustawieniach Settings. Każda reguła ma swoje 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 mają być publikowane

Wybierz Forward for:

Opcja	Co to oznacza
Any message	Każdy przychodzący SMS jest publikowany do brokera.
Określony nadawca / wiadomość	Publikowane są tylko wiadomości spełniające ustawione poniżej warunki.

Jeśli wybierzesz Określony nadawca / wiadomość, dostępne będą warunki poniżej. Możesz je łączyć, a wiadomość musi spełniać wszystkie włączone warianty.

Gdy przychodzące SMS pochodzi od Zaznacz to i wybierz kontakty lub grupy nadawcy. Tutaj można wybrać tylko kontakty i grupy publiczne.

Gdy tekst przychodzącego SMS zawiera Zaznacz to i wpisz frazę w polu Fragment tekstu. Zaznacz opcję Rozróżniaj wielkość liter, jeśli wielkie i małe litery powinny być traktowane jako różne.

Gdy wiadomości przychodzą do (tylko urządzenia wielomodemowe) Pozostaw Dowolny modem lub wybierz określony modem, aby publikowane były tylko wiadomości docierające do konkretnej karty SIM.

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

Wprowadź połączenie brokera

Wypełnij broker, 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.
Nazwa użytkownika	Użytkownik brokera, jeśli wymagany. Pozostaw puste dla otwartego brokera.
Hasło	Hasło brokera, jeśli wymagane.
Temat	Temat do publikacji, na przykład `smseagle/incoming`
TLS/SSL	Włącz, jeśli broker używa szyfrowanego połączenia.
Weryfikacja certyfikatu TLS	Pozostaw włączone, chyba że broker używa samopodpisanego certyfikatu, którego urządzenie nie może sprawdzić.

Kliknij Save (Zapisz). Przychodzące wiadomości SMS spełniające regułę będą publikowane od teraz.

Jak działa dopasowywanie publikacji

Warunek tekstowy to dopasowanie typu contains (zawiera), a nie dokładne dopasowanie.
Jeśli do tego samego SMS dopasuje się kilka reguł Publikacji, każda z nich publikuje, więc wiadomość może trafić na więcej niż jeden broker lub temat.
Reguły dotyczą tylko wiadomości przychodzących po utworzeniu i włączeniu reguły. Nie przetwarzają wiadomości już znajdujące się w skrzynce odbiorczej.

Reguły Inbox

Reguły Inbox automatycznie sortują przychodzące wiadomości do niestandardowych folderów (Moje Foldery) zamiast pozostawiać wszystko w głównej Skrzynce Odbiorczej.

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 filtrować po numerze nadawcy, zawartości wiadomości lub modemie, przez który wiadomość dotarła; wiadomość pasująca do reguły jest przenoszona do wybranego folderu.

Reguły są sprawdzane w kolejności priorytetu. Przeciągnij regułę w górę lub w dół, używając uchwytu obok jej identyfikatora, aby kontrolować, która reguła jest stosowana w pierwszej kolejności, i pamiętaj, aby zapisać zmiany po zmianie kolejności.

Czyszczenie folderów

Strona Cleanup Folders, stan pusty, z panelem wyjaśnienia funkcji — Przegląd Cleanup Folders

Cleanup Folders automatycznie usuwa stare wiadomości z Twoich folderów, aby się nie gromadzili w nieskończoność.

Gdzie to znaleźć

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

Konfigurowanie reguły czyszczenia

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