Toll-free

Jeden numer 8xx, USA i Kanada.

Numer bezpłatny (toll-free) to numer 8xx, który wysyła i odbiera SMS na terenie USA i Kanady. Obsługuje ruch aplikacyjny bez A2P 10DLC, po przejściu weryfikacji toll-free, która zapewnia wyższą i bardziej przewidywalną przepustowość niż niezarejestrowany długi numer.

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.`,
  category: "authentication",
}).safe();

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

Today at 2:14 PM

Hey Ada, your Bird sign-in code is 482917. It'll expire in 10 minutes. Don't share it with anyone.
482917
Delivered

Kiedy pasuje numer toll-free.

Numer bezpłatny to jeden z czterech typów nadawców w ramach numerów Bird SMS, będących częścią szerszego Bird SMS API. Wybierz go, gdy jeden numer ma obsługiwać zarówno USA, jak i Kanadę, a wolisz pominąć rejestrację A2P 10DLC — weryfikacja zastępuje przegląd operatorski.

Co daje Ci numer toll-free.

Zasięg transgraniczny, ruch dwukierunkowy, bez 10DLC.

  1. 01

    USA i Kanada z jednego numeru.

    Pojedynczy numer 8xx dociera do odbiorców po obu stronach granicy, więc nie udostępniasz i nie zarządzasz osobnym nadawcą dla każdego kraju.

  2. 02

    Dwukierunkowy domyślnie.

    Skieruj ruch przychodzący numeru na webhook, a odpowiedzi dotrą jako podpisane zdarzenia — ta sama konwersacyjna podstawa co w przypadku każdego numeru Bird.

  3. 03

    Bez A2P 10DLC.

    Ruch toll-free jest całkowicie poza systemem 10DLC, więc nie ma rejestracji marki i kampanii do złożenia, zanim zaczniesz wysyłać.

  4. 04

    Zatwierdzony przez weryfikację toll-free.

    Operatorzy najpierw sprawdzają przypadek użycia i treść wiadomości; gdy weryfikacja zostanie zatwierdzona, numer wysyła przy pełnym wolumenie, zamiast być dławiony lub filtrowany.

Kup jeden i zacznij wysyłać.

Wyszukaj numer według kraju i funkcjonalności, kup go i przekieruj ruch przychodzący na webhook — tym samym klientem, którego używasz do wysyłki. Ten sam schemat kodu obsługuje każdy typ nadawcy; zmienia się jedynie pole type.

toll-free.ts
201 · purchased
const { data: available } = await bird.numbers.search({
  country: "US",
  type:    "toll-free",
  capabilities: ["sms"],
}).safe();

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

Weryfikacja jest częścią umowy.

Zanim numer bezpłatny będzie mógł wysyłać ruch aplikacyjny, musi przejść weryfikację toll-free: operatorzy oceniają Twój przypadek użycia, przykładowe wiadomości i mechanizm zgody (opt-in), zanim zatwierdzą numer. Bird składa wniosek o weryfikację z poziomu panelu i raportuje jej status przez API, dzięki czemu dokładnie wiesz, kiedy numer zostanie zatwierdzony. Jeśli Twój ruch w USA działa już przez A2P 10DLC, alternatywnym nadawcą jest długi numer.

FAQ dotyczące toll-free

Czym jest numer toll-free SMS?
Numer toll-free to numer 8xx (800, 888, 877 i pozostałe prefiksy toll-free), który wysyła i odbiera SMS-y w USA i Kanadzie. Przenosi ruch aplikacyjny bez A2P 10DLC, gdy przejdzie weryfikację toll-free.
Czy numery toll-free wymagają rejestracji 10DLC?
Nie. Numery toll-free są poza systemem A2P 10DLC. Zamiast tego przechodzą weryfikację toll-free, podczas której operatorzy sprawdzają przypadek użycia i treść wiadomości, zanim numer otrzyma zgodę na wysyłkę przy pełnym wolumenie.
Czy numer toll-free może odbierać odpowiedzi?
Tak. Numery toll-free są dwukierunkowe: skieruj ruch przychodzący numeru na webhook, a odpowiedzi przychodzą jako zdarzenia podpisane HMAC, tak samo jak każdy inny numer SMS od Bird.
Kiedy powinienem zamiast tego użyć long code?
Sięgnij po long code, gdy chcesz lokalny numer kierunkowy lub gdy Twój ruch w USA już przebiega przez A2P 10DLC. Numer toll-free wygrywa, gdy chcesz jednego nadawcę 8xx obejmującego zarówno USA, jak i Kanadę bez rejestrowania kampanii 10DLC.

Jeden zweryfikowany numer dla całego kontynentu.

Toll-free to jeden z typów nadawców w warstwie numerów SMS od Bird. Udostępnij numer 8xx, zatwierdź weryfikację i routuj ruch przychodzący z tego samego API, którym wysyłasz.

Zacznij od jednego kanału.
Dodaj kolejne, gdy będziesz gotowy.

Testowy klucz API otrzymasz od razu. Dostęp produkcyjny odblokujesz po dodaniu metody płatności i weryfikacji nadawcy.

Używasz Claude Code, Cursor lub Codex? Skopiuj prompt konfiguracyjny, a Twój agent zainstaluje za Ciebie Bird CLI i umiejętności. Wybierz swój:

Cursor