L'A2P 10DLC est la façon dont les SMS application-to-person atteignent les destinataires américains sur des numéros standard à 10 chiffres. Vous enregistrez une marque, puis une campagne qui décrit les messages que vous envoyez. Les opérateurs vérifient les deux et accordent un débit à la campagne une fois qu'elle est approuvée.
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..."Today at 2:14 PM
Pourquoi le 10DLC existe.
L'A2P 10DLC fait partie de la conformité SMS sur l'API SMS de Bird. Les opérateurs américains exigent que toute entreprise envoyant du trafic applicatif via des long codes locaux enregistre la marque qui en est à l'origine ainsi que chaque campagne qu'elle exécute. Le trafic enregistré obtient un débit vérifié et la confiance des opérateurs ; le trafic non enregistré est filtré. Bird dépose les deux et signale l'état d'approbation afin que vous envoyiez dans une campagne réellement active.
Le flux d'enregistrement.
La marque, puis la campagne, puis les numéros qui la portent.
- 01
Enregistrez une marque.
Soumettez l'entité juridique derrière votre trafic. Les opérateurs la vérifient et la marque devient l'identité à laquelle chaque campagne se rattache.
- 02
Enregistrez une campagne.
Décrivez les messages que vous envoyez — le cas d'usage, des exemples de contenu et le flux d'opt-in. C'est l'approbation qui débloque le débit de la campagne.
- 03
Associez vos numéros.
Rattachez les long codes qui porteront la campagne. À partir de là, leur trafic applicatif américain passe par la campagne enregistrée.
- 04
Interrogez le statut jusqu'à ce qu'elle soit active.
L'approbation prend de quelques jours à quelques semaines. Interrogez l'état de la campagne via l'API afin que votre code l'attende plutôt que d'envoyer dans une campagne en attente.
Vérifiez le statut d'une campagne depuis l'API.
Vous déposez la marque et la campagne depuis le tableau de bord ; l'API expose l'état de chacune. Lisez la campagne par son id et branchez sur le statut avant de commencer à envoyer.
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..."Le 10DLC est la façon dont les long codes obtiennent un débit américain.
Si vous envoyez depuis des long codes, le 10DLC est ce qui les transforme d'un risque de filtrage en un expéditeur vérifié. Le numéro est à vous dès l'instant où vous l'achetez, mais son trafic applicatif américain ne circule à plein débit qu'une fois la campagne à laquelle il est associé approuvée.
FAQ sur l'A2P 10DLC
Qu'est-ce que l'A2P 10DLC ?+
Quelle est la différence entre une marque et une campagne ?+
Combien de temps prend l'approbation ?+
Le 10DLC s'applique-t-il en dehors des États-Unis ?+
Autres sujets de conformité
Le 10DLC est l'un des trois régimes de conformité SMS. Découvrez les autres.
Déposez votre marque et votre campagne, puis envoyez.
Le 10DLC est l'un des régimes de la conformité SMS sur Bird. Enregistrez depuis le tableau de bord, suivez l'approbation via l'API, et envoyez aux destinataires américains avec un débit vérifié.