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á. Transporta tráfego de aplicações sem A2P 10DLC, assim que tiver passado a verificação toll-free — o que compra um débito mais elevado e previsível do que um long code não registado.

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

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

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

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

Quando um número toll-free encaixa.

O toll-free é um dos quatro tipos de remetente nos números de SMS da Bird, parte da API de SMS da Bird mais ampla. Recorra a ele quando um número deve cobrir tanto os EUA como o Canadá e preferir evitar o registo A2P 10DLC — a verificação trata da revisão dos operadores em vez disso.

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.
Aponte o tráfego de entrada do número para um webhook e as respostas chegam como eventos assinados — a mesma base conversacional que qualquer número da 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, compre o número e encaminhe o seu tráfego de entrada para um webhook — o mesmo cliente com que envia. A mesma forma de código aprovisiona qualquer tipo de remetente; só muda o campo de tipo.

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, passa pela verificação toll-free — os operadores revêem o seu caso de uso, mensagens de exemplo e opt-in antes de aprovar o número. A Bird submete a verificação a partir do dashboard e reporta o seu estado através da API, para que saiba exatamente quando o número está concluído. Se o seu tráfego dos EUA já passar por A2P 10DLC, um long code é 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.

Outras formas de enviar

O toll-free é um de quatro tipos de remetente. Compare os restantes.

Long codesNúmeros locais de 10 dígitos para tráfego bidirecional, registados através de A2P 10DLC.Short codesNúmeros de 5–6 dígitos feitos para envio um-para-muitos de alto débito.Sender IDs alfanuméricosEnvie a partir do nome da sua marca onde o país de destino o permite.Todos os números de SMSCompare cada tipo de remetente — alcance, débito e registo.Visão geral da API de SMSA API de SMS completa: envio, números, bidirecional, conformidade, encaminhamento e analítica.

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.

Explorar os números de SMS Começar