Numery

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

Numery długie, numery krótkie, numery bezpłatne i alfanumeryczne identyfikatory nadawcy — udostępniane, rejestrowane i trasowane przez jeden endpoint. Typ nadawcy, z którego wysyłasz, określa przepustowość, koszt i obowiązujący reżim zgodności.

send-notification.ts

202 · 0.4s

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"

send-notification.ts

202 · 0.4s

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"

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 wymagania rejestracyjne.

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, a następnie kup go — z tego samego SDK, którego używasz do wysyłki. Ruch przychodzący jest kierowany przez webhook workspace'a subskrybujący zdarzenie sms.received, a nie osobno dla każdego numeru, więc jedna subskrypcja obejmuje wszystkie posiadane numery. Numer jest aktywny natychmiast po zakończeniu wymaganej rejestracji.

provision.ts

201 · purchased

const { data: page, error: searchError } = await bird.numbers.available
  .list({
    country_code: "US",
    number_type:  "local",
    capabilities: ["sms"],
  })
  .safe();
if (searchError) throw searchError;

const { data: order, error: orderError } = await bird.numbers.orders
  .create({ number: page.data[0].number })
  .safe();
if (orderError) throw orderError;

console.log(order.status, order.number_id); // → "completed" "nda_0ydh2yfw..."

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.