A2P 10DLC

Registreer één keer, verstuur naar de VS.

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.

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

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 je verstuurt — de use case, voorbeeldcontent en opt-in-flow. Goedkeuring is wat de throughput 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.

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

A2P 10DLC FAQ

Wat is A2P 10DLC?+

A2P 10DLC is het Amerikaanse carrier-framework voor application-to-person SMS verzonden over standaard 10-cijferige long codes. Een bedrijf registreert de brand achter zijn verkeer en een campagne die de berichten beschrijft, en de carriers toetsen beide voordat ze throughput verlenen.

Wat is het verschil tussen een brand en een campagne?+

De brand is de juridische entiteit die het verkeer verstuurt. Een campagne beschrijft een specifieke berichtgevingscase onder die brand. Eén brand kan meerdere campagnes hebben, en je koppelt nummers aan een campagne in plaats van aan de brand.

Hoe lang duurt goedkeuring?+

Brand- en campagnetoetsing loopt via de carriers en registry en duurt doorgaans dagen tot weken. Bevraag de status van de campagne via de API zodat je code op goedkeuring wacht voordat het verstuurt.

Geldt 10DLC buiten de VS?+

Nee. 10DLC is een Amerikaans framework. Andere landen hebben hun eigen regels — veel vereisen in plaats daarvan sender-ID-preregistratie — en opt-out-keywordafhandeling geldt overal waar je verstuurt.

Andere compliance-onderwerpen

10DLC is een van de drie SMS-compliance-regimes. Bekijk de rest.

Opt-out (STOP/HELP)STOP-, HELP- en START-keywords automatisch gehonoreerd, met een opvraagbare suppressielijst.Sender-ID-registratiePreregistreer alfanumerieke sender ID's waar landen het vereisen.Alle SMS compliance10DLC, opt-out en sender-ID-registratie op één plek.SMS API-overzichtDe volledige SMS API: verzenden, nummers, two-way, compliance, routering en analytics.

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.

Verken SMS compliance Aan de slag