A2P 10DLC

Regístrate una vez, envía a EE. UU.

A2P 10DLC es la forma en que el SMS application-to-person llega a los destinatarios de EE. UU. en números estándar de 10 dígitos. Registras una marca y luego una campaña que describe los mensajes que envías. Los operadores verifican ambos y conceden capacidad de envío a la campaña una vez aprobada.

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

Por qué existe 10DLC.

A2P 10DLC forma parte del cumplimiento de SMS en la API de SMS de Bird. Los operadores de EE. UU. exigen que toda empresa que envíe tráfico de aplicación por long codes locales registre la marca que hay detrás y cada campaña que ejecuta. El tráfico registrado obtiene capacidad de envío verificada y la confianza del operador; el tráfico no registrado se filtra. Bird presenta ambos y reporta el estado de aprobación para que envíes a una campaña que realmente está activa.

El flujo de registro.

Marca, luego campaña, luego los números que la llevan.

01
Registra una marca.
Envía la entidad legal que hay detrás de tu tráfico. Los operadores la verifican y la marca se convierte en la identidad a la que se asocia cada campaña.
02
Registra una campaña.
Describe los mensajes que envías — el caso de uso, contenido de ejemplo y el flujo de opt-in. La aprobación es lo que desbloquea la capacidad de envío de la campaña.
03
Asocia tus números.
Asocia los long codes que llevarán la campaña. A partir de entonces, su tráfico de aplicación en EE. UU. circula por la campaña registrada.
04
Consulta el estado hasta que esté activa.
La aprobación tarda de días a semanas. Sondea el estado de la campaña a través de la API para que tu código lo espere en lugar de enviar a una campaña pendiente.

Comprueba el estado de una campaña desde la API.

Presentas la marca y la campaña desde el dashboard; la API expone en qué punto está cada una. Lee la campaña por su id y ramifica según el estado antes de empezar 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..."

10DLC es cómo los long codes obtienen capacidad de envío en EE. UU.

Si envías desde long codes, 10DLC es lo que los transforma de un riesgo de filtrado a un remitente verificado. El número es tuyo desde el momento en que lo compras, pero su tráfico de aplicación en EE. UU. solo fluye a pleno ritmo una vez aprobada la campaña a la que está asociado.

Preguntas frecuentes sobre A2P 10DLC

¿Qué es A2P 10DLC?+

A2P 10DLC es el marco de los operadores de EE. UU. para el SMS application-to-person enviado por long codes estándar de 10 dígitos. Una empresa registra la marca detrás de su tráfico y una campaña que describe los mensajes, y los operadores verifican ambos antes de conceder capacidad de envío.

¿Cuál es la diferencia entre una marca y una campaña?+

La marca es la entidad legal que envía el tráfico. Una campaña describe un caso de uso de mensajería concreto bajo esa marca. Una marca puede tener varias campañas, y asocias los números a una campaña en lugar de a la marca.

¿Cuánto tarda la aprobación?+

La verificación de marca y campaña pasa por los operadores y el registro y suele tardar de días a semanas. Consulta el estado de la campaña a través de la API para que tu código espere la aprobación antes de enviar.

¿Se aplica 10DLC fuera de EE. UU.?+

No. 10DLC es un marco de EE. UU. Otros países tienen sus propias reglas — muchos exigen en su lugar el registro previo del ID de remitente — y la gestión de palabras clave de cancelación se aplica dondequiera que envíes.

Otros temas de cumplimiento

10DLC es uno de los tres regímenes de cumplimiento de SMS. Mira el resto.

Cancelación (STOP/HELP)Palabras clave STOP, HELP y START respetadas automáticamente, con una lista de supresión consultable.Registro de ID de remitenteRegistra previamente los IDs de remitente alfanuméricos donde los países lo exijan.Todo el cumplimiento de SMS10DLC, cancelación y registro de ID de remitente en un solo lugar.Visión general de la API de SMSLa API de SMS completa: envío, números, bidireccional, cumplimiento, enrutamiento y analítica.

Presenta tu marca y campaña, y luego envía.

10DLC es uno de los regímenes de cumplimiento de SMS en Bird. Regístrate desde el dashboard, rastrea la aprobación a través de la API y envía a destinatarios de EE. UU. con capacidad de envío verificada.

Explora el cumplimiento de SMS Comenzar