Rejestracja identyfikatora nadawcy
Wysyłaj z własnej nazwy tam, gdzie jest to dozwolone.
Alfanumeryczny identyfikator nadawcy umieszcza nazwę Twojej marki w polu nadawcy zamiast numeru. Wiele krajów wymaga, abyś wstępnie zarejestrował tę nazwę, zanim będzie mogła dostarczać. Bird składa rejestrację i raportuje jej status przez API, więc wiesz, kiedy nadawca jest aktywny.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
const { data, error } = await bird.sms.send({
from: "Bird",
to: "+31612345678",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_01m11jw130e7svjzv70kgqr38w"
Dlaczego niektórzy nadawcy wymagają wcześniejszej rejestracji.
Rejestracja identyfikatora nadawcy to część zgodności SMS w API SMS od Bird. Aby ograniczyć podszywanie się, szereg krajów dostarcza wyłącznie alfanumeryczne identyfikatory nadawcy, które zostały wstępnie zarejestrowane u lokalnych operatorów lub regulatora. Tam, gdzie to obowiązuje, niezarejestrowany markowy nadawca jest odrzucany lub przepisywany. Bird składa rejestrację za Ciebie i udostępnia jej stan, więc nie wysyłasz do nadawcy, który nie może jeszcze dostarczać.
Jak działa rejestracja.
Gdzie jest wymagana, kto ją składa i kiedy jest aktywna.
- 01
Wiedz, gdzie jest wymagana.
To, czy alfanumeryczny identyfikator nadawcy wymaga rejestracji, zależy od kraju docelowego. Niektóre wymagają wstępnej rejestracji, niektóre pozwalają na dynamicznych nadawców, a niektóre w ogóle nie dopuszczają alfanumerycznych.
- 02
Bird składa ją za Ciebie.
Prześlij identyfikator nadawcy i kraj docelowy z panelu. Bird przekazuje rejestrację lokalnym operatorom lub regulatorowi w Twoim imieniu.
- 03
Śledź status przez API.
Zatwierdzenie przebiega przez zewnętrzne rejestry i trwa od dni do tygodni. Odpytuj stan rejestracji, aby Twój kod czekał na niego, zanim zacznie wysyłać z tego identyfikatora nadawcy.
- 04
Dotyczy nadawców alfanumerycznych.
Rejestracja reguluje sam alfanumeryczny identyfikator nadawcy. Wysyłanie z numerów — long codes, short codes, toll-free — podlega zamiast tego regułom tych typów numerów.
Sprawdź status rejestracji z poziomu API.
Rejestrujesz identyfikator nadawcy z poziomu dashboardu; wymagania informują Cię o aktualnym statusie — jeden wiersz na kraj docelowy. Przed wysyłką z danego nadawcy sprawdź status w odpowiednim wierszu oraz czy dany kraj docelowy jest włączony.
// The sender surface is not on the SDK yet, so read it over HTTP with a key
// carrying the sms_management:read scope.
const res = await fetch(
`https://eu1.platform.bird.com/v1/sms/senders/${senderId}/requirements`,
{ headers: { Authorization: `Bearer ${process.env.BIRD_API_KEY!}` } },
);
const { data: countries } = await res.json();
// Registration is decided per destination, so there is one row per country
// this sender can reach — never a single status for the sender itself.
const india = countries.find((c) => c.country_code === "IN");
// approved and not_required are the two statuses that satisfy a country.
// destination_enabled is a separate axis: a fully registered country still
// refuses the send while the workspace has it switched off.
if (india.status === "approved" && india.destination_enabled) {
// safe to send from this sender ID to India
}
Rejestracja podąża za nadawcą alfanumerycznym.
To krok zgodności stojący za alfanumerycznymi identyfikatorami nadawcy. Typ nadawcy pozwala Ci wysyłać z nazwy marki tam, gdzie kraj na to pozwala; rejestracja jest tym, co sprawia, że ta nazwa staje się zdatna do dostarczenia tam, gdzie kraj najpierw tego wymaga.
Zastosuj w praktyce.
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.
Inne tematy zgodności
Rejestracja identyfikatora nadawcy to jeden z trzech reżimów zgodności SMS. Zobacz pozostałe.
Zarejestruj identyfikator nadawcy, a potem wysyłaj pod marką.
Rejestracja identyfikatora nadawcy to jeden z reżimów zgodności SMS w Bird. Złóż ją z panelu, śledź zatwierdzenie przez API i wysyłaj z nazwy swojej marki tam, gdzie jest to dozwolone.