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-notification.ts
202 · 0.4s
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..."
Hi Ada, reminder of your appointment tomorrow at 14:30 with Dr. Kowalski.
Your order #4821 has shipped. Track it: bird.ly/t/4821x
Your subscription renews on 3 Sep for €12/mo. Manage it here: bird.ly/account

Wanneer een long code de juiste keuze is.

Long codes zijn een van de vier afzendertypen op het Bird SMS-nummers-oppervlak, onderdeel van de bredere Bird SMS API. Ze zijn lokaal, tweerichtings en snel in te richten: het juiste startpunt voor de meeste conversatie- en transactieberichten voordat het volume een short code rechtvaardigt.

Wat een long code je geeft.

Lokale aanwezigheid, two-way verkeer, gematigd volume.

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

  2. 02

    Standaard two-way.

    Verwijs het inkomende verkeer van het nummer naar een webhook en antwoorden komen binnen als ondertekende events — de basis voor conversatieflows.

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

  4. 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 mogelijkheid, koop het nummer en routeer het inkomende verkeer naar een webhook — dezelfde client waarmee u verzendt. Dezelfde codestructuur richt elk afzendertype in; 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.

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.

Begin met één kanaal.
Voeg de rest toe wanneer je er klaar voor bent.

Een test-API-key is direct beschikbaar. Productietoegang wordt ontgrendeld zodra je een betaalmethode toevoegt en een afzender verifieert.

Gebruik je Claude Code, Cursor of Codex? Kopieer een setup-prompt en je agent installeert de Bird CLI en skills voor je. Kies de jouwe:

Cursor