Nummern

Der richtige Absender für jede Nachricht.

Long Codes, Short Codes, Toll-Free-Nummern und alphanumerische Sender-IDs — bereitgestellt, registriert und geroutet über einen Endpunkt. Der Absender, von dem Sie senden, entscheidet über Durchsatz, Kosten und welches Compliance-Regelwerk gilt.

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

Vier Absendertypen, eine API.

Nummern sind das Fundament der Bird SMS-API. Suchen Sie nach Verfügbarkeit, kaufen Sie eine Nummer und routen Sie eingehenden Traffic an einen Webhook mit demselben Client, mit dem Sie bereits senden. Welchen Typ Sie wählen, hängt vom Volumen, der Geografie und davon ab, wie viel Registrierung Sie übernehmen können.

Welchen Absender sollte ich verwenden?

Durchsatz, Reichweite und Registrierungsaufwand unterscheiden sich je nach Absendertyp. Der meiste US-Anwendungstraffic beginnt auf einem 10DLC-Long-Code; Programme mit hohem One-to-Many-Volumen wechseln zu einem Short Code.

AbsendertypAm besten fürRegistrierung
Long Code (10DLC)Zwei-Wege-Konversationen, OTP, Benachrichtigungen bei moderatem VolumenA2P 10DLC Marke + Kampagne
Short CodeMarketing und Benachrichtigungen mit hohem One-to-Many-VolumenCarrier-geprüft, Vorlaufzeit in Wochen
Toll-FreeUSA/Kanada-Traffic ohne 10DLC, höherer Durchsatz als ein Long CodeToll-Free-Verifizierung
Alphanumerische Sender-IDEinseitige Marken-Benachrichtigungen, wo das Land es erlaubtVorabregistrierung in vielen Ländern

Suchen, kaufen und routen in wenigen Aufrufen.

Finden Sie eine Nummer nach Land und Fähigkeit, kaufen Sie sie und richten Sie ihren eingehenden Traffic auf einen Webhook — alles über dasselbe SDK, mit dem Sie senden. Die Nummer ist aktiv, sobald jede erforderliche Registrierung abgeschlossen ist.

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

console.log(number.id); // → "num_8KQ2..."

Registrierung, dort abgewickelt, wo sie erforderlich ist.

Der meiste US-Anwendungstraffic erfordert eine A2P 10DLC-Marken- und Kampagnenregistrierung; Toll-Free erfordert eine Verifizierung; viele Länder verlangen eine Sender-ID-Vorabregistrierung. Bird betreibt jede davon über das Dashboard, und die Compliance-Oberfläche verfolgt den Status über die API.

SMS-Nummern-FAQ

Mit welchem Nummerntyp sollte ich beginnen?+
Für US-Anwendungstraffic deckt ein 10DLC-Long-Code die meisten Zwei-Wege- und OTP-Anwendungsfälle ab. Programme mit hohem One-to-Many-Volumen wechseln zu einem Short Code; Toll-Free ist eine Option für USA/Kanada ohne 10DLC.
Wie lange dauert es, eine Nummer aktiv zu schalten?+
Ein Long Code oder eine Toll-Free-Nummer ist sofort verfügbar und beginnt zu senden, sobald ihre Registrierung oder Verifizierung abgeschlossen ist. Short Codes werden von Carriern geprüft und dauern in der Regel Wochen.
Kann eine Nummer sowohl senden als auch empfangen?+
Ja. Long Codes, Short Codes und Toll-Free-Nummern sind zweiseitig: Richten Sie den eingehenden Traffic einer Nummer auf einen Webhook, und Antworten treffen als signierte Ereignisse ein. Alphanumerische Sender-IDs sind nur einseitig.
Muss ich registrieren, bevor ich senden kann?+
Das hängt vom Absendertyp und Land ab. US-Anwendungstraffic erfordert A2P 10DLC, Toll-Free erfordert eine Verifizierung, und viele Länder verlangen eine Sender-ID-Vorabregistrierung — alles über das Dashboard abgewickelt.

Stellen Sie die richtige Nummer bereit, routen Sie sie in Minuten.

Nummern sind eine Funktion der Bird SMS-API: Senden, eingehende Zwei-Wege-Kommunikation, Compliance, Routing und Analytics gehören dazu.

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