Toll-free

Un unico numero 8xx, USA e Canada.

Un numero toll-free è un numero 8xx che invia e riceve SMS negli Stati Uniti e in Canada. Gestisce traffico applicativo senza A2P 10DLC, una volta superata la verifica toll-free, che garantisce un throughput più elevato 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.`,
  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

Quando si adatta un numero toll-free.

Il toll-free è uno dei quattro tipi di mittente disponibili su Bird SMS numbers, parte della più ampia Bird SMS API. Sceglilo quando un unico numero deve coprire sia gli Stati Uniti che il Canada e preferisci evitare la registrazione A2P 10DLC: la verifica gestisce la revisione da parte degli operatori al posto tuo.

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, la stessa base conversazionale di qualsiasi numero 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 funzionalità, acquista il numero e instrada il traffico in entrata su un webhook, lo stesso client con cui invii. La stessa struttura di codice gestisce 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, deve superare la verifica toll-free: gli operatori esaminano il tuo caso d'uso, i messaggi di esempio e il consenso (opt-in) prima di approvare il numero. Bird invia la richiesta di verifica dalla dashboard e ne riporta lo stato tramite API, così sai esattamente quando il numero è autorizzato. Se il tuo traffico verso gli Stati Uniti è già gestito tramite A2P 10DLC, un long code è il tipo di 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