Home / Integracje i pluginy / Powiadomienia SMS i głosowe dla Kentix KentixONE

+

Powiadomienia SMS i połączenia głosowe dla Kentix KentixONE

Integracja KentixONE z bramką SMS SMSEagle umożliwia wysyłanie alarmów z czujników Kentix MultiSensor, systemu kontroli dostępu i urządzeń SmartPDU w formie wiadomości SMS, połączeń alarmowych (wake-up call) oraz połączeń głosowych wykorzystujących syntezę mowy (TTS Advanced). KentixONE komunikuje się bezpośrednio z interfejsem REST API urządzenia SMSEagle za pomocą webhooków, dzięki czemu alarmy pożarowe, zalaniowe, środowiskowe czy związane z włamaniem mogą być dostarczane nawet wtedy, gdy połączenie z siecią zewnętrzną jest niedostępne.

Signal message icon

Alarmy, które zawsze docierają

Informacje o wykryciu pożaru, zalaniu czy nieautoryzowanym dostępie do serwerowni mogą być natychmiast przekazywane zespołowi odpowiedzialnemu za reakcję na alarmy za pomocą SMS-ów lub połączeń głosowych. SMSEagle wysyła powiadomienia bezpośrednio przez sieć komórkową, bez zależności od serwerów pocztowych czy usług chmurowych.

Long product lifespan icon

Szybsza reakcja na zdarzenia

Wiadomość może zawierać nazwę strefy alarmowej, urządzenia oraz odczytaną wartość pomiaru, pobierane bezpośrednio z KentixONE. W przypadku połączeń TTS Advanced treść alarmu jest automatycznie odczytywana głosowo, co sprawdza się szczególnie w pracy ochrony i techników działających w terenie.

Customization options icon

SMS dla instalacji SiteManager i Docker

KentixONE uruchomiony na urządzeniu SiteManager bez modemu GSM lub w kontenerze Docker nie posiada własnego kanału SMS. SMSEagle rozszerza system o funkcję powiadomień SMS i głosowych wykorzystując standardowe webhooki, bez konieczności stosowania dodatkowego sprzętu Kentix.

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

Komunikacja pod pełną kontrolą

Zarówno KentixONE, jak i SMSEagle działają lokalnie, w infrastrukturze klienta. Dane alarmowe, nazwy stref oraz numery telefonów nie opuszczają sieci organizacji, co doskonale wpisuje się w wymagania środowisk, które chcą zachować niezależność od dostawców usług chmurowych.

Jak działa integracja?

1

Wykrycie zdarzenia

Urządzenie Kentix zgłasza alarm w grupie alarmowej lub na czujniku, np. wzrost poziomu CO, wykrycie zalania lub sforsowanie drzwi.

2

Przekazanie informacji

KentixONE uruchamia przypisany webhook i wysyła żądanie POST z danymi alarmu do REST API urządzenia SMSEagle przez sieć lokalną.

3

Wysłanie powiadomienia

SMSEagle wysyła wiadomość SMS i/lub wykonuje połączenie głosowe do wskazanych odbiorców lub grup z książki telefonicznej.

Jak skonfigurować integrację?

Wymagania

ElementWymaganie
KentixONEaktualna wersja obsługująca funkcję Webhooks (SiteManager, AlarmManager lub Docker)
Urządzenie SMSEaglezalecana jest najnowsza wersja oprogramowania
Funkcje głosowedodatek SMSEagle VOICE
Siećdostęp z KentixONE do urządzenia SMSEagle przez HTTP (80) lub HTTPS (443)

Konfiguracja SMSEagle

  1. Utwórz nowy klucz API: Settings → API → APIv2 → + Create API Key
  2. Wprowadź nazwę klucza (Key name).
  3. Wybierz właściciela klucza (Owner).
  4. Włącz opcję Key enabled.
  5. W sekcji Messages przyznaj uprawnienie: Send SMS.
  6. W sekcji Calls (powiadomienia głosowe) przyznaj uprawnienia: Make a ring call, Make a TTS Advanced call.
  7. Kliknij Create key.
  8. Zachowaj wygenerowany klucz API.
  9. Jeśli planujesz korzystać z TTS Advanced, przejdź do Settings → Calls → TTS local models i zanotuj identyfikator wybranego modelu głosowego.

Konfiguracja KentixONE

  1. Przejdź do Automation → Webhooks i kliknij Create webhook.
  2. Włącz opcję Active i nadaj webhookowi nazwę, np. SMSEagle SMS.
  3. URL: https://IP.OF.YOUR.SMSEAGLE/api/v2/messages/sms (zamień IP.OF.YOUR.SMSEAGLE na rzeczywisty adres IP urządzenia SMSEagle)
  4. Method: POST. Authentication: No authentication. Content type: application/json.
  5. Payload:
    {
      "access_token": "SMSEAGLE_API_KEY",
      "to": ["+48501234567", "+48501234568"],
      "text": "Alarm Kentix: $GROUP_NAME$ / $DEVICE_NAME$ / $ACTIVE_ALARM_SENSOR_NAME$ = $ACTIVE_ALARM_MEASUREMENT_VALUE$"
    }
  6. Zapisz webhook.
  7. Przypisz go jako akcję wykonywaną przy zmianie stanu alarmu w grupie alarmowej lub w konfiguracji czujnika.

Opcjonalnie: połączenia głosowe

Dla krytycznych alarmów możesz utworzyć drugi webhook, np. SMSEagle TTS call:

  • URL: https://IP.OF.YOUR.SMSEAGLE/api/v2/calls/tts_advanced (zamień IP.OF.YOUR.SMSEAGLE na rzeczywisty adres IP urządzenia SMSEagle)
  • Method: POST, Content type: application/json
  • Payload:
    {
      "access_token": "SMSEAGLE_API_KEY",
      "to": ["+48501234567"],
      "text": "Alarm Kentix w grupie $GROUP_NAME$. Czujnik $ACTIVE_ALARM_SENSOR_NAME$ na urządzeniu $DEVICE_NAME$.",
      "voice_id": 2,
      "duration": 30
    }

Jeżeli potrzebujesz jedynie połączenia alarmowego bez odczytywania treści komunikatu, użyj endpointu /api/v2/calls/ring z payloadem {"to": ["+48501234567"], "duration": 20}.

Odbiorcy powiadomień

Zamiast numerów telefonów można wykorzystać grupy z książki telefonicznej SMSEagle: "groups": [GROUP_ID]. Zastąp GROUP_ID rzeczywistym identyfikatorem grupy z książki telefonicznej SMSEagle. Dzięki temu grupami odbiorców, harmonogramami dyżurów i eskalacjami można zarządzać bezpośrednio po stronie SMSEagle.

Testowanie integracji

  1. Tymczasowo skieruj webhook do narzędzia testowego przechwytującego żądania HTTP, aby sprawdzić poprawność przesyłanych danych po podstawieniu zmiennych.
  2. Następnie przywróć adres webhooka wskazujący na SMSEagle i wywołaj alarm testowy w grupie alarmowej.
  3. W SMSEagle sprawdź Sent messages oraz Calls → Call history.

Rozwiązywanie problemów

ObjawPrzyczyna
HTTP 401nieprawidłowy lub wygasły klucz API
HTTP 403brak wymaganych uprawnień do wysyłki SMS lub wykonywania połączeń (Send SMS, Make a ring call, Make a TTS Advanced call)
HTTP 400nieprawidłowy format JSON po podstawieniu zmiennych, np. niezabezpieczone cudzysłowy w nazwie urządzenia
HTTP 400 podczas połączenia TTSbrak parametru voice_id, wymaganego dla TTS Advanced
Błąd SSLcertyfikat SSL urządzenia SMSEagle nie jest zaufany przez KentixONE; zainstaluj poprawny certyfikat lub użyj HTTP w izolowanej sieci zarządzania
Brak reakcji na alarmwebhook nie został aktywowany lub nie jest przypisany do zdarzenia alarmowego w grupie alarmowej

Alternatywa: Email-to-SMS bez użycia API

Jeżeli nie chcesz korzystać z webhooków, możesz skonfigurować w KentixONE wysyłkę wiadomości e-mail bezpośrednio do SMSEagle. Jako serwer SMTP podaj adres IP urządzenia SMSEagle oraz port 25, a odbiorców definiuj w formacie NUMER_TELEFONU@IP_SMSEAGLE. Dodatkowe połączenie głosowe można następnie skonfigurować po stronie reguły Email to SMS w SMSEagle.

Jak monitorować sam system KentixONE?

KentixONE monitoruje infrastrukturę, ale nie wykryje własnej awarii. Moduł SMSEagle Network Monitor może nadzorować działanie serwera SiteManager lub hosta Docker za pomocą testów Ping/ICMP oraz kontroli dostępności interfejsu WWW KentixONE. Jeśli system przestanie odpowiadać, SMSEagle samodzielnie wyśle SMS lub wykona połączenie alarmowe.

Przetestuj urządzenie SMSEagle

SMSEagle to sprzętowo-programowa platforma do niezawodnego dostarczania powiadomień, alarmów i komunikatów krytycznych.

Po rejestracji otrzymasz zdalny dostęp do fizycznego urządzenia NXS-9750. W ramach demonstracji otrzymujesz:

  • 14 dni bezpłatnych testów
  • Dostęp do ponad 20 funkcji systemu

Czym jest sprzętowa
bramka SMS?

Poznaj możliwości
SMSEagle