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.
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"
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.
- 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.
- 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.
- 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ć.
- 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ć.
Wyszukuj według kraju i funkcjonalności, a następnie kup numer — w tym samym kliencie, przez który wysyłasz wiadomości. Ruch przychodzący jest kierowany przez webhook workspace'a subskrybujący sms.received, a nie per numer. Ta sama struktura kodu obsługuje każdy typ nadawcy; zmienia się jedynie number_type.
const { data: page, error: searchError } = await bird.numbers.available
.list({
country_code: "US",
number_type: "toll_free",
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..."
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.
Zastosuj w praktyce.
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.
Inne sposoby wysyłki
Toll-free to jeden z czterech typów nadawców. Porównaj pozostałe.
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.