A2P 10DLC

Registrati una volta, invia verso gli USA.

A2P 10DLC è il modo in cui gli SMS application-to-person raggiungono i destinatari USA su numeri standard a 10 cifre. Registri un brand, poi una campagna che descrive i messaggi che invii. I carrier verificano entrambi e concedono il throughput alla campagna una volta approvata.

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

Perché esiste il 10DLC.

A2P 10DLC fa parte della conformità SMS sull'API SMS di Bird. I carrier USA richiedono a qualsiasi azienda che invii traffico applicativo su long code locali di registrare il brand che c'è dietro e ogni campagna che gestisce. Il traffico registrato ottiene un throughput verificato e la fiducia dei carrier; il traffico non registrato viene filtrato. Bird presenta entrambi e riporta lo stato di approvazione così invii verso una campagna che è davvero attiva.

Il flusso di registrazione.

Prima il brand, poi la campagna, poi i numeri che la trasportano.

01
Registra un brand.
Sottoponi l'entità legale dietro il tuo traffico. I carrier la verificano e il brand diventa l'identità a cui si collega ogni campagna.
02
Registra una campagna.
Descrivi i messaggi che invii — il caso d'uso, contenuti di esempio e il flusso di opt-in. È l'approvazione a sbloccare il throughput della campagna.
03
Associa i tuoi numeri.
Collega i long code che trasporteranno la campagna. Da quel momento il loro traffico applicativo USA passa attraverso la campagna registrata.
04
Interroga lo stato finché non è attiva.
L'approvazione richiede da giorni a settimane. Fai polling sullo stato della campagna tramite l'API così il tuo codice la attende invece di inviare verso una campagna in sospeso.

Controlla lo stato di una campagna dall'API.

Presenti il brand e la campagna dal dashboard; l'API espone a che punto si trova ciascuno. Leggi la campagna tramite il suo id e ramifica in base allo stato prima di iniziare a inviare.

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

Il 10DLC è il modo in cui i long code ottengono il throughput USA.

Se invii da long code, è il 10DLC a trasformarli da rischio di filtraggio a mittente verificato. Il numero è tuo nel momento in cui lo acquisti, ma il suo traffico applicativo USA scorre a pieno regime solo quando la campagna a cui è associato viene approvata.

FAQ su A2P 10DLC

Cos'è A2P 10DLC?+

A2P 10DLC è il framework dei carrier USA per gli SMS application-to-person inviati su long code standard a 10 cifre. Un'azienda registra il brand dietro il proprio traffico e una campagna che descrive i messaggi, e i carrier verificano entrambi prima di concedere il throughput.

Qual è la differenza tra un brand e una campagna?+

Il brand è l'entità legale che invia il traffico. Una campagna descrive un caso d'uso di messaggistica specifico sotto quel brand. Un brand può avere più campagne e associ i numeri a una campagna anziché al brand.

Quanto tempo richiede l'approvazione?+

La verifica di brand e campagna passa attraverso i carrier e il registro e tipicamente richiede da giorni a settimane. Interroga lo stato della campagna tramite l'API così il tuo codice attende l'approvazione prima di inviare.

A2P 10DLC si applica fuori dagli USA?+

No. Il 10DLC è un framework statunitense. Altri paesi hanno le proprie regole — molti richiedono invece la pre-registrazione del sender ID — e la gestione delle keyword di opt-out vale ovunque tu invii.

Altri argomenti di conformità

Il 10DLC è uno dei tre regimi di conformità SMS. Scopri gli altri.

Opt-out (STOP/HELP)Keyword STOP, HELP e START rispettate automaticamente, con una lista di soppressione interrogabile.Registrazione del sender IDPre-registra i sender ID alfanumerici dove i paesi lo richiedono.Tutta la conformità SMS10DLC, opt-out e registrazione del sender ID in un unico punto.Panoramica dell'API SMSL'API SMS completa: invio, numeri, bidirezionale, conformità, routing e analisi.

Presenta il tuo brand e la tua campagna, poi invia.

Il 10DLC è uno dei regimi di conformità SMS su Bird. Registrati dal dashboard, monitora l'approvazione tramite l'API e invia ai destinatari USA con un throughput verificato.

Esplora la conformità SMS Inizia ora