Long Codes

Lokale Nummern, standardmäßig zweiseitig.

Ein Long Code ist eine standardmäßige 10-stellige Telefonnummer, die SMS sendet und empfängt. Er ist der Standardabsender für Zwei-Wege-Konversationen, OTP und Benachrichtigungen bei moderatem Volumen. Für US-Anwendungstraffic wird er über A2P 10DLC registriert.

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

Today at 2:14 PM

Hey Ada — your Bird sign-in code is 482917. It'll expire in 10 minutes. Don't share it with anyone.
482917
Delivered

Wann ein Long Code die richtige Wahl ist.

Long Codes sind einer der vier Absendertypen auf der Bird SMS-Nummern-Oberfläche, Teil der umfassenderen Bird SMS-API. Sie sind lokal, zweiseitig und schnell bereitgestellt — der richtige Ausgangspunkt für den meisten dialogorientierten und transaktionalen Traffic, bevor das Volumen einen Short Code rechtfertigt.

Was Ihnen ein Long Code bietet.

Lokale Präsenz, Zwei-Wege-Traffic, moderates Volumen.

  1. 01

    Eine lokale 10-stellige Nummer.

    Empfänger sehen eine Vorwahl aus ihrem eigenen Land oder ihrer Region, was sich als echter Absender liest statt als Marketing-Aussendung.

  2. 02

    Standardmäßig zweiseitig.

    Richten Sie den eingehenden Traffic der Nummer auf einen Webhook, und Antworten treffen als signierte Ereignisse ein — das Fundament für dialogorientierte Abläufe.

  3. 03

    Registriert über A2P 10DLC.

    US-Anwendungstraffic läuft über registrierte 10DLC-Kampagnen, was geprüften Durchsatz und das Vertrauen der Carrier statt eines Filterrisikos einbringt.

  4. 04

    Aktiv, sobald die Registrierung abgeschlossen ist.

    Kaufen Sie die Nummer sofort; sie beginnt registrierten Traffic zu tragen, sobald ihre 10DLC-Kampagne genehmigt ist.

Kaufen Sie eine und beginnen Sie zu senden.

Suchen Sie nach Land und Fähigkeit, kaufen Sie die Nummer und routen Sie ihren eingehenden Traffic an einen Webhook — derselbe Client, mit dem Sie senden. Dieselbe Code-Struktur stellt jeden Absendertyp bereit; nur das Typ-Feld ändert sich.

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();

Die Registrierung gehört dazu.

Um Application-to-Person-Traffic an US-Nummern zu senden, läuft ein Long Code über eine registrierte A2P 10DLC-Kampagne. Bird reicht die Marke und Kampagne über das Dashboard ein und meldet den Genehmigungsstatus über die API, sodass Sie genau wissen, wann der volle Durchsatz verfügbar ist.

Long-Code-FAQ

Was ist ein 10DLC-Long-Code?+
Ein 10-stelliger Long Code (10DLC) ist eine standardmäßige lokale Telefonnummer, die in den USA für Application-to-Person-SMS autorisiert ist, sobald ihre Marke und Kampagne bei den Carriern registriert sind.
Wie viel Durchsatz erhält ein Long Code?+
Registrierte 10DLC-Long-Codes erhalten geprüften Durchsatz, der vom Trust-Score der Marke und vom Kampagnentyp abhängt — mehr als eine nicht registrierte Nummer, weniger als ein Short Code.
Kann ein Long Code Antworten empfangen?+
Ja. Long Codes sind zweiseitig: Routen Sie den eingehenden Traffic der Nummer an einen Webhook, und Antworten treffen als HMAC-signierte Ereignisse ein.
Wann sollte ich stattdessen zu einem Short Code wechseln?+
Wenn das One-to-Many-Volumen über das hinauswächst, was der Durchsatz eines Long Codes trägt, oder wenn ein Programm die höhere, planbarere Rate benötigt, die ein Carrier-geprüfter Short Code bietet.

Beginnen Sie auf einem Long Code, skalieren Sie bei Bedarf.

Long Codes sind ein Absendertyp auf der Bird SMS-Nummern-Oberfläche. Stellen Sie einen bereit, registrieren Sie die Kampagne und routen Sie eingehenden Traffic über dieselbe API, mit der Sie senden.

Starten Sie mit einem Kanal.
Fügen Sie die anderen hinzu, wenn Sie bereit sind.

Ein Test-API-Key steht Ihnen sofort zur Verfügung. Der Produktivzugang wird freigeschaltet, sobald Sie eine Zahlungsmethode hinzufügen und einen Absender verifizieren.

Sie nutzen Claude Code, Cursor oder Codex? Kopieren Sie einen Setup-Prompt und Ihr Agent installiert die Bird CLI und Skills für Sie. Wählen Sie Ihren:

Cursor