Short code, long code, toll-free czy alfanumeryczny: którego typu nadawcy SMS użyć?

Nadawca działający w jednym kraju docelowym może być niedostępny w innym. Obsługa odpowiedzi zależy też od konkretnego numeru i jego trasy.

Jakie są cztery typy nadawców?

Bird obsługuje long code, short code, numery toll-free i alfanumeryczne identyfikatory nadawcy. Ich wartości API to long_code, short_code, toll_free i alphanumeric.

Polityka kraju może dopuszczać numery toll-free i jednocześnie odrzucać long code. Wymagania rejestracyjne też mogą się różnić:

The toll_free value is distinct from long_code. A country can permit one and refuse the other, and the two usually demand different registration.

• Long code. Zwykły numer telefonu używany do wysyłania wiadomości. Wysyłanie i odbieranie zależą od jego obsługi SMS i od kraju docelowego.
• Toll-free. Numer z obsługą SMS w obsługiwanym zakresie numerów bezpłatnych, z własnymi wymaganiami dotyczącymi weryfikacji i routingu.
• Short code. Krótki identyfikator numeryczny używany w programach komunikacyjnych. Długość, dostępność, szybkość wysyłania i rejestracja różnią się w zależności od rynku.
• Alfanumeryczny. Nazwa wyświetlana jako nadawca, z limitem 11 znaków. Dłuższa nazwa marki wymaga krótszej tożsamości nadawczej. Odbiorcy nie mogą zaadresować do niej odpowiedzi.

Które typy nadawców mogą odbierać odpowiedzi?

Kwalifikujące się long code, numery toll-free i short code mogą obsługiwać odpowiedzi. Sprawdź obsługę SMS danego numeru i trasę w kraju docelowym, bo sam format numeru nie gwarantuje obsługi odpowiedzi.

Jeśli Twój program potrzebuje wiadomości przychodzących, wybierz numer obsługujący odpowiedzi, bo odbiorcy nie mogą odpowiedzieć na nazwę alfanumeryczną. Ten wymóg dotyczy też sytuacji, gdy subskrybent musi odesłać do nadawcy słowo kluczowe stop.

Polityka kraju raportuje obsługę odpowiedzi jako direction o wartości one_way lub two_way dla każdego typu nadawcy. Przy obsługiwanym numerze i trasie przychodzące SMS mogą dotrzeć do Twojej aplikacji.

Jak wybrać, nie znając reguł każdego kraju?

Skorzystaj z opublikowanych polityk typów nadawców dla danego kraju docelowego, a potem sprawdź wymagania nadawcy, którego zamierzasz użyć. Kraj publikuje wpisy polityki dla swoich raportowanych typów nadawców. Nieobecny typ nie jest tam obsługiwany. Typ obecny na liście wciąż ma własny status dostępności.

Każdy wpis polityki raportuje następujące pola:

• status, jedno z available, restricted, coming_soon lub unavailable.
• registration_mode, jedna z wartości none, optional lub required, oraz program, który obsługuje rejestrację, gdy ma zastosowanie.
• sender_id_behavior: preserved zachowuje przesłany identyfikator nadawcy, overwritten zastępuje go przed doręczeniem, a unknown oznacza, że zachowanie nie jest potwierdzone. Jest to niezależne od trybu rejestracji, więc wymagana rejestracja może nadal skutkować nadpisaniem identyfikatora nadawcy po zatwierdzeniu. Rejestracja opcjonalna zachowuje zatwierdzony identyfikator nadawcy i nadpisuje go przed zatwierdzeniem.
• registration_timeline_min i registration_timeline_max, w dniach roboczych, jeśli dany kraj publikuje szacunkowy czas.
• throughput_mps, opublikowana maksymalna szybkość wysyłki w wiadomościach na sekundę dla danego typu nadawcy i miejsca docelowego. Na przykład wartość 30 oznacza limit 30 wiadomości na sekundę. Wartość null nie określa opublikowanej szybkości. Potwierdź dostępną przepustowość konta, nadawcy i operatora, ponieważ mogą one dodatkowo ograniczać rzeczywistą szybkość wysyłki.
• direction, jednokierunkowa lub dwukierunkowa.
• allowed_source_countries, kraje, z których nadawca może wysyłać. Pusta lista nie nakłada ograniczeń na kraj źródłowy.

Opublikowane polityki krajów możesz porównać na stronie SMS destinations. Wymagania swojego nadawcy sprawdź osobno, bo polityka kraju nie ustala statusu rejestracji tego nadawcy:

bird sms senders requirements <sender-id> --country-code NL

Niepusta lista allowed_source_countries ogranicza kwalifikowalność do nadawców z wymienionych krajów. Nadawca z innego kraju nie ma trasy w ramach tej polityki. Rejestracja nie może uczynić tego pochodzenia kwalifikowalnym.

Co decyduje, którego nadawcy Bird faktycznie użyje?

Przy wysyłce free-text API podaj kwalifikującego się nadawcę w from. API nie wybiera puli nadawców, gdy go pominiesz. Wysyłka z szablonem systemowym wybiera nadawcę z szablonu. Zwrócona wartość from identyfikuje nadawcę użytego dla danej wiadomości.

Priorytet routingu z polityki kraju nie wybiera nadawcy dla żądania free-text. Podaje go Twoja aplikacja.

Rejestracja i dostęp do kraju docelowego to osobne rzeczy. Zarejestrowany nadawca może być zablokowany, gdy obszar roboczy nie ma włączonego kraju docelowego, z błędem E12020.

Co właściwie powinienem zrobić?

1. Wybierz typ nadawcy obsługiwany przez kraj docelowy, uwzględniając ewentualne ograniczenia co do kraju źródłowego.
2. Wybierz obsługiwany numer, gdy wymagane są odpowiedzi, w tym przychodzące słowa kluczowe stop.
3. Uwzględnij wymaganą rejestrację oraz ewentualną opcjonalną rejestrację, korzystając z opublikowanego harmonogramu do zaplanowania uruchomienia.
4. Porównaj opublikowany limit szybkości wysyłania ze swoim szczytowym ruchem, a potem potwierdź przepustowość konta, nadawcy i operatora.
5. Potwierdź rejestrację nadawcy i dostęp do kraju docelowego w obszarze roboczym przed wysyłką.