A2P 10DLC

Registe uma vez, envie para os EUA.

O A2P 10DLC é a forma como o SMS application-to-person chega aos destinatários dos EUA em números padrão de 10 dígitos. Regista uma marca e depois uma campanha que descreve as mensagens que envia. Os operadores avaliam ambos e concedem débito à campanha assim que for aprovada.

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

Porque existe o 10DLC.

O A2P 10DLC faz parte da conformidade de SMS na API de SMS da Bird. Os operadores dos EUA exigem que qualquer empresa que envie tráfego de aplicações por long codes locais registe a marca por trás dele e cada campanha que executa. O tráfego registado ganha débito avaliado e a confiança dos operadores; o tráfego não registado é filtrado. A Bird submete ambos e reporta o estado de aprovação para que envie para uma campanha que está de facto ativa.

O fluxo de registo.

Marca, depois campanha, depois os números que a transportam.

01
Registe uma marca.
Submeta a entidade legal por trás do seu tráfego. Os operadores avaliam-na e a marca torna-se a identidade a que cada campanha se associa.
02
Registe uma campanha.
Descreva as mensagens que envia — o caso de uso, conteúdo de exemplo e fluxo de opt-in. A aprovação é o que desbloqueia o débito da campanha.
03
Associe os seus números.
Associe os long codes que transportarão a campanha. A partir daí, o seu tráfego de aplicações dos EUA passa pela campanha registada.
04
Consulte o estado até estar ativo.
A aprovação demora dias a semanas. Faça polling ao estado da campanha através da API para que o seu código aguarde por ela em vez de enviar para uma campanha pendente.

Verifique o estado de uma campanha a partir da API.

Submete a marca e a campanha a partir do dashboard; a API expõe o ponto em que cada uma se encontra. Leia a campanha pelo seu id e ramifique conforme o estado antes de começar a enviar.

campaign-status.ts

200 · approved

const { data: campaign } = await bird.sms.compliance.campaigns
  .get("cmp_7Hq2...")
  .safe();

if (campaign.status === "approved") {
  // throughput is live — safe to send
}

console.log(campaign.brandId); // → "brand_3Lx9..."

O 10DLC é como os long codes ganham débito nos EUA.

Se enviar a partir de long codes, o 10DLC é o que os transforma de um risco de filtragem num remetente avaliado. O número é seu no momento em que o compra, mas o seu tráfego de aplicações dos EUA só flui à taxa máxima assim que a campanha a que está associado for aprovada.

Perguntas frequentes sobre A2P 10DLC

O que é o A2P 10DLC?+

O A2P 10DLC é o enquadramento dos operadores dos EUA para SMS application-to-person enviado por long codes padrão de 10 dígitos. Uma empresa regista a marca por trás do seu tráfego e uma campanha que descreve as mensagens, e os operadores avaliam ambos antes de conceder débito.

Qual é a diferença entre uma marca e uma campanha?+

A marca é a entidade legal que envia o tráfego. Uma campanha descreve um caso de uso de mensagens específico sob essa marca. Uma marca pode ter várias campanhas, e os números associam-se a uma campanha e não à marca.

Quanto tempo demora a aprovação?+

A avaliação de marca e campanha decorre através dos operadores e do registo e demora tipicamente dias a semanas. Consulte o estado da campanha através da API para que o seu código aguarde a aprovação antes de enviar.

O 10DLC aplica-se fora dos EUA?+

Não. O 10DLC é um enquadramento dos EUA. Outros países têm as suas próprias regras — muitos exigem pré-registo de sender ID — e o tratamento de palavras-chave de opt-out aplica-se onde quer que envie.

Outros tópicos de conformidade

O 10DLC é um de três regimes de conformidade de SMS. Veja os restantes.

Opt-out (STOP/HELP)Palavras-chave STOP, HELP e START respeitadas automaticamente, com uma lista de supressão consultável.Registo de sender IDPré-registe sender IDs alfanuméricos onde os países o exigem.Toda a conformidade de SMS10DLC, opt-out e registo de sender ID num único lugar.Visão geral da API de SMSA API de SMS completa: envio, números, bidirecional, conformidade, encaminhamento e analítica.

Submeta a sua marca e campanha e depois envie.

O 10DLC é um regime de conformidade de SMS na Bird. Registe a partir do dashboard, acompanhe a aprovação através da API e envie para destinatários dos EUA com débito avaliado.

Explorar a conformidade de SMS Começar