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.
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: "+15005550006",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).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 wymagania rejestracyjne.
Wyszukaj, kup i routuj w kilku wywołaniach.
Znajdź numer według kraju i funkcji, kup go i przekieruj ruch przychodzący na webhook — wszystko z tego samego SDK, którego używasz do wysyłki. Numer jest aktywny natychmiast po zakończeniu wymaganej rejestracji.
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.
Reszta platformy SMS
Jedno API, jeden zestaw kluczy. Poznaj pozostałe możliwości.
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.