# 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**](https://bird.com/dashboard/w/sms/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](/docs/guides/sms/sending-sms#sender). ## 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](/docs/guides/sms/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](/docs/guides/numbers/number-types) opisuje, jak wybierany jest typ samego numeru, a [Kup i zwolnij numer](/docs/guides/numbers/buying-numbers) 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](/products/sms/destinations) 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**](https://bird.com/dashboard/w/sms/senders) otwórz **Add sender** i wybierz **Add sender ID**, a następnie wpisz ciąg. Przez API: ```cli 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**](https://bird.com/dashboard/w/trust), 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: ```cli 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](#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**](https://bird.com/dashboard/w/sms/destinations); [Wysyłanie SMS](/docs/guides/sms/sending-sms#before-you-send-enable-the-destination-country) 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: ```cli 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**](https://bird.com/dashboard/w/trust) 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ą](#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](/docs/guides/numbers/overview#the-status-of-an-allocated-number) 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**](https://bird.com/dashboard/w/sms/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](#sprawdź-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](#zarejestruj-nadawcę-w-danym-kraju) oraz formularz wymagany przez dany kraj | | `numeric` | numer długi | [Zarejestruj nadawcę dla kraju](#zarejestruj-nadawcę-w-danym-kraju) oraz formularz wymagany przez dany kraj | | `10dlc` | amerykański numer długi | Zarejestruj markę i kampanię, a następnie przypisz numer: [rejestracja 10DLC](/docs/guides/sms/10dlc) | | `tfn` | amerykański numer bezpłatny | Weryfikacja numeru bezpłatnego, na stronie [**Toll-free verifications**](https://bird.com/dashboard/w/sms/tfn-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](/products/sms/numbers) lub zapoznaj się z [rejestracją nadawcy](/products/sms/compliance/sender-id-registration) w kontekście swojego wdrożenia. | Strona | Co opisuje | | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | | [Wysyłanie SMS](/docs/guides/sms/sending-sms) | Wywołanie wysyłki, akceptowane formaty `from` i lista dozwolonych kierunków | | [Rejestracja 10DLC](/docs/guides/sms/10dlc) | Model marki, kampanii i numeru stojący za amerykańskim wysyłaniem A2P | | [Typy numerów](/docs/guides/numbers/number-types) | Wybór między numerami komórkowymi, lokalnymi, krajowymi, bezpłatnymi i krótkimi | | [Kierunki SMS](/products/sms/destinations) | Jakie rodzaje nadawców akceptuje każdy kraj i które z nich wymagają rejestracji | | [Rezygnacje i słowa kluczowe](/docs/guides/sms/opt-outs-and-keywords) | Odpowiedzi ze słowami kluczowymi, które nadawca musi honorować, i tworzone przez nie wyłączenia | ## Related resources - [Registering your SMS sender ID](/learn/sms/registering-your-sms-sender-id) (video) - [What is sender ID registration, and why do some countries require it?](/explained/sms/what-is-sender-id-registration) (answer) - [SMS sender IDs](/sms-api/features/compliance/sender-id-registration) (product) - [Build your first integration](/learn/paths/integration) (course) [Get an implementation brief](/learn/workspace?topic=sms-senders)