Home / Integracje i pluginy / Observium SMS integration

Wysyłka SMS, MMS z Observium dzięki SMSEagle - instrukcja intregracji​​

Poniżej znajdziesz opis jak zintegrować Observium z urządzeniem SMSEagle, w celu obsługi SMS/MMS. Proces integracji jest prosty i powinien zająć nie więcej niż 10 minut.

SMSEagle to sprzętowa bramka SMS. Działa bez dostępu do internetu. Dzięki temu nie jest wymagane żadne połączenie z zewnętrznymi usługodawcami. Wszystkie alerty i powiadomienia generowane są lokalnie i wysyłane bezpośrednio poprzez sieć komórkową. Urządzenia SMSEagle są wykorzystywane przede wszystkim, gdy istnieje konieczność zachowania wysokiego poziomu bezpieczeństwa, oraz w środowiskach izolowanych.

Konfiguracja SMSEagle

Observium używa żądań HTTP API (szczegóły: API). Po stronie SMSEagle wystarczy utworzyć nowego użytkownika z dostępem do API w webGUI i wygenerować dla niego token API.

  • Utwórz nowego użytkownika w SMSEagle (menu Użytkownicy > + Dodaj użytkownika) z poziomem dostępu: “Użytkownik”.
  • Przyznaj dostęp do API utworzonemu użytkownikowi:
    • kliknij Dostęp do API obok nowego użytkownika,
    • włącz APIv1,
    • zaznacz “Włącz uwierzytelnianie użytkownikiem/hasłem (tylko APIv1)”,
    • dodaj uprawnienia w sekcji APIv1 Uprawnienie dla: send_sms, send_tocontact, send_togroup,
    • zapisz ustawienia.

Konfiguracja Observium

Konfiguracja ustawień bramki SMS odbywa się w menu Contacts.

Dodaj nowy kontakt i wybierz Webhook JSON jako typ transportu. W polu Description możesz wpisać np. SMSEagle, a w polu URL wklej nasze żądanie API:
https://SMSEagle_IP/jsonrpc/sms
gdzie SMSEagle_IP to adres IP Twojej bramki.

W polu JSON passed to Webhook wklej kod:


{
"method": "sms.send_sms",
"params": {
"access_token": "your-created-token",
"to": "123456789",
"message": "%ALERT_STATE%, %ALERT_EMOJI%, %ALERT_EMOJI_NAME%,\n%ALERT_STATUS%, %ALERT_SEVERITY%, #%ALERT_COLOR%, %ALERT_URL%,\n%ALERT_UNIXTIME%, %ALERT_TIMESTAMP%, %ALERT_TIMESTAMP_RFC2822%,\n%ALERT_TIMESTAMP_RFC3339%, %ALERT_ID%, %ALERT_MESSAGE%, %CONDITIONS%,\n%METRICS%, %DURATION%, %ENTITY_URL%, %ENTITY_LINK%, %ENTITY_NAME%,\n%ENTITY_ID%, %ENTITY_TYPE%, %ENTITY_DESCRIPTION%, %DEVICE_HOSTNAME%,\n%DEVICE_SYSNAME%, %DEVICE_DESCRIPTION%, %DEVICE_ID%, %DEVICE_URL%,\n%DEVICE_LINK%, %DEVICE_HARDWARE%, %DEVICE_OS%, %DEVICE_TYPE%,\n%DEVICE_LOCATION%, %DEVICE_UPTIME%, %DEVICE_REBOOTED%, %TITLE%"
}
}

Zamień:

  • twój-stworzony-token na token API użytkownika SMSEagle, którego właśnie utworzyłeś,
  • 123456789 na numer telefonu, na który chcesz wysyłać SMS-y.

Możesz też użyć nazwy kontaktu lub grupy z książki telefonicznej SMSEagle.

Ważna uwaga: Powyższy kod używa wszystkich placeholderów dostępnych w Observium. Usuń te, które są niepotrzebne.

Na koniec przypisz Alert Checkers do nowo utworzonego kontaktu.

Czym jest sprzętowa
bramka SMS?

Dowiedz się więcej o
funkcjach SMSEagle

Poznaj urządzenie demo SMSEagle

SMSEagle to rozwiązanie sprzętowe i programowe, które gwarantuje szybkie dostarczanie wiadomości do wyznaczonych odbiorców, niezależnie od tego, czy chodzi o powiadomienia, alerty czy ważne aktualizacje.

Po zarejestrowaniu się w wersji demonstracyjnej otrzymasz zdalny dostęp do naszego fizycznego urządzenia NXS-9750.

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