Numery

Właściwy nadawca dla każdej wiadomości.

Long codes, short codes, numery toll-free i alfanumeryczne identyfikatory nadawcy — udostępniane, rejestrowane i routowane przez jeden endpoint. Nadawca, z którego wysyłasz, decyduje o przepustowości, koszcie i tym, który reżim zgodności obowiązuje.

send-otp.ts

200 · 0.4s

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const code = generateOtp();

const { data, error } = await bird.sms.send({
  from: "Bird",
  to:   "+15005550006",
  text: `Your Bird verification code is ${code}. Reply STOP to opt out.`,
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const code = generateOtp();

const { data, error } = await bird.sms.send({
  from: "Bird",
  to:   "+15005550006",
  text: `Your Bird verification code is ${code}. Reply STOP to opt out.`,
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."

send-otp.ts

200 · 0.4s

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const code = generateOtp();

const { data, error } = await bird.sms.send({
  from: "Bird",
  to:   "+15005550006",
  text: `Your Bird verification code is ${code}. Reply STOP to opt out.`,
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const code = generateOtp();

const { data, error } = await bird.sms.send({
  from: "Bird",
  to:   "+15005550006",
  text: `Your Bird verification code is ${code}. Reply STOP to opt out.`,
}).safe();

if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."

Cztery typy nadawców, jedno API.

Numery są fundamentem API SMS od Bird. Przeszukuj dostępność, kup numer i routuj ruch przychodzący na webhook tym samym klientem, którym już wysyłasz. To, który typ wybierzesz, zależy od wolumenu, geografii i tego, ile rejestracji jesteś w stanie wziąć na siebie.

Którego nadawcy powinienem użyć?

Przepustowość, zasięg i nakład rejestracji różnią się w zależności od typu nadawcy. Większość ruchu aplikacyjnego w USA zaczyna się na long code w ramach 10DLC; programy o dużej skali jeden-do-wielu przechodzą na short code.

Typ nadawcy	Najlepszy do	Rejestracja
Long code (10DLC)	Rozmowy dwukierunkowe, OTP, alerty przy umiarkowanym wolumenie	Marka + kampania A2P 10DLC
Short code	Marketing i alerty jeden-do-wielu o dużym wolumenie	Weryfikowany przez operatorów, czas realizacji w tygodniach
Toll-free	Ruch w USA/Kanadzie bez 10DLC, wyższa przepustowość niż long code	Weryfikacja toll-free
Alfanumeryczny identyfikator nadawcy	Jednokierunkowe markowe alerty tam, gdzie kraj na to pozwala	Wstępna rejestracja w wielu krajach

Wybierz typ numeru

Każdy typ nadawcy w szczegółach — zasięg, przepustowość i co trzeba zrobić, by go zarejestrować.

Long codesLokalne 10-cyfrowe numery do ruchu dwukierunkowego, rejestrowane przez A2P 10DLC.Short codes5–6-cyfrowe numery stworzone do wysyłki jeden-do-wielu o dużej przepustowości.Toll-freeZweryfikowane numery toll-free do ruchu w USA i Kanadzie bez 10DLC.Alfanumeryczne identyfikatory nadawcyWysyłaj z nazwy swojej marki tam, gdzie kraj docelowy na to pozwala.

Wyszukaj, kup i routuj w kilku wywołaniach.

Znajdź numer według kraju i możliwości, kup go i skieruj jego ruch przychodzący na webhook — wszystko z tego samego SDK, którym wysyłasz. Numer jest aktywny, gdy tylko wymagana rejestracja zostanie zatwierdzona.

provision.ts

201 · purchased

const { data: available } = await bird.numbers.search({
  country: "US",
  type:    "long-code",
  capabilities: ["sms"],
}).safe();

const { data: number } = await bird.numbers.buy({
  number:  available[0].number,
  webhook: "https://example.com/webhooks/bird",
}).safe();

console.log(number.id); // → "num_8KQ2..."

Rejestracja, obsłużona tam, gdzie jest wymagana.

Większość ruchu aplikacyjnego w USA wymaga rejestracji marki i kampanii A2P 10DLC; toll-free wymaga weryfikacji; wiele krajów wymaga wstępnej rejestracji identyfikatora nadawcy. Bird prowadzi każdą z nich z panelu, a warstwa zgodności śledzi status z poziomu API.

FAQ dotyczące numerów SMS

Od jakiego typu numeru powinienem zacząć?+

Dla ruchu aplikacyjnego w USA long code w ramach 10DLC obejmuje większość przypadków użycia dwukierunkowego i OTP. Programy o dużej skali jeden-do-wielu przechodzą na short code; toll-free to opcja dla USA/Kanady bez 10DLC.

Jak długo trwa uruchomienie numeru?+

Long code lub numer toll-free jest dostępny natychmiast i zaczyna wysyłać, gdy tylko jego rejestracja lub weryfikacja zostanie zatwierdzona. Short codes są weryfikowane przez operatorów i zwykle zajmują tygodnie.

Czy jeden numer może zarówno wysyłać, jak i odbierać?+

Tak. Long codes, short codes i numery toll-free są dwukierunkowe: skieruj ruch przychodzący numeru na webhook, a odpowiedzi przychodzą jako podpisane zdarzenia. Alfanumeryczne identyfikatory nadawcy działają tylko jednokierunkowo.

Czy muszę się zarejestrować, zanim zacznę wysyłać?+

To zależy od typu nadawcy i kraju. Ruch aplikacyjny w USA wymaga A2P 10DLC, toll-free wymaga weryfikacji, a wiele krajów wymaga wstępnej rejestracji identyfikatora nadawcy — wszystko obsługiwane z panelu.

Reszta platformy SMS

Jedno API, jeden zestaw kluczy. Poznaj pozostałe możliwości.

WysyłanieAPI wysyłki: segmenty, bezpieczeństwo Unicode, wsadowość i idempotencja.Komunikacja dwukierunkowaPrzychodzące SMS-y i odpowiedzi konwersacyjne jako webhooki podpisane HMAC.ZgodnośćRejestracja A2P 10DLC, opt-out STOP/HELP i reguły identyfikatora nadawcy.Routing150+ krajów, 240 bezpośrednich łączy do operatorów i failover.AnalitykaMetryki dostarczalności i zaangażowania z potwierdzeń dostarczenia operatorów.Przegląd API SMSPełne API SMS: wysyłanie, numery, komunikacja dwukierunkowa, zgodność, routing i analityka.

Udostępnij właściwy numer, zrutuj go w kilka minut.

Numery to jedna z możliwości API SMS od Bird: wysyłanie, ruch przychodzący dwukierunkowy, zgodność, routing i analityka są dostarczane wraz z nimi.

Poznaj platformę SMS Rozpocznij