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.
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: "+15005550006",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).safe();
if (error) throw error;
console.log(data.id);
// → "sms_4kT01Lq2m..."
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.
- 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.
- 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.
- 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.
- 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.
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.
Outras formas de enviar
O toll-free é um de quatro tipos de remetente. Compare os restantes.
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.