Identyfikatory nadawcy SMS

Nadawca to from, który odbiorca widzi na Twojej wiadomości SMS. Obszar roboczy przechowuje jednego nadawcę na tożsamość, z której może wysyłać, a każdy kraj docelowy decyduje, jakie rodzaje nadawców akceptuje i co wymaga wcześniejszej rejestracji. Posiadanie nadawcy to nie to samo co uprawnienie do wysyłania z niego: to dwa osobne kroki, a ten przewodnik opisuje oba.

Nadawcy znajdują się na stronie Senders, jeden wiersz na nadawcę, z jego statusem i liczbą kierunków aktywnych, oczekujących lub wymagających uwagi. Samo wywołanie wysyłki, w tym sposób walidacji wartości from, opisano w Wysyłanie SMS.

Typy nadawców

Pole sender_type nadawcy określa rodzaj jego tożsamości i decyduje o tym, czego wymaga od niego każdy kraj:

Alfanumeryczny identyfikator nadawcy: krótki ciąg znaków marki, np. BIRD, od 3 do 11 liter ASCII, cyfr, spacji, łączników, podkreśleń lub kropek, z co najmniej jedną literą. Spacje, łączniki, podkreślenia i kropki nie mogą być pierwszym ani ostatnim znakiem. Odbiorcy widzą Twoją nazwę zamiast numeru i nie mogą na nią odpowiedzieć. Wiele krajów wymaga rejestracji przed rozpoczęciem ruchu, a niektóre, w tym Stany Zjednoczone, w ogóle go nie akceptują. Ten rodzaj zgłaszasz samodzielnie.
Numer długi: zwykły numer, który posiadasz i który może wysyłać oraz odbierać. Amerykański numer długi wymaga zarejestrowanej marki i kampanii, zanim będzie obsługiwał ruch application-to-person; zobacz Rejestracja 10DLC.
Numer bezpłatny: numer, za który płaci strona wywoływana, a który w Ameryce Północnej może również obsługiwać wiadomości. Wysyłanie z takiego numeru wymaga uprzedniej weryfikacji numeru bezpłatnego.
Numer krótki: krótki numer krajowy dla zatwierdzonego programu wiadomości, o długości i przepustowości określonej przez rynek i program operatorski. Bird przydziela numery krótkie, a nie sprzedaje je, więc ten rodzaj nie jest dostępny w trybie samoobsługowym.

Nadawca raportuje również source_kind, które wskazuje, co go obsługuje: alpha dla zgłoszonego ciągu nadawcy, number dla posiadanego numeru dedykowanego oraz shared_number dla numeru współdzielonego zarządzanego przez Bird, z którego wysyła Twój obszar roboczy. Panel oznacza je jako Alphanumeric, Dedicated number i Shared number. Typy numerów opisuje, jak wybierany jest typ samego numeru, a Kup i zwolnij numer opisuje jego przydzielanie.

Rodzaje nadawców akceptowane przez dany kraj oraz to, czy je weryfikuje, zmienia się wraz z aktualizacją zasad przez operatorów i regulatorów. Kierunki SMS publikuje aktualny stan dla każdego kraju; sprawdź go tam, zamiast zakładać, że kraj zachowuje się jak jego sąsiedzi.

Zgłoś alfanumeryczny identyfikator nadawcy

Zgłoszenie ciągu nadawcy jest bezpłatne i działa natychmiast. Na stronie Senders otwórz Add sender i wybierz Add sender ID, a następnie wpisz ciąg. Przez API:

Przykład kodu

bird sms senders create --type alpha --sender BIRD

Odpowiedź zawiera id nowego nadawcy, z prefiksem snd_, a każda inna operacja w tym przewodniku przyjmuje ten identyfikator. Po włączeniu krajów docelowych nowo zgłoszony nadawca może wysyłać tam, gdzie rejestracja jest niewymagana lub opcjonalna. Rejestracja wymagana musi być najpierw zatwierdzona.

Mogą wystąpić dwa odrzucenia. 412 oznacza, że Twoja organizacja nie ukończyła weryfikacji tożsamości wymaganej przez tę operację: dokończ ją w Identity Center, a następnie spróbuj ponownie. 409 oznacza, że ciąg nadawcy jest już zgłoszony.

alpha to jedyny rodzaj, który tworzy to wywołanie. Numer dedykowany staje się nadawcą po przydzieleniu go z zasobów, więc zakup numeru tworzy jednocześnie jego nadawcę. Numery krótkie i współdzielone trafiają do obszaru roboczego przez przydział od Bird, a nie przez zakup.

Sprawdź, czego wymaga dany kraj

Jedno odczytanie odpowiada na pytanie, czego każdy kraj wymaga od nadawcy. Zwraca wiersz na każdy kraj, do którego nadawca może dotrzeć, a każdy wiersz jest kompletny sam w sobie:

Przykład kodu

bird sms senders requirements snd_01krdgeqcxet5s7t44vh8rt9mg
bird sms senders requirements snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL

Pomiń --country-code, aby uzyskać wszystkie kraje istotne dla nadawcy. Pusty przefiltrowany wynik oznacza, że nadawca nie ma trasy do tego kraju.

Przed wysyłką przeczytaj sześć pól w wierszu:

registration_mode przyjmuje wartość none, optional lub required. none nie wymaga rejestracji w danym kraju. W połączeniu z identyfikatorem nadawcy overwritten rejestracja jest niedostępna. Starsze jawne rejestracje mogą być nadal zapisywane dla polityk none z zachowaniem unknown lub preserved, ale nigdy nie blokują wysyłki. optional pozwala nadawcy dalej wysyłać w trakcie rejestracji. required blokuje wysyłkę do momentu zatwierdzenia.
program identyfikuje przepływ rejestracji, gdy kraj go określa, np. alpha lub numeric. Może przyjąć wartość null, gdy żaden nazwany program nie ma zastosowania.
sender_id_behavior przyjmuje wartość unknown, preserved lub overwritten. Jest niezależne od registration_mode: wymagana rejestracja może nadal skutkować nadpisaniem identyfikatora nadawcy po zatwierdzeniu. Rejestracja opcjonalna zwraca overwritten przed zatwierdzeniem i preserved po zatwierdzeniu dla zatwierdzonych kategorii wiadomości.
status wskazuje, na jakim etapie programu rejestracyjnego danego kraju znajduje się nadawca. W trybie required wysyłka czeka na approved. W trybie optional status śledzi postęp rejestracji, ale nie blokuje wysyłki. Statusy rejestracji wymienia każdą wartość.
destination_enabled wskazuje, czy Twój obszar roboczy ma włączony dany kraj. To ustawienie obszaru roboczego, niezwiązane z samym nadawcą, i jest sprawdzane w pierwszej kolejności, więc w pełni zatwierdzona rejestracja nadal odrzuca wiadomości, gdy kraj docelowy jest wyłączony. Włącz kraje w sekcji Destinations; Wysyłanie SMS opisuje listę dozwolonych.
next wymienia w kolejności, co jest potrzebne do postępu w danym kraju. Pusta lista oznacza, że nic nie wymaga działania. Każdy wpis wskazuje jedną czynność i wyjaśnia, dlaczego warto ją wykonać, więc kraj w trakcie przeglądu operatora wskazuje zasób do przeczytania zamiast powtarzać werdykt, którego właścicielem jest ten zasób.

Wiersze zawierają również timeline_min_days i timeline_max_days, najkrótszy i najdłuższy czas zatwierdzenia przez kraj w dniach roboczych, oraz null, gdy kraj nie publikuje szacunków. Jeśli rejestracja została odrzucona, rejection_reason podaje przyczynę.

Te same informacje znajdują się na stronie szczegółów każdego nadawcy w panelu, w tabeli Destinations z kolumnami Status, Country i Category. Kraj, którego nie włączyłeś i dla którego nie zarejestrowałeś nadawcy, nie pojawia się w tej tabeli, ponieważ nie ma tam nic zaległego.

Zarejestruj nadawcę w danym kraju

Rejestracja odbywa się per kraj, a wywołanie przyjmuje nadawcę i kraj razem:

Przykład kodu

bird sms senders registrations create snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL
bird sms senders registrations create snd_01krdgeqcxet5s7t44vh8rt9mg --country-code NL --category marketing

--category ogranicza rejestrację do jednej z kategorii: transactional, marketing, authentication lub service. Pomiń to pole, aby zarejestrować się we wszystkich kategoriach. Panel wykonuje to samo wywołanie z przycisku Register w wierszu kraju nadawcy.

Co dzieje się dalej, zależy od kraju. Tam, gdzie kraj weryfikuje rejestracje, rekord wraca ze statusem pending i nic nie jest jeszcze naliczane. Tam, gdzie kraj niczego nie weryfikuje, rejestracja jest zatwierdzana od razu. Rejestracja numeru jest bezpłatna; płatny nadawca alfanumeryczny wiąże się z opłatą konfiguracyjną i cykliczną opłatą miesięczną naliczaną w momencie zatwierdzenia, więc weryfikowana rejestracja powstaje bez naliczenia opłaty. Ani to wywołanie, ani odczyt wymagań nie podaje ceny, więc przed rejestracją zapytaj właściciela konta o jej koszt.

Jeśli program zbiera odpowiedzi w formularzu, rejestracja pozostaje w stanie pending, dopóki go nie wypełnisz. Wiersz kraju nadawcy wyświetla wtedy Complete, co otwiera pytania, które program zadaje o Twoją firmę i Twoje wiadomości.

Cztery odrzucenia do obsłużenia:

Odpowiedź	Co to oznacza
402	Portfel nie pokrył należnej kwoty w momencie naliczenia opłaty. Doładuj go i spróbuj ponownie.
409	Rejestracja dla tego kraju już istnieje w stanie innym niż odrzucona lub zawieszona, w tym w trakcie przeglądu pending. Sam status nie decyduje, czy nadawca może wysyłać: sprawdź registration_mode, destination_enabled i to, czy rejestracja obejmuje kategorię wiadomości.
412	Twoja organizacja ma niespełnione wymaganie weryfikacji tożsamości. Ukończ je w Identity Center i spróbuj ponownie.
422	Nadawca podlega programowi z własną ścieżką, np. US 10DLC, weryfikacja numeru bezpłatnego lub krótki numer. Zobacz Programy z własną ścieżką.

Odrzuconą rejestrację przesyła się ponownie, a zawieszoną reaktywuje, wywołując tę samą operację jeszcze raz, bez konieczności osobnego wywołania.

Statusy rejestracji

Rejestracja krajowa przechodzi przez poniższe stany. Panel wyświetla każdy jako etykietę na wierszu nadawcy:

Status	Co to oznacza i co zrobić
registration_required	Pole registration_mode danego kraju ma wartość required i rejestracja nie została rozpoczęta. Zarejestruj nadawcę w tym kraju.
pending	Rozpoczęto prace rejestracyjne. Jeśli program wymaga formularza, uzupełnij go przyciskiem Complete w wierszu danego kraju.
under_review	Przesłane informacje są weryfikowane lub wymagają zmian. Pole program_ref w wierszu wskazuje zasób programu, jedyne miejsce, gdzie można odróżnić trwający przegląd od oczekiwania na Twoje działanie.
bird_approved	Przegląd Bird zakończony pomyślnie, oczekiwanie na zatwierdzenie operatora. Nie wymaga to od Ciebie żadnych działań.
carrier_pending	Przesłano do zatwierdzającego operatora lub rejestru. Nie wymaga to od Ciebie żadnych działań.
approved	Rejestracja zatwierdzona.
rejected	Rejestracja została odrzucona. Sprawdź rejection_reason, popraw dane i zarejestruj ponownie przyciskiem Resubmit.
suspended	Wcześniej aktywna rejestracja jest zawieszona. Zarejestruj ponownie przyciskiem Register again, aby ją reaktywować.
not_required	Żadna aktywna rejestracja nie blokuje wysyłki. Sprawdź registration_mode i sender_id_behavior: none nie wymaga rejestracji w kraju i uniemożliwia ją, gdy identyfikator nadawcy jest nadpisywany; optional oferuje rejestrację bez blokowania ruchu.

Nowe statusy są dodawane wraz ze zmianami programów rejestracyjnych, więc traktuj nieznaną wartość jako taką, której Twój kod jeszcze nie obsługuje, a nie jako błąd, i przeczytaj next w wierszu, aby dowiedzieć się, co zrobić z danym krajem.

Niektóre programy otwierają kilka krajów jedną rejestracją, więc pojedyncza weryfikacja numeru bezpłatnego lub rejestracja kampanii może uprawniać do kilku kierunków.

Status nadawcy i kolejne kroki

Pole status samego nadawcy opisuje stan tego, co nadawca posiada, co jest innym pytaniem niż to, czy dany kraj zaakceptuje wiadomość:

active: nic, co nadawca posiada, nie jest zaległe. Nadawca, który nigdzie się nie zarejestrował, ma wartość active, nawet jeśli każdy kraj, do którego może dotrzeć, wymaga rejestracji.
pending_number_ownership: dokumenty potwierdzające posiadanie numeru tego nadawcy nie są w porządku, ponieważ nie zostały dostarczone albo kraj, który wydał numer, ich jeszcze nie zaakceptował. Każda wysyłka z tego nadawcy jest odrzucana, dopóki sprawa nie zostanie wyjaśniona. Przegląd numerów opisuje ten cykl życia.
pending_registrations: nadawca posiada rejestracje krajowe, ale żadna nie jest jeszcze zatwierdzona. Dotyczy to rejestracji w trakcie weryfikacji i rejestracji odrzuconej, więc sprawdź next, aby ustalić, o którą chodzi.

Obok niego destinations grupuje kraje, dla których nadawca jest skonfigurowany, według tego, czyj jest następny ruch, a lista Senders pokazuje te trzy grupy jako kolumny:

"Active": kraje, do których możesz wysyłać teraz, włączone w ustawieniach krajów docelowych i niewymagające rejestracji albo posiadające zatwierdzoną rejestrację. Rejestracja opcjonalna może nadal oczekiwać na zatwierdzenie, a wysyłka pozostaje dostępna z nadpisanym identyfikatorem nadawcy.
"Pending": kraje, których rejestracja jest w toku i oczekuje na Bird lub operatora. Nic nie jest od Ciebie wymagane; po zatwierdzeniu przechodzą do "Active".
"Needs attention": kraje, dla których zarejestrowałeś nadawcę, ale rejestracja nie działa i czeka na Ciebie, ponieważ została odrzucona lub wycofana, albo jest zatwierdzona, lecz kierunek jest wyłączony.

Te trzy grupy obejmują wyłącznie kraje, w których posiadasz rejestrację, więc kraj, w którym mógłbyś się zarejestrować, ale tego nie zrobiłeś, nie pojawia się w żadnej z nich. Aby zobaczyć wszystko, do czego nadawca może dotrzeć, i czego każdy kraj by wymagał, przeczytaj czego wymaga dany kraj.

Odczyt nadawcy z obliczonymi kolejnymi krokami zwraca je w polu next, tym samym polu routingowym, które zawierają wiersze wymagań. Nadawca zna tylko siebie, więc tam, gdzie praca dotyczy konkretnego kraju, wskazuje odczyt wymagań zamiast zgadywać, o który kraj Ci chodziło.

Programy z własną ścieżką

Pole program kraju wskazuje schemat rejestracji, jaki prowadzi dla danego typu nadawcy. Dwa z nich obsługuje wywołanie rejestracji opisane w tym przewodniku, a trzy mają własną ścieżkę:

Program	Do czego się odnosi	Gdzie to się odbywa
alpha	alfanumeryczny identyfikator nadawcy	Zarejestruj nadawcę dla kraju oraz formularz wymagany przez dany kraj
numeric	numer długi	Zarejestruj nadawcę dla kraju oraz formularz wymagany przez dany kraj
10dlc	amerykański numer długi	Zarejestruj markę i kampanię, a następnie przypisz numer: rejestracja 10DLC
tfn	amerykański numer bezpłatny	Weryfikacja numeru bezpłatnego, na stronie Toll-free verifications
short_code	krótki numer (short code)	Bird zarządza wnioskiem; nic nie jest od Ciebie wymagane, chyba że wniosek zostanie odrzucony, wtedy next w wierszu kieruje Cię do wsparcia

Wywołanie operacji rejestracji dla nadawcy objętego programem 10dlc, tfn lub short_code zwraca 422. Użyj odpowiedniego programu.

Weryfikacja numeru bezpłatnego zaczyna się jako wersja robocza, którą wypełniasz w jednej lub kilku aktualizacjach, a następnie przesyłasz do weryfikacji przez operatora. Przechodzi przez stany draft, submitted, under_review, info_requested, approved i rejected. Weryfikację w stanie info_requested można edytować i przesłać ponownie; odrzuconą można przesłać ponownie, dopóki okno ponownego przesyłania jest otwarte. Przesłanie przekazuje dokumentację operatorowi do przeglądu, więc ten krok autoryzuje osoba: CLI i serwer MCP usługi Bird mogą tworzyć wersję roboczą i poprawiać weryfikację, a samo przesłanie odbywa się w panelu.

Zaprzestań wysyłania z nadawcy

Trzy sposoby likwidacji różnią się tym, co zachowują, i wszystkie trzy są akcjami w panelu na stronie szczegółów nadawcy. Opłaty konfiguracyjne już naliczone nie są zwracane przez żaden z nich:

Akcja	Co robi
Deregister kraju	Anuluje opłatę cykliczną i zachowuje rejestrację. Ponowna rejestracja w tym kraju wznawia tę samą rejestrację bez ponownego ponoszenia opłaty konfiguracyjnej. Tam, gdzie kraj wymaga rejestracji, wysyłanie zostaje wstrzymane; tam, gdzie rejestracja jest opcjonalna, wysyłanie trwa, ponieważ rejestracja nigdy go nie warunkowała.
Remove rejestracji	Usuwa rejestrację krajową całkowicie, anuluje opłatę cykliczną i przestaje wyświetlać kierunek dla nadawcy. Ponowna rejestracja w tym kraju to nowa rejestracja z ponowną opłatą konfiguracyjną.
Usunięcie nadawcy	Zwalnia nadawcę alfanumerycznego. Wszystkie rejestracje krajowe na nim zostają usunięte, opłata cykliczna anulowana, a nadawca przestaje być użyteczny. Późniejsze zgłoszenie tego samego ciągu tworzy nowego nadawcę z nowymi rejestracjami i ponowną opłatą konfiguracyjną.

Nadawca oparty na numerze nie jest tu usuwany: zamiast tego zwolnij numer dedykowany, co likwiduje również jego nadawcę. Nadawcy na współdzielonym numerze zarządzanym przez Bird nie można usunąć.

Wiersz 10DLC lub numeru bezpłatnego cofa się przez własny program, odłączając kampanię lub anulując weryfikację, a nie przez wyrejestrowanie.

Kolejne kroki

Porównaj numery i identyfikatory nadawcy SMS lub zapoznaj się z rejestracją nadawcy w kontekście swojego wdrożenia.

Strona	Co opisuje
Wysyłanie SMS	Wywołanie wysyłki, akceptowane formaty from i lista dozwolonych kierunków
Rejestracja 10DLC	Model marki, kampanii i numeru stojący za amerykańskim wysyłaniem A2P
Typy numerów	Wybór między numerami komórkowymi, lokalnymi, krajowymi, bezpłatnymi i krótkimi
Kierunki SMS	Jakie rodzaje nadawców akceptuje każdy kraj i które z nich wymagają rejestracji
Rezygnacje i słowa kluczowe	Odpowiedzi ze słowami kluczowymi, które nadawca musi honorować, i tworzone przez nie wyłączenia

Powiązane zasoby

Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.

Obejrzyj przewodnikRegistering your SMS sender ID Zrozum koncepcjęWhat is sender ID registration, and why do some countries require it?Poznaj możliwościSMS sender IDs Podążaj ścieżką naukiBuild your first integration

Uzyskaj brief wdrożeniowy