Jak zintegrować bramkę SMS: 4 sposoby połączenia systemu

Integracja bramki SMS polega na połączeniu jej z Twoim systemem lub aplikacją, aby mogły automatycznie wysyłać wiadomości SMS oraz odbierać odpowiedzi. Istnieją cztery główne metody integracji: gotowa wtyczka, API, Email-to-SMS oraz SMPP.

Spis treści

Szybka odpowiedź: jak zintegrować bramkę SMS

Istnieją cztery podstawowe sposoby integracji bramki SMS: gotowa wtyczka (plugin), API, Email-to-SMS i SMPP. Pozwalają one Twojemu systemowi wysyłać wiadomości SMS, a w zależności od wybranej metody również odbierać odpowiedzi. SMSEagle oferuje ponad 90 gotowych integracji, dlatego warto najpierw sprawdzić, czy Twój system znajduje się na liście wspieranych rozwiązań. Jeśli nie, API sprawdzi się w przypadku własnych aplikacji, Email-to-SMS wymaga jedynie możliwości wysyłania wiadomości e-mail, a SMPP jest przeznaczone dla platform działających jako klient SMPP.

Jeśli dopiero wybierasz samą bramkę, zacznij od Bramka SMS: czym jest i jaki typ wybrać.

Co oznacza integracja z bramką SMS?

Bramka SMS łączy systemy informatyczne z sieciami komórkowymi. Integracja jest połączeniem pomiędzy systemem a bramką i działa w dwóch kierunkach:

  • Wysyłanie: system inicjuje wiadomość, np. alert monitoringu, kod jednorazowy lub powiadomienie.
  • Odbieranie: bramka przekazuje przychodzące wiadomości SMS lub statusy dostarczenia z powrotem do systemu.

Cztery sposoby integracji bramki SMS

MetodaKiedy ją wybraćCzego potrzebuje Twój systemPrzykład
Gotowa wtyczkaTwój system jest na liście obsługiwanych integracjiKonfiguracja zgodna z instrukcją integracjiZabbix
APIPiszesz własną aplikację lub Twój system może wysłać żądanie na adres URLMożliwość wysyłania żądań HTTPWłasna aplikacja
Email-to-SMSIntegracja przez API nie jest możliwa, ale Twój system potrafi wysłać e-mailKanał powiadomień e-mailFortiGate
SMPPTwoja platforma działa jako klient SMPPNazwa użytkownika i hasło ustawione w bramceDAKS

1. Gotowa wtyczka

To najlepsze rozwiązanie, jeśli Twój system znajduje się na liście integracji SMSEagle. Dostępnych jest ponad 90 gotowych integracji dla monitoringu sieci, systemów SCADA i BMS, uwierzytelniania, komunikacji, ITSM, bezpieczeństwa i CRM. Każda integracja zawiera szczegółową instrukcję krok po kroku.

2. API

API jest najlepszym wyborem, gdy tworzysz własną aplikację lub Twój system może wysyłać żądania HTTP. Aplikacja wysyła żądanie do bramki, a bramka wysyła wiadomość SMS. SMSEagle oferuje dwa rodzaje API: API v2 (zalecane) to REST API zgodne ze specyfikacją OpenAPI 3.0, przeznaczone do nowych projektów. API v1 to HTTP API i JSON-RPC, dostępne dla starszych wdrożeń i zachowania kompatybilności.

Aby korzystać z API v2, utwórz klucz API w panelu (Settings → API → API v2). Wybierz użytkownika, którego uprawnienia ma wykorzystywać klucz, i nadaj odpowiednie uprawnienia (np. wysyłka SMS lub MMS). Skopiuj klucz zaraz po utworzeniu, ponieważ później nie będzie już widoczny.

3. Email-to-SMS

Jeśli integracja przez API nie jest możliwa, ale system potrafi wysyłać wiadomości e-mail, możesz wykorzystać funkcję Email-to-SMS. System wysyła wiadomość na adres NUMER_TELEFONU@ADRES_IP_SMSEAGLE, a bramka automatycznie zamienia e-mail na SMS. Możliwe jest również wysyłanie do kontaktów lub grup zapisanych w książce adresowej SMSEagle, np. db-admins@ADRES_IP_SMSEAGLE. Treść e-maila staje się treścią SMS-a, a można również dołączyć temat wiadomości.

Konfiguracja: Settings → Channels → Email → Email to SMS oraz Automation → Email → Email to SMS. Jeżeli wiadomości trafiają najpierw do skrzynki pocztowej, funkcja Email to SMS Poller może je automatycznie pobierać.

4. SMPP

SMPP jest przeznaczony dla platform działających jako klient SMPP. To standardowy protokół telekomunikacyjny wykorzystywany do komunikacji z bramkami SMS. Funkcje obejmują wysyłanie i odbieranie SMS przez klienta SMPP oraz raporty doręczeń (Delivery Reports). Parametry: SMPP 3.4, port TCP 2770. Konfiguracja: Settings → Channels → SMPP. Po zapisaniu ustawień wymagany jest restart urządzenia.

Inne sposoby integracji

  • Webhook (Callback URL): przychodzący SMS lub MMS może wywołać żądanie HTTP(S) do wskazanego adresu URL. Możliwe zastosowania to przekazywanie wiadomości do innych systemów oraz powiadamianie o zmianie statusu wiadomości (wysłana, dostarczona, błąd). 
  • MQTT: konwersja MQTT → SMS oraz SMS → MQTT. Przydatne w środowiskach IoT.
  • SNMP Trap: funkcja monitoringu sieci może wysłać SMS po odebraniu trapu SNMP spełniającego zdefiniowane reguły.

Co należy przygotować po swojej stronie?

Niezależnie od wybranej metody potrzebujesz:

  • Bramki SMS dostępnej w sieci (adres IP).
  • Karty SIM umieszczonej w urządzeniu.
  • Możliwości przekazania numeru telefonu i treści wiadomości z systemu do bramki.

Test integracji

Najpierw wyślij wiadomość testową na własny numer telefonu. Jeśli nie zostanie dostarczona, sprawdź:

  • Informacje systemowe: siłę sygnału, nazwę sieci, status karty SIM i status rejestracji modemu (System → System info).
  • Foldery wiadomości: zakładkę Errors w SMS Conversations oraz folder Sending Error.
  • Logi: logi urządzenia (System → Logs), które można również pobrać do analizy.

Najczęściej zadawane pytania

Czym jest integracja z bramką SMS?

To połączenie pomiędzy oprogramowaniem a bramką SMS umożliwiające automatyczne wysyłanie i odbieranie wiadomości.

Gotowa wtyczka, jeśli istnieje integracja dla Twojego systemu. API, jeśli tworzysz własną aplikację. Email-to-SMS, gdy system potrafi wysyłać e-maile. SMPP, jeśli platforma wykorzystuje protokół SMPP.

Tak. Możliwość odbioru zależy od wybranej metody integracji, np. API, SMPP lub webhooków.

Skorzystaj z API, Email-to-SMS lub SMPP albo skontaktuj się z zespołem SMSEagle w celu omówienia możliwości integracji.

Nie wiesz, jaki typ bramki SMS potrzebujesz?

Przeczytaj, czym jest bramka SMS i jak porównują się bramki sprzętowe i online.

Comparison of hardware SMS gateway and online SMS gateway solutions
Sabina Fabian
O autorze Sabina Fabian

Inżynier z wykształcenia, marketingowiec z powołania. Od ponad 6 lat łączę technologię, dane i content marketing, pomagając firmom budować przewagę konkurencyjną i osiągać mierzalne rezultaty. W SMSEagle jako Technical Content Specialist odpowiadam za rozwój komunikacji marki oraz treści wspierające sprzedaż, edukację klientów i pozycjonowanie. Studia na kierunku Systemy Informatyczne dały mi unikalną perspektywę na styku biznesu i technologii. Wyznaję zasadę „jakość, nie jakoś” – bo tylko jakość warto skalować.