A2P 10DLC is hoe application-to-person SMS Amerikaanse ontvangers bereikt op standaard 10-cijferige nummers. Je registreert een brand, daarna een campagne die de berichten beschrijft die je verstuurt. Carriers toetsen beide en verlenen de campagne throughput zodra deze is goedgekeurd.
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..."
Waarom 10DLC bestaat.
A2P 10DLC is onderdeel van SMS compliance op de Bird SMS API. Amerikaanse carriers vereisen dat elk bedrijf dat applicatieverkeer over lokale long codes verstuurt, de brand erachter en elke campagne die het draait registreert. Geregistreerd verkeer verdient getoetste throughput en carriervertrouwen; ongeregistreerd verkeer wordt gefilterd. Bird dient beide in en rapporteert de goedkeuringsstaat zodat je verstuurt naar een campagne die ook echt live is.
De registratieflow.
Brand, dan campagne, dan de nummers die het dragen.
- 01
Registreer een brand.
Dien de juridische entiteit achter je verkeer in. De carriers toetsen het en de brand wordt de identiteit waaraan elke campagne zich koppelt.
- 02
Registreer een campagne.
Beschrijf de berichten die u verstuurt: het gebruiksscenario, voorbeeldinhoud en het opt-in-proces. Goedkeuring is wat de doorvoercapaciteit van de campagne ontgrendelt.
- 03
Koppel je nummers.
Koppel de long codes die de campagne gaan dragen. Vanaf dan loopt hun Amerikaanse applicatieverkeer over de geregistreerde campagne.
- 04
Bevraag de status tot het live is.
Goedkeuring duurt dagen tot weken. Poll de staat van de campagne via de API zodat je code erop wacht in plaats van te verzenden naar een campagne die nog in behandeling is.
Controleer de status van een campagne via de API.
Je dient de brand en campagne in vanuit het dashboard; de API stelt beschikbaar waar elk staat. Lees de campagne op zijn id en vertak op de status voordat je begint met verzenden.
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 is hoe long codes Amerikaanse throughput verdienen.
Als je verstuurt vanaf long codes, is 10DLC wat ze verandert van een filterrisico in een getoetste afzender. Het nummer is van jou op het moment dat je het koopt, maar het Amerikaanse applicatieverkeer ervan stroomt pas op volle snelheid zodra de campagne waaraan het is gekoppeld is goedgekeurd.
Wat registratie kost.
TCR stelt deze kosten vast en Bird berekent ze door tegen kostprijs, live geprijsd via de Bird billing API: eenmalige merkkosten, eenmalige toetsingskosten per campagne-indiening en maandelijks terugkerende kosten per campagne die variëren per use case.
Registratiekosten
Andere compliance-onderwerpen
10DLC is een van de drie SMS-compliance-regimes. Bekijk de rest.
Dien je brand en campagne in, en verstuur.
10DLC is één regime van SMS compliance op Bird. Registreer vanuit het dashboard, volg goedkeuring via de API, en verstuur naar Amerikaanse ontvangers met getoetste throughput.