Usługa powiadomień potrzebuje zarówno sposobu wysyłania wiadomości, jak i trasy do telefonów odbiorców. Wybór interfejsu rozwiązuje tylko pierwszą część tego problemu.
Co robi każda z tych części?
API przyjmuje żądania programistyczne. Brama łączy Twoją aplikację z sieciami komórkowymi.
Twoja aplikacja przesyła odbiorcę, nadawcę i treść wiadomości przez interfejs. Brama przekazuje wiadomości do usług sieciowych, które je dostarczają. Dostawca może udostępniać obie części w jednej usłudze.
Dokumentacja bramy SMPP opisuje bramy łączące aplikacje z centrami wiadomości sieci komórkowych. Opisuje też bramy oferujące kilka interfejsów, w tym HTTP i SMPP.
Interfejs nie determinuje wszystkich możliwości dostarczania. Wygodny format żądania nie sprawi, że nieobsługiwany nadawca stanie się prawidłowy w danym kraju docelowym.
Który interfejs wybrać?
Wybierz HTTP dla nowej aplikacji, chyba że istniejąca integracja SMPP lub konkretne wymaganie połączeniowe uzasadnia zarządzanie SMPP.
Z HTTP Twoja aplikacja wysyła żądania i przetwarza odpowiedzi. Nadal potrzebuje ponownych prób, ochrony przed duplikatami i obsługi zdarzeń dostarczenia.
SMPP korzysta z połączenia, które pozostaje otwarte. Twój klient uwierzytelnia sesję i obsługuje utratę połączenia, potwierdzenia oraz operacje przychodzące. SMPP opisuje te zadania.
Istniejący system SMPP może uczynić ten interfejs praktycznym wyborem. Przetestuj obsługiwane operacje i limity dostawcy, zanim założysz, że kolejne połączenie SMPP zachowa się identycznie.
Jakie możliwości dostarczania porównać?
Porównaj zasięg krajów docelowych, dozwolonych nadawców, przepustowość i przydatne raporty o błędach z potrzebami Twojej aplikacji.
- Kraje docelowe: potwierdź obsługę każdego kraju, w którym działasz, ponieważ jedna działająca trasa nie gwarantuje innej.
- Nadawcy: sprawdź dostępność i rejestrację, zanim zdecydujesz się na tożsamość widoczną dla odbiorców.
- Przepustowość: odróżnij limity żądań od tempa, w jakim ścieżka dostarczania może przenosić ruch.
- Zdarzenia: zweryfikuj, jak wiadomości przychodzące i błędy dostarczania trafiają do Twojej aplikacji.
Strony krajów docelowych Bird publikują wymagania dla poszczególnych krajów. Typy nadawców opisuje dostępne opcje tożsamości.
Dlaczego dostarczenie następuje osobno od przyjęcia?
Sieć może zakończyć dostarczanie po tym, jak Twoje żądanie wysyłki zostanie przetworzone.
Centrum wiadomości może przechowywać tekst, gdy telefon jest nieosiągalny. Centra wiadomości opisuje ten etap oczekiwania.
Traktuj wysłanie i dostarczenie jako osobne wyniki w swojej aplikacji. W przeciwnym razie przyjęte żądanie może wyglądać na pomyślne, nawet gdy późniejszy raport dostarczenia odnotuje niepowodzenie.
Jak wysłać wiadomość przez HTTP API Bird?
Wysyłasz wiadomość, zapisujesz jej identyfikator i przetwarzasz zdarzenia dostarczenia, które nastąpią.
Użyj POST /v1/sms/messages z to, from, text i category do wysyłki dowolnego tekstu. Ustaw category na jedną z wartości marketing, transactional, authentication lub service. Przewodnik wysyłania dokumentuje obsługiwane pola.
Odpowiedź 202 potwierdza przyjęcie. Nie potwierdza dostarczenia na telefon. Śledź zwrócony id przez zdarzenia SMS, aby końcowy wynik zaktualizował właściwe żądanie.
Która ścieżka pasuje do mojej aplikacji?
Wybierz interfejs, który Twoja aplikacja może niezawodnie obsługiwać, a następnie zweryfikuj możliwości dostarczania osobno.
- Użyj HTTP dla nowej integracji, która nie ma konkretnego wymagania SMPP.
- Użyj SMPP, gdy istniejący system lub wymagane zachowanie połączenia uzasadnia zarządzanie sesją.
- Przetestuj kraje docelowe, nadawców i zdarzenia dostarczenia, zanim skierujesz ruch na którąkolwiek ścieżkę.
W skrócie
API i brama pełnią różne funkcje.
API przyjmuje Twoje żądanie, a brama zapewnia ścieżkę do sieci komórkowej.
HTTP eliminuje zarządzanie sesją SMPP.
SMPP wymaga odzyskiwania połączenia i obsługi sesji oprócz właściwego przepływu wiadomości.
Przyjęcie i dostarczenie to osobne etapy.
Pomyślne wysłanie żądania nie oznacza, że odbiorca otrzymał wiadomość.
Porównaj ścieżkę dostarczania, nie tylko interfejs.
Sprawdź obsługę krajów docelowych, wymagania dotyczące nadawcy, przepustowość i raportowanie błędów, zanim wybierzesz integrację.