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: "+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"
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 capacidade e compre o número, o mesmo cliente com o qual você envia. O tráfego de entrada é roteado por um webhook de workspace inscrito em sms.received, não por número. A mesma estrutura de código provisiona qualquer tipo de remetente; apenas number_type muda.
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..."
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.
Coloque em prática.
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
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.