Long codes

Números locais, bidirecionais por omissão.

Um long code é um número de telefone padrão de 10 dígitos que envia e recebe SMS. É o remetente por omissão para conversas bidirecionais, OTP e alertas a volume moderado. Para tráfego de aplicações dos EUA é registado através de A2P 10DLC.

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 long code é a escolha certa.

Os long codes são um dos quatro tipos de remetente na superfície de números de SMS da Bird, parte da API de SMS da Bird mais ampla. São locais, bidirecionais e rápidos de aprovisionar — o ponto de partida certo para a maioria do tráfego conversacional e transacional antes de o volume justificar um short code.

O que um long code lhe dá.

Presença local, tráfego bidirecional, volume moderado.

01
Um número local de 10 dígitos.
Os destinatários veem um indicativo do seu próprio país ou região, o que se lê como um remetente real em vez de um disparo de marketing.
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 base para fluxos conversacionais.
03
Registado através de A2P 10DLC.
O tráfego de aplicações dos EUA passa por campanhas 10DLC registadas, o que ganha débito avaliado e a confiança dos operadores em vez de um risco de filtragem.
04
Ativo assim que o registo for concluído.
Compre o número de imediato; começa a transportar tráfego registado assim que a sua campanha 10DLC for aprovada.

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.

long-code.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();

O registo faz parte do acordo.

Para enviar tráfego application-to-person para números dos EUA, um long code passa por uma campanha A2P 10DLC registada. A Bird submete a marca e a campanha a partir do dashboard e reporta o estado de aprovação através da API, para que saiba exatamente quando o débito máximo está disponível.

Perguntas frequentes sobre long codes

O que é um long code 10DLC?+

Um long code de 10 dígitos (10DLC) é um número de telefone local padrão sancionado para SMS application-to-person nos EUA, assim que a sua marca e campanha estiverem registadas junto dos operadores.

Que débito obtém um long code?+

Os long codes 10DLC registados obtêm um débito avaliado que depende da pontuação de confiança da marca e do tipo de campanha — mais do que um número não registado, menos do que um short code.

Um long code pode receber respostas?+

Sim. Os long codes são bidirecionais: encaminhe o tráfego de entrada do número para um webhook e as respostas chegam como eventos assinados com HMAC.

Quando devo passar antes para um short code?+

Quando o volume um-para-muitos ultrapassa o que o débito de um long code suporta, ou quando um programa precisa da taxa mais elevada e previsível que um short code avaliado pelos operadores oferece.

Outras formas de enviar

Os long codes são um de quatro tipos de remetente. Compare os restantes.

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

Comece num long code, escale quando precisar.

Os long codes são um tipo de remetente na superfície de números de SMS da Bird. Aprovisione um, registe a campanha e encaminhe o tráfego de entrada a partir da mesma API com que envia.

Explorar os números de SMS Começar