Long codes

Lokale nummers, standaard two-way.

Een long code is een standaard 10-cijferig telefoonnummer dat SMS verstuurt en ontvangt. Het is de standaardafzender voor two-way gesprekken, OTP en alerts bij gematigd volume. Voor Amerikaans applicatieverkeer wordt het geregistreerd via A2P 10DLC.

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

Wanneer een long code de juiste keuze is.

Long codes zijn een van de vier afzendertypes op de Bird SMS-nummers-surface, onderdeel van de bredere Bird SMS API. Ze zijn lokaal, two-way en snel te provisioneren — het juiste startpunt voor het meeste conversationele en transactionele verkeer voordat het volume een short code rechtvaardigt.

Wat een long code je geeft.

Lokale aanwezigheid, two-way verkeer, gematigd volume.

01
Een lokaal 10-cijferig nummer.
Ontvangers zien een netnummer uit hun eigen land of regio, wat overkomt als een echte afzender in plaats van een marketingblast.
02
Standaard two-way.
Richt het inkomende verkeer van het nummer op een webhook en antwoorden komen binnen als ondertekende events — het fundament voor conversationele flows.
03
Geregistreerd via A2P 10DLC.
Amerikaans applicatieverkeer loopt over geregistreerde 10DLC-campagnes, wat getoetste throughput en het vertrouwen van de carriers oplevert in plaats van een filterrisico.
04
Live zodra registratie rond is.
Koop het nummer direct; het begint geregistreerd verkeer te dragen zodra de 10DLC-campagne is goedgekeurd.

Koop er een en begin met verzenden.

Zoek op land en capability, koop het nummer, en route de inbound ervan naar een webhook — dezelfde client waarmee je verstuurt. Dezelfde codevorm provisioneert elk afzendertype; alleen het type-veld verandert.

long-code.ts

201 · purchased

const { data: available } = await bird.numbers.search({
  country: "US",
  type:    "long-code",
  capabilities: ["sms"],
}).safe();

const { data: number } = await bird.numbers.buy({
  number:  available[0].number,
  webhook: "https://example.com/webhooks/bird",
}).safe();

Registratie hoort erbij.

Om application-to-person verkeer naar Amerikaanse nummers te versturen, loopt een long code over een geregistreerde A2P 10DLC-campagne. Bird dient de brand en campagne in vanuit het dashboard en rapporteert de goedkeuringsstatus via de API, zodat je precies weet wanneer volledige throughput beschikbaar is.

Long code FAQ

Wat is een 10DLC long code?+

Een 10-cijferige long code (10DLC) is een standaard lokaal telefoonnummer dat is aangewezen voor application-to-person SMS in de VS zodra de brand en campagne ervan zijn geregistreerd bij de carriers.

Hoeveel throughput krijgt een long code?+

Geregistreerde 10DLC long codes krijgen getoetste throughput die afhangt van de trust score van de brand en het campagnetype — meer dan een ongeregistreerd nummer, minder dan een short code.

Kan een long code antwoorden ontvangen?+

Ja. Long codes zijn two-way: route de inbound van het nummer naar een webhook en antwoorden komen binnen als HMAC-ondertekende events.

Wanneer moet ik in plaats daarvan overstappen op een short code?+

Wanneer het volume van één naar velen groter wordt dan wat de throughput van een long code aankan, of wanneer een programma de hogere, beter voorspelbare snelheid van een door carriers getoetste short code nodig heeft.

Andere manieren om te versturen

Long codes zijn een van de vier afzendertypes. Vergelijk de rest.

Short codes5–6-cijferige nummers gebouwd voor verzenden met hoge throughput van één naar velen.Toll-freeGeverifieerde toll-free nummers voor VS- en Canada-verkeer zonder 10DLC.Alfanumerieke sender ID'sVerstuur vanaf je brandnaam waar het bestemmingsland het toestaat.Alle SMS-nummersVergelijk elk afzendertype — bereik, throughput en registratie.SMS API-overzichtDe volledige SMS API: verzenden, nummers, two-way, compliance, routering en analytics.

Begin op een long code, schaal wanneer je moet.

Long codes zijn één afzendertype op de Bird SMS-nummers-surface. Provisioneer er een, registreer de campagne, en route inbound vanuit dezelfde API waarmee je verstuurt.

Verken SMS-nummers Aan de slag