Números

O remetente certo para cada mensagem.

Long codes, short codes, números toll-free e sender IDs alfanuméricos — aprovisionados, registados e encaminhados através de um endpoint. O remetente a partir do qual envia decide o débito, o custo e qual o regime de conformidade que se aplica.

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

Quatro tipos de remetente, uma API.

Os números são a base da API de SMS da Bird. Pesquise disponibilidade, compre um número e encaminhe o tráfego de entrada para um webhook com o mesmo cliente com que já envia. O tipo que escolhe depende do volume, da geografia e de quanto registo pode assumir.

Que remetente devo usar?

O débito, o alcance e o esforço de registo diferem por tipo de remetente. A maioria do tráfego de aplicações dos EUA começa num long code 10DLC; programas de um-para-muitos de alto volume passam para um short code.

Tipo de remetente	Melhor para	Registo
Long code (10DLC)	Conversas bidirecionais, OTP, alertas a volume moderado	Marca + campanha A2P 10DLC
Short code	Marketing e alertas um-para-muitos de alto volume	Avaliado pelos operadores, prazo de semanas
Toll-free	Tráfego EUA/Canadá sem 10DLC, maior débito que um long code	Verificação toll-free
Sender ID alfanumérico	Alertas de marca unidirecionais onde o país o permite	Pré-registo em muitos países

Escolha um tipo de número

Cada tipo de remetente em detalhe — alcance, débito e o que é preciso para registar.

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.Toll-freeNúmeros toll-free verificados para tráfego dos EUA e Canadá sem 10DLC.Sender IDs alfanuméricosEnvie a partir do nome da sua marca onde o país de destino o permite.

Pesquise, compre e encaminhe em poucas chamadas.

Encontre um número por país e capacidade, compre-o e aponte o seu tráfego de entrada para um webhook — tudo a partir do mesmo SDK com que envia. O número fica ativo assim que qualquer registo exigido for concluído.

provision.ts

201 · purchased

const { data: available } = await bird.numbers.search({
  country: "US",
  type:    "long-code",
  capabilities: ["sms"],
}).safe();

const { data: number } = await bird.numbers.buy({
  number:  available[0].number,
  webhook: "https://example.com/webhooks/bird",
}).safe();

console.log(number.id); // → "num_8KQ2..."

Registo, tratado onde é exigido.

A maioria do tráfego de aplicações dos EUA precisa de registo de marca e campanha A2P 10DLC; o toll-free precisa de verificação; muitos países exigem pré-registo de sender ID. A Bird gere cada um a partir do dashboard, e a superfície de conformidade acompanha o estado a partir da API.

Perguntas frequentes sobre números de SMS

Com que tipo de número devo começar?+

Para tráfego de aplicações dos EUA, um long code 10DLC cobre a maioria dos casos de uso bidirecionais e de OTP. Programas de um-para-muitos de alto volume passam para um short code; o toll-free é uma opção para EUA/Canadá sem 10DLC.

Quanto tempo demora a colocar um número ativo?+

Um long code ou número toll-free fica disponível de imediato e começa a enviar assim que o seu registo ou verificação for concluído. Os short codes são avaliados pelos operadores e demoram tipicamente semanas.

Um mesmo número pode enviar e receber?+

Sim. Long codes, short codes e números toll-free são bidirecionais: aponte o tráfego de entrada de um número para um webhook e as respostas chegam como eventos assinados. Os sender IDs alfanuméricos são apenas unidirecionais.

Preciso de me registar antes de poder enviar?+

Depende do tipo de remetente e do país. O tráfego de aplicações dos EUA precisa de A2P 10DLC, o toll-free precisa de verificação, e muitos países exigem pré-registo de sender ID — tudo tratado a partir do dashboard.

O resto da plataforma de SMS

Uma API, um único conjunto de chaves. Explore as outras capacidades.

EnvioA API de envio: segmentos, segurança Unicode, lotes e idempotência.BidirecionalSMS recebidos e respostas conversacionais como webhooks assinados com HMAC.ConformidadeRegisto A2P 10DLC, opt-out com STOP/HELP e regras de sender ID.EncaminhamentoMais de 150 países, 240 ligações direct-to-carrier e failover.AnalíticaMétricas de entrega e interação a partir dos recibos de entrega do operador.Visão geral da API de SMSA API de SMS completa: envio, números, bidirecional, conformidade, encaminhamento e analítica.

Aprovisione o número certo, encaminhe-o em minutos.

Os números são uma das capacidades da API de SMS da Bird: envio, receção bidirecional, conformidade, encaminhamento e analítica vêm incluídos.

Explorar a plataforma de SMS Começar