API do integracji SMS

Chcesz zintegrować swój system z SerwerSMS.pl? Możesz to zrobić za pomocą otwartego API do komunikacji SMS i nie tylko. Poniżej znajdują się informacje dotyczące protokołów, których możesz użyć, jak również gotowe przykłady rozwiązań.

Zintegruj się z SerwerSMS.pl – wystarczy darmowo zarejestrować konto i testować do woli przez 14 dni. To wszystko!

HTTPS API

SerwerSMS.pl to narzędzie, które umożliwia wysyłanie wiadomości w sposób zdalny, bez logowania się do Panelu Klienta. Komunikacja następuje z wykorzystaniem protokołu HTTPS i polega na wywołaniu określonego adresu URL.

Kilka przykładowych akcji możliwych w komunikacji zdalnej HTTPS API:

  • Wysyłka standardowych wiadomości SMS (o jednakowej treści);
  • Wysyłka spersonalizowanych wiadomości SMS;
  • Pobranie pełnego raportu: daty, ID wiadomości oraz numer telefonu;
  • Pobieranie odpowiedzi SMS z filtrowaniem według daty oraz numeru telefonu;
  • Pobierania wiadomości przychodzących z usług Numer Dostępowy, Numer Dostępowy Indywidualny oraz Premium SMS;
  • Sprawdzenie stanu posiadanych wiadomości
  • Dodawanie listowanie oraz sprawdzanie stanu nazw nadawcy
  • Dodawanie, listowanie oraz usuwanie kontaktów oraz grup

Bezpieczeństwo

  • Zabezpieczenie protokołem HTTPS
  • Możliwość wprowadzenia autoryzowanych adresów IP
  • Możliwość utworzenia dedykowanego użytkownika tylko do komunikacji z API

Biblioteki na GitHub

SMPP API

Protokół SMPP (Short Message Peer-to-Peer) dedykowany jest dla Abonentów, którzy wysyłają duże ilości wiadomości lub dla takich, którzy już mają obecnie zintegrowane własne oprogramowanie z użyciem protokołu SMPP.

Kilka przykładowych akcji możliwych w komunikacji zdalnej SMPP API:

  • Wysyłka wiadomości z wcześniej zgłoszonymi nagłówkami alfanumerycznymi oraz numerami 9-cio cyfrowymi (NDI)
  • Wysyłka wiadomości SMS ECO+ (należy użyć nagłówka "SMSECO")
  • Wsparcie dla długich wiadomości powyżej 160 znaków (max 918 znaków)
  • Wsparcie dla kodowania 7bit ASCII oraz UTF-8
  • Obsługa wiadomości wyskakujących Flash SMS
  • Szybkia aktualizacja raportów doręczeń

SMPP dostępne jest dla wszystkich Klientów. VPN może zostać zestawiony dla klientów abonamentowych (w zależności od oferty, może zostać naliczona opłata za utrzymanie kanału VPN)

Bezpieczeństwo

  • na potrzeby połączeń SMPP, w Panelu Klienta należy utworzyć konto użytkownika SMPP
  • możliwe jest zestawienie tunelu VPN pomiędzy Klientem a SerwerSMS.pl (opcja odpłatna, dostępna dla Klientów abonamentowych)
  • komunikacja odbywa się z autoryzowanych adresów IP

Kompatybilne oprogramowanie

  • Kannel (www.kannel.org)
  • Ozeki SMS (www.ozeki.hu)
  • Wszelkie inne oprogramowanie wspierające komunikację za pośrednictwem protokołu SMPP w wersji 3.4

SMS przez FTP

„SMS przez FTP” to kolejny sposób na skuteczną komunikację. Usługa nie jest skomplikowana i polega na prostym wysyłaniu wiadomości z wykorzystaniem serwera FTP po stronie Klienta.

Kilka przykładowych akcji możliwych w usłudze SMS przez FTP:

  • Wysyłka wiadomości z wcześniej zgłoszonymi nagłówkami alfanumerycznymi oraz numerami 9-cio cyfrowymi (NDI)
  • Wysyłka wiadomości SMS ECO+ (wartość pola nadawcy powinna być pusta)
  • Wsparcie dla długich wiadomości powyżej 160 znaków (max 918 znaków)
  • Wsparcie dla kodowania 7bit ASCII oraz UTF-8 (polskie znaki diakrytyczne będą przekodowane do ich odpowiedników "bez ogonków")

Bezpieczeństwo

  • na potrzeby usługi SMS przez FTP należy utworzyć konfigurację w Panelu Klienta (szczegóły w dokumentacji oraz Panelu Klienta).
  • komunikacja odbywa się przez protokół FTP który nie jest standardowo szyfrowany. W celu zapewnienia poufności przekazywanych danych, zalecane jest utworzenie tunelu VPN pomiędzy systemem Klienta a SerwerSMS.pl (szczegóły w cenniku).
  • możliwe jest zastosowanie SSL przy połączeniu do FTP, czyli tzw. FTPS
  • połączenie SFTP (Secure FTP) jest na chwilę obecną niedostępne

SQL API

„SQL API” to usługa polegająca na wysyłaniu wiadomości SMS i VMS oraz odbieraniu wiadomości SMS z wykorzystaniem serwera SQL po stronie Klienta lub SerwerSMS.pl. Rozwiązanie cieszy się dużą popularnością. 

Kilka przykładowych akcji możliwych w usłudze SQL API:

  • Wysyłka wiadomości z wcześniej zgłoszonymi nagłówkami alfanumerycznymi oraz numerami 9-cio cyfrowymi (NDI)
  • Wysyłka wiadomości SMS ECO+ (wartość pola nadawcy powinna być pusta)
  • Wysyłka wiadomości VMS (tekstowych)
  • Wsparcie dla długich wiadomości powyżej 160 znaków (max 918 znaków)
  • Wsparcie dla kodowania 7bit ASCII oraz UCS2
  • Odbiór wiadomości ECO, ND, SC, NDI, SCI
  • Aktualizacja raportów doręczenia wysłanych wiadomości wraz ze stanem, datą aktualizacji raportu, ew. kodem błędu i opisem tekstowym

Bezpieczeństwo

  • Na potrzeby usługi SQL API należy utworzyć konfigurację w Panelu Klienta (szczegóły w dokumentacji oraz Panelu Klienta).
  • Komunikacja odbywa się na wskazany numer portu. W celu zapewnienia poufności przekazywanych danych, zalecane jest utworzenie tunelu VPN pomiędzy systemem Klienta a SerwerSMS.pl (szczegóły w cenniku).

SOAP

Usługa SOAP polega na skonfigurowaniu połączenia HTTP w którym struktura danych określona jest w formacie XML. Rozwiązanie pozwala na prowadzenie skutecznej komunikacji z wykorzystaniem wiadomości SMS.

Kilka przykładowych akcji możliwych w komunikacji zdalnej SOAP:

  • Wysyłka standardowych wiadomości SMS (o jednakowej treści);
  • Wysyłka spersonalizowanych wiadomości SMS;
  • Pobranie pełnego raportu: daty, ID wiadomości oraz numer telefonu;
  • Pobieranie odpowiedzi SMS z filtrowaniem według daty oraz numeru telefonu;
  • Pobierania wiadomości przychodzących z usług Numer Dostępowy, Numer Dostępowy Indywidualny oraz Premium SMS;
  • Sprawdzenie stanu posiadanych wiadomości
  • Dodawanie listowanie oraz sprawdzanie stanu nazw nadawcy
  • Dodawanie, listowanie oraz usuwanie kontaktów oraz grup

Bezpieczeństwo

  • Zabezpieczenie usługi za pomocą WS-Security

  •  

    Zabezpieczenie protokołem HTTPS

EMI/UCP

External Machine Interface (EMI) wraz z rozszerzeniem Universal Computer Protocol (UCP) są protokołem do wymiany krótkich wiadomości tekstowych (SMS). Dedykowany jest dla Abonentów, którzy wysyłają duże ilości wiadomości lub dla takich, którzy już mają obecnie zintegrowane własne oprogramowanie z użyciem protokołu EMI/UCP.

Kilka przykładowych akcji możliwych w komunikacji zdalnej EMI/UCP:

  • Wysyłka wiadomości z wcześniej zgłoszonymi nagłówkami alfanumerycznymi oraz numerami 9-cio cyfrowymi (NDI)
  • Wysyłka wiadomości SMS ECO+ (należy użyć nagłówka "SMSECO")
  • Wsparcie dla długich wiadomości powyżej 160 znaków (max 3060 znaków)
  • Wsparcie dla kodowania 7bit ASCII oraz UTF-8
  • Obsługa wiadomości wyskakujących Flash SMS
  • Szybkia aktualizacja raportów doręczeń

EMI/UCP dostępne jest dla wszystkich Klientów. VPN może zostać zestawiony dla klientów abonamentowych (w zależności od oferty, może zostać naliczona opłata za utrzymanie kanału VPN)

Bezpieczeństwo

  • w celu uzyskania dostępu do EMI/UCP prosimy o kontakt z naszym działem BOK
  • możliwe jest zestawienie tunelu VPN pomiędzy Klientem a SerwerSMS.pl (opcja odpłatna, dostępna dla Klientów abonamentowych)

Kompatybilne oprogramowanie

  • Kannel (www.kannel.org)
  • Ozeki SMS (www.ozeki.hu)
  • Wszelkie inne oprogramowanie wspierające komunikację za pośrednictwem protokołu EMI/UCP w wersji v3.1.2, v3.5, v4.0, v4.5, v4.6

Odkryj świat komunikacji mobilnej w profesjonalnym wydaniu!

Odbierz 100 darmowych wiadomości na start + Short Code 4301 gratis!

Wypróbuj za darmo

Testuj 14 dni za darmo