Toll-free

Um número 8xx, EUA e Canadá.

Um número toll-free é um número 8xx que envia e recebe SMS nos EUA e no Canadá. Ele transporta tráfego de aplicações sem A2P 10DLC, após ter passado pela verificação toll-free, o que garante um throughput mais alto e previsível do que um código longo não registrado.

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 um número toll-free encaixa.

Toll-free é um dos quatro tipos de remetente em números SMS Bird, parte da API SMS Bird mais ampla. Utilize-o quando um único número precisar cobrir tanto os EUA quanto o Canadá e você preferir evitar o registro A2P 10DLC: a verificação cuida da análise pelas operadoras.

O que um número toll-free lhe dá.

Alcance transfronteiriço, tráfego bidirecional, sem 10DLC.

  1. 01

    EUA e Canadá a partir de um número.

    Um único número 8xx alcança destinatários de ambos os lados da fronteira, por isso não aprovisiona nem gere um remetente separado por país.

  2. 02

    Bidirecional por omissão.

    Direcione o tráfego de entrada do número para um webhook e as respostas chegam como eventos assinados — a mesma base conversacional de qualquer número Bird.

  3. 03

    Sem necessidade de A2P 10DLC.

    O tráfego toll-free fica inteiramente fora do sistema 10DLC, por isso não há registo de marca e campanha para submeter antes de enviar.

  4. 04

    Concluído através da verificação toll-free.

    Os operadores revêem primeiro o caso de uso e o conteúdo das mensagens; assim que a verificação for concluída, o número envia a volume máximo em vez de limitado ou filtrado.

Compre um e comece a enviar.

Pesquise por país e funcionalidade, compre o número e direcione o tráfego de entrada para um webhook — o mesmo client com que você envia. A mesma estrutura de código provisiona qualquer tipo de remetente; apenas o campo type muda.

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();

A verificação faz parte do acordo.

Antes de um número toll-free poder enviar tráfego de aplicações, ele passa pela verificação toll-free: as operadoras analisam seu caso de uso, mensagens de exemplo e opt-in antes de aprovar o número. Bird submete a verificação pelo painel e reporta o status pela API, para que você saiba exatamente quando o número está liberado. Se o seu tráfego nos EUA já opera via A2P 10DLC, um código longo é o remetente alternativo.

Perguntas frequentes sobre toll-free

O que é um número toll-free de SMS?
Um número toll-free é um número 8xx (800, 888, 877 e os restantes prefixos toll-free) que envia e recebe SMS nos EUA e no Canadá. Transporta tráfego de aplicações sem A2P 10DLC, assim que tiver passado a verificação toll-free.
Os números toll-free precisam de registo 10DLC?
Não. Os números toll-free ficam fora do sistema A2P 10DLC. Em vez disso, passam pela verificação toll-free, onde os operadores revêem o caso de uso e o conteúdo das mensagens antes de o número ser autorizado a enviar a volume máximo.
Um número toll-free pode receber respostas?
Sim. Os números toll-free são bidirecionais: encaminhe o tráfego de entrada do número para um webhook e as respostas chegam como eventos assinados com HMAC, tal como qualquer outro número de SMS da Bird.
Quando devo usar antes um long code?
Recorra a um long code quando quiser um indicativo local ou o seu tráfego dos EUA já passar por A2P 10DLC. Um número toll-free ganha quando quer um remetente 8xx que cubra tanto os EUA como o Canadá sem registar campanhas 10DLC.

Um número verificado para todo o continente.

O toll-free é um tipo de remetente na superfície de números de SMS da Bird. Aprovisione um número 8xx, conclua a verificação e encaminhe o tráfego de entrada a partir da mesma API com que envia.

Comece com um canal.
Adicione os outros quando estiver pronto.

Uma chave API de teste é sua imediatamente. A produção é desbloqueada quando você adiciona um método de pagamento e verifica um remetente.

Usa Claude Code, Cursor ou Codex? Copie um prompt de configuração e o seu agente instala o Bird CLI e as skills por si. Escolha o seu:

Cursor