Toll-free

Un unico numero 8xx, USA e Canada.

Un numero toll-free è un numero 8xx che invia e riceve SMS in USA e Canada. Trasporta traffico applicativo senza A2P 10DLC, una volta superata la verifica toll-free — che procura un throughput più alto e prevedibile rispetto a un long code non registrato.

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..."

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

Quando si adatta un numero toll-free.

Il toll-free è uno dei quattro tipi di mittente sui numeri SMS di Bird, parte della più ampia API SMS di Bird. Ricorri a questo quando un singolo numero dovrebbe coprire sia USA sia Canada e preferisci saltare la registrazione A2P 10DLC — al suo posto è la verifica a gestire l'esame dei carrier.

Cosa ti dà un numero toll-free.

Copertura transfrontaliera, traffico bidirezionale, niente 10DLC.

  1. 01

    USA e Canada da un unico numero.

    Un singolo numero 8xx raggiunge i destinatari su entrambi i lati del confine, così non provisioni e gestisci un mittente separato per ogni paese.

  2. 02

    Bidirezionale di default.

    Indirizza il traffico in entrata del numero verso un webhook e le risposte arrivano come eventi firmati — lo stesso fondamento conversazionale di qualsiasi numero di Bird.

  3. 03

    Nessun A2P 10DLC necessario.

    Il traffico toll-free si colloca interamente al di fuori del sistema 10DLC, quindi non c'è alcuna registrazione di brand e campagna da presentare prima di inviare.

  4. 04

    Approvato tramite la verifica toll-free.

    I carrier esaminano prima il caso d'uso e il contenuto dei messaggi; una volta superata la verifica, il numero invia a pieno volume anziché essere limitato o filtrato.

Acquistane uno e inizia a inviare.

Cerca per paese e capacità, acquista il numero e instrada il suo inbound verso un webhook — lo stesso client con cui invii. La stessa forma di codice provisiona qualsiasi tipo di mittente; cambia solo il campo 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();

La verifica fa parte del pacchetto.

Prima che un numero toll-free possa inviare traffico applicativo, passa attraverso la verifica toll-free — i carrier esaminano il tuo caso d'uso, i messaggi di esempio e l'opt-in prima di approvare il numero. Bird presenta la verifica dal dashboard e ne riporta lo stato tramite l'API, così sai esattamente quando il numero è approvato. Se il tuo traffico USA passa già attraverso A2P 10DLC, un long code è il mittente alternativo.

FAQ sui toll-free

Cos'è un numero SMS toll-free?+
Un numero toll-free è un numero 8xx (800, 888, 877 e gli altri prefissi toll-free) che invia e riceve SMS in USA e Canada. Trasporta traffico applicativo senza A2P 10DLC, una volta superata la verifica toll-free.
I numeri toll-free necessitano della registrazione 10DLC?+
No. I numeri toll-free si collocano al di fuori del sistema A2P 10DLC. Passano invece attraverso la verifica toll-free, in cui i carrier esaminano il caso d'uso e il contenuto dei messaggi prima che il numero sia autorizzato a inviare a pieno volume.
Un numero toll-free può ricevere risposte?+
Sì. I numeri toll-free sono bidirezionali: instrada l'inbound del numero verso un webhook e le risposte arrivano come eventi firmati con HMAC, come per qualsiasi altro numero SMS di Bird.
Quando dovrei usare invece un long code?+
Ricorri a un long code quando vuoi un prefisso locale o quando il tuo traffico USA passa già attraverso A2P 10DLC. Un numero toll-free vince quando vuoi un unico mittente 8xx che copra sia USA sia Canada senza registrare campagne 10DLC.

Un unico numero verificato per l'intero continente.

Il toll-free è uno dei tipi di mittente sulla superficie dei numeri SMS di Bird. Provisiona un numero 8xx, supera la verifica e instrada l'inbound dalla stessa API con cui invii.

Inizia con un canale.
Aggiungi gli altri quando sei pronto.

Una chiave API di test è subito tua. La produzione si sblocca quando aggiungi un metodo di pagamento e verifichi un mittente.

Usi Claude Code, Cursor o Codex? Copia un prompt di configurazione e il tuo agente installerà la CLI e le skill di Bird per te. Scegli il tuo:

Cursor