Home / Integracje i pluginy / Integracja SMS w Niagara 4
Niagara4 and SMS Eagle logos side by side, indicating a partnership or integration

Alerty SMS i głosowe dla Niagara 4.

Integracja platformy do zarządzania budynkami Niagara 4 ze sprzętową bramką SMS SMSEagle umożliwia automatyczne wysyłanie alertów o awariach HVAC, problemach z zasilaniem czy incydentach bezpieczeństwa. Rozwiązanie tworzy niezależny od sieci kanał komunikacji, co jest kluczowe dla ciągłości monitoringu obiektu.

Flow from Niagara 4 server to SMSEagle device via API, then to a user receiving SMS on a mobile.

Korzyści

Verified security badge: blue shield outline with a dark circle and white checkmark indicating protection and trust.

Niezawodne alerty

Zadbaj o to, by krytyczne alarmy zawsze docierały SMS‑em — nawet gdy zawiedzie sieć lub poczta e‑mail. Dzięki temu masz pewność, że zostaną zauważone i odpowiednio obsłużone.

Icon depicting a hand interacting with a circular timer/clock motif and a rectangular element, suggesting a user action with time or sequencing

Szybsza reakcja na incydenty

Alerty od razu trafiają na telefony techników, dzięki czemu mogą reagować szybciej i unikać przestojów – bez konieczności logowania się do systemu.

Communication tower emitting radio waves from a tall antenna structure

Bezpieczna komunikacja

Lokalna bramka SMS eliminuje zależność od zewnętrznych dostawców i usług chmurowych. Zyskujesz większe bezpieczeństwo, łatwiejsze spełnienie wymagań regulacyjnych i pełną kontrolę.

Jak to działa?

1

Zdarzenie

Niagara 4 reaguje na zdarzenie, np. przekroczenie dopuszczalnej temperatury.

2

Komunikacja

Niagara wysyła żądanie do SMSEagle przez sieć lokalną.

3

Alert

SMSeagle wysyla alert (SMS / Voice) do zdefiniowanej grupy odbiorców.

Infographic showing Niagara4 system elements: sensors, room controls, chiller, air flow, automation level controllers in a blue dashed box, feeding an SMS Eagle device via API to a cellular operator; admins on shift receive SMS alerts.

Integracja w 10 minut

Bez dodatkowych aplikacji i bez wdrażania nowego oprogramowania. Integracja typu „drag and drop” działa bezpośrednio z Niagara. 99% konfiguracji wykonujesz w stacji Niagara. Wystarczy włączyć dostęp do API na urządzeniu SMSEagle – i gotowe. Szybko, prosto i wygodnie. 

Rozszerz możliwości Niagara 4 o niezależny
kanał powiadomień out‑of‑band

Krytyczne powiadomienia bez dostępu do internetu

Alerty gotowe do pracy offline. Kluczowe powiadomienia są dostarczane przez GSM/SMS, dzięki czemu komunikacja pozostaje aktywna nawet przy całkowitej awarii internetu lub sieci lokalnej.

Diagram of an alarm processing flow (wire sheet) with blocks for Alarm Source, Monitor, Tuning Policy, Poll Schedules, and SmsEagleDevice output to indicate the data path and processing steps.

Automatyzacja i reguły
powiadomień

Dostosuj treść komunikatu alarmowego, wykorzystując operacje na ciągach znaków (string manipualtion) lub narzędzie TextBuilder z użyciem specjalnych słów kluczowych. Wysyłkę SMS-ów możesz automatyzować za pomocą harmonogramów lub zdarzeń wyzwalających.

Wyższa dostarczalność

Żaden alarm nie pozostaje bez odpowiedzi. Mechanizmy eskalacji, połączenia głosowe i przełączanie awaryjne (klaster HA) gwarantują, że powiadomienia trafiają do właściwej osoby i są ponawiane aż do ich potwierdzenia.

Admin settings UI with a General Settings form and a secondary Manage Group modal for escalation options.

O SMSEagle

SMSEagle to sprzętowa bramka SMS, która umożliwia wysyłanie i odbieranie powiadomień bezpośrednio przez sieć komórkową. Działa lokalnie, dzięki czemu wszystkie dane pozostają pod pełną kontrolą użytkownika.

Jak skonfigurować integrację

Uwaga: Funkcje głosowe są dostępne wyłącznie dla użytkowników, którzy wykupili dodatek VOICE add-on dla swojego urządzenia SMSEagle.

Pełna dokumentacja sterownika jest dostępna tutaj.

Konfiguracja SMSEagle

1.Stwórz nowego użytkownika w SMSEagle (menu Users > + Add Users).
2. Nadaj uprawnienia API utworzonemu użytkownikowi:

    • Kliknij Access to API obok nowo utworzonego użytkownika.
    • Włącz opcję APIv2.
    • Wygeneruj nowy token za pomocą przycisku Generate new token (skopiuj go, będzie potrzebny w kolejnych krokach).
    • W sekcji Messages dodaj uprawnienia dostępu dla: Send SMS.
    • W sekcji Modem dodaj uprawnienia dostępu dla: Make a ring call, Make a TTS, Make a TTS Advanced call (wymagane do obsługi alertów głosowych).
    • Zapisz ustawienia (Save settings).

Konfiguracja Niagara 4

Aby uruchomić alerty SMS za pośrednictwem sprzętowej bramki SMS SMSEagle, wymagany jest dedykowany sterownik SMSEagle dla systemu Niagara. Głównym zadaniem sterownika jest pełnienie funkcji bramki umożliwiającej wysyłanie wiadomości SMS przez SMSEagle ze stacji Tridium Supervisor 4, JACE8000 lub JACE9000 (w tym wersji OEM, np. Centra Line, Trend itp.).

1. Instalacja sterownika

  • Pobierz archiwum ZIP z plikami sterownika (sterownik jest bezpłatny). Sterownik jest również dostępny na platformie Niagara Marketplace.
  • Rozpakuj archiwum ZIP i skopiuj wszystkie zawarte w nim pliki *.jar do katalogu z modułami Niagara (domyślna ścieżka to zazwyczaj C:\Niagara\Niagara-4.x.xx.xx\modules).
  • Do prawidłowego działania systemu wymagane jest zainstalowanie plików *.jar zarówno na platformie klienckiej (komputerze z Workbench), jak i na platformie docelowej (JACE8000 lub Supervisor).
  • Po skopiowaniu wszystkich modułów do folderu, zamknij środowisko Niagara Workbench. Przy ponownym uruchomieniu Niagara Workbench, sterownik zostanie załadowany i będzie natychmiast gotowy do użycia.
  • Uwaga: Podczas instalacji nie jest wymagany żaden komponent usługowy (service component).

2. Konfiguracja sterownika

a) Podłącz kontroler JACE 8000/9000 lub komputer z oprogramowaniem Tridium Supervisor 4 do sieci.
b) Dodaj nowy element SmsEagleNetwork do węzła Drivers.
c) Dodaj nowe urządzenie SmsEagleDevice do utworzonej sieci.
d) Skonfiguruj nowo dodane urządzenie, uzupełniając poniższe parametry SMSEagle Device:

    • Enabled: ustaw na True.
    • Ip Address: wprowadź adres IP lub nazwę domenową swojego urządzenia SMSEagle.
    • Use Tls: ustaw na True, jeśli korzystasz z połączenia HTTPS (w przeciwnym razie ustaw na False).
    • Port: 80 (dla połączenia HTTP) lub 443 (dla połączenia HTTPS).
    • Api Key: klucz API wygenerowany w interfejsie webowym SMSEagle.
    • Tts Voice Id (opcjonalnie): ustaw na 2 (dla angielskiego głosu w komunikatach głosowych Text-to-Speech).
    • Call Duration (opcjonalnie): pozwala skonfigurować czas trwania sygnału wywołania (dzwonienia) dla połączenia głosowego.

Uwaga: Jeśli chcesz korzystać z bezpiecznego połączenia HTTPS pomiędzy systemem Niagara a urządzeniem SMSEagle, na urządzeniu SMSEagle musi być prawidłowo skonfigurowany certyfikat SSL.

SMSEagle device settings: enabled, health shows fail, HTTP config with IP address, port and API key; text set to 'test'.

3. Właściwości urządzenia SMSEagleDevice

Każde urządzenie posiada następujące parametry (Properties):

  • To: numer telefonu odbiorcy (lub wiele numerów oddzielonych przecinkami).
  • Group (opcjonalnie): nazwa grupy zdefiniowana w książce telefonicznej SMSEagle. Jeśli utworzysz grupę w książce adresowej SMSEagle (musi być ustawiona jako publiczna), możesz wysyłać wiadomości SMS do całej grupy odbiorców jednocześnie.
  • Priority (opcjonalnie): priorytet wiadomości SMS – wartość z przedziału 0–9 (gdzie 9 oznacza najwyższy priorytet).
  • Tts Mode (opcjonalnie): wybór punktu końcowego (endpointu) dla połączeń głosowych TTS. Dostępne opcje to: Tts Advanced (domyślny; obsługuje wybór języka w SMSEagle oraz naturalnie brzmiący głos) lub Tts (starsza wersja, obsługuje tylko język angielski, ale zapewnia szybsze przetwarzanie).
  • Tts Voice Id (opcjonalnie): identyfikator numeryczny głosu TTS, zdefiniowany w interfejsie webowym SMSEagle w menu Calls. Parametr dotyczy wyłącznie połączeń typu Tts Advanced. Dla języka angielskiego należy ustawić wartość: 2.
  • Text: treść wiadomości SMS.

Dla każdego urządzenia zdefiniowano następujące akcje, które można wywołać w systemie:

  • Send: wysyła wiadomość SMS do odbiorcy określonego w parametrze To.
  • Send Group: wysyła wiadomość SMS do grupy zdefiniowanej w parametrze Group.
  • Ring Call: wykonuje połączenie budzące (tylko sygnał dzwonienia, bez komunikatu) do odbiorcy określonego w parametrze To.
  • Ring Group Call: wykonuje połączenie budzące (tylko sygnał dzwonienia) do grupy zdefiniowanej w parametrze Group.
  • Tts Call: wykonuje połączenie głosowe z syntezą mowy (Text-to-Speech) do odbiorcy określonego w parametrze To, odczytując treść z parametru Text.
  • Tts Group Call: wykonuje połączenie głosowe z syntezą mowy (Text-to-Speech) do grupy zdefiniowanej w parametrze Group, odczytując treść z parametru Text.

4. Dodawanie odbiorcy alarmów

  • Otwórz paletę smsEagle w środowisku Niagara Workbench.
  • Przeciągnij komponent SmsEagleAlarmRecipient do usługi alarmów stacji (AlarmService) lub do dedykowanego folderu odbiorców (recipient folder) znajdującego się pod nią.
  • W wybranej klasie alarmów (Alarm Class), z której powiadomienia mają być wysyłane jako SMS, dodaj nowo utworzonego odbiorcę do ścieżki routingu (route). Dzięki temu przekierowane alarmy trafią bezpośrednio do tego komponentu.

Wpięcie komponentu SmsEagleAlarmRecipient bezpośrednio do usługi AlarmService systemu Niagara umożliwia automatyczne przekazywanie alarmów do skonfigurowanego urządzenia SmsEagleDevice w formie wiadomości SMS. Rozwiązanie to zapewnia natywne wsparcie i prawidłowe parsowanie znaczników formatowania alarmów systemu Niagara (np. %alarmData.*%).

Przykład konfiguracji

ER diagram of an alarm system with tables DefaultAlarm, AlarmConfig, ConsoleRecipe, SmsEagleAlarm, and related Route/Status links.

Komponent ten nie komunikuje się bezpośrednio z urządzeniem SMSEagle. Do obsługi połączenia oraz konfiguracji odbiorców wykorzystuje istniejący element SmsEagleDevice, z którego pobiera wszystkie parametry (adres IP, klucz API, pole To, priorytet).

Aby wysyłać nazwę źródła oraz treść komunikatu dla każdego alarmu z danej klasy alarmów (Alarm Class), należy wykonać następujące kroki:

    • Dodaj komponent SmsEagleAlarmRecipient w sekcji AlarmService, a następnie przypisz go do ścieżki routingu wybranej klasy alarmów (Alarm Class route).
    • W polu Sms Eagle Device Ord wskaż ścieżkę (ORD) do wcześniej skonfigurowanego urządzenia SmsEagleDevice.
    • Ustaw parametr Body Format na: %alarmData.sourceName%: %alarmData.msgText%

Przykład wygenerowanej wiadomości SMS:
„AHU-1 Supply Temp: High temperature alarm”

5. Właściwości komponentu SmsEagleAlarmRecipient

Komponent posiada następujące parametry:

  • Enabled: główny przełącznik aktywności (włącz/wyłącz). Gdy parametr jest ustawiony na false, komponent ignoruje wszystkie przekierowane do niego alarmy. Wartość domyślna: true.

  • Sms Eagle Device Ord: ścieżka ORD wskazująca na docelowy element SmsEagleDevice (wcześniej skonfigurowany z adresem IP, kluczem API, numerem odbiorcy itp.). Selektor wyświetla wyłącznie instancje SmsEagleDevice. Jeśli ścieżka ORD nie wskazuje na prawidłowe urządzenie, alarm zostanie zignorowany, a w logach stacji (station log) pojawi się ostrzeżenie.

  • Body Format: wielolinijkowy szablon treści wiadomości SMS, wykorzystujący znaczniki formatowania alarmów systemu Niagara, które są mapowane dla każdego przychodzącego rekordu alarmu. Parametr Body Format obsługuje wszystkie tokeny typu %alarmData.*% dostarczane przez standardowy mechanizm systemu Niagara. Najczęściej używane znaczniki to:

    • %alarmData.msgText% – treść komunikatu alarmowego

    • %alarmData.sourceName% – nazwa źródła alarmu

    • %alarmData.priority% – priorytet alarmu

    • %alarmData.timestamp% – czas wystąpienia alarmu

    • %alarmData.sourceState% – stan źródła (np. offnormal, normal)

    • %alarmData.ackState% – stan potwierdzenia alarmu

Tekst można dowolnie łączyć z tokenami.

SMS alert recipient settings: time 12:00 AM–12:00 AM, all days enabled, all transitions, route acks on, device path shown, message placeholder {alarmData.msgText}, status OK.

Alternatywny sterownik dla SMSEagle

Jeśli standardowy sterownik opisany powyżej nie spełnia Twoich wymagań, nasz partner sprzedażowy Smartnode przygotował sterownik alternatywny. Obsługuje alarmy SMS, głosowe i WhatsApp, umożliwia potwierdzanie (ACK) alarmów za pomocą wiadomości SMS oraz posiada wbudowaną książkę telefoniczną.

Sterownik jest dostępny odpłatnie. Aby uzyskać więcej informacji, prosimy o kontakt pod adresem: info@smartnode.hu.

Przykładowy zrzut ekranu:

Jak monitorować Niagara4 (Supervisor)?

Niagara4 to świetne narzędzie do monitoringu, ale co jeśli zawiedzie sprzęt serwera, na którym działa? Nawet najlepszy sprzęt miewa awarie. Wtedy wchodzi SMSEagle z funkcją Network Monitor. SMSEagle monitoruje adresy IP lub porty TCP i natychmiast wysyła SMS albo wykonuje połączenie, gdy wykryje problem. Możesz monitorować:

  • Dostępność serwera przez Ping/ICMP
  • Dostępność Web UI przez test HTTPS
  • Użycie CPU/RAM/dysku przez SNMP

Dzięki temu zawsze masz kontrolę nad stanem sprzętu serwera.

Poznaj urządzenie demo SMSEagle

SMSEagle to urządzenie z wbudowanym oprogramowaniem, które gwarantuje szybkie dostarczanie wiadomości do wyznaczonych odbiorców, niezależnie czy są to powiadomienia, alerty czy ważne aktualizacje.

Wypełnij formualarz i uzyskaj dostep do fizycznego urządzenia demonstracyjnego.

  • 14-dniowy bezpłatny okres próbny
  • Dostęp do ponad 20 funkcjonalności

Czym jest sprzętowa
bramka SMS?

Dowiedz się więcej o
funkcjach SMSEagle