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.
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: "+15005550006",
text: "Your order #4821 has shipped. Track it: bird.ly/t/4821x",
category: "transactional",
}).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 libera o throughput 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.
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.
Custos de registo.
A TCR define estas taxas e a Bird repassa-as ao custo, com preços atualizados em tempo real a partir da API de faturação da Bird: uma taxa única de marca, uma taxa única de verificação por submissão de campanha e uma taxa mensal recorrente por campanha que varia consoante o caso de uso.
Taxas de registo
Outros tópicos de conformidade
O 10DLC é um de três regimes de conformidade de SMS. Veja os restantes.
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.