Routing

Der Pfad vom Versand zum Endgerät.

Eingerichtet in:
Cursor

Bird erreicht 150+ Länder über 240 Direct-to-Carrier-Verbindungen. Wenn sich ein Carrier-Pfad verschlechtert, wählen wir die Route in Echtzeit neu, bevor die nächste Nachricht hinausgeht. Und jeder Versand liefert eine Carrier-Zustellbestätigung zurück, sodass Sie stets wissen, ob das Endgerät sie erhalten hat.

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

Die Schicht, auf der Ihr Versand fährt.

Routing ist die Schicht unter der Bird SMS-API. Sie rufen einen Endpunkt mit einem from, einem to und einem text auf; darunter ermitteln wir den Carrier des Empfängers, wählen eine Verbindung und übergeben die Nachricht. Wenn ein Pfad schlecht wird, ändert sich die Route, und Ihr Code nicht.

Was die Routing-Schicht für Sie entscheidet.

Pro Nachricht aufgelöst, hinter einem API-Aufruf.

  1. 01

    Direct-to-Carrier-Verbindungen.

    240 Verbindungen verdrahten uns direkt mit den Mobilfunkbetreibern in 150+ Ländern. Keine Wiederverkäuferkette zwischen Ihrem Versand und dem SMSC des Carriers.

  2. 02

    Echtzeit-Routenneuwahl.

    Wir überwachen Zustellung und Latenz auf jedem Pfad. Wenn sich eine Carrier-Route zu verschlechtern beginnt, nimmt die nächste Nachricht eine gesündere Verbindung zum selben Betreiber. Das Failover passiert, bevor Sie es bemerken.

  3. 03

    MNP-Abfrage vor dem Senden.

    Wir ermitteln bei jedem Versand den aktuellen Carrier des Empfängers, sodass eine portierte Nummer an den Betreiber geroutet wird, der sie tatsächlich hält, statt an den, mit dem sie ausgegeben wurde.

  4. 04

    Eine Zustellbestätigung für jede Nachricht.

    Das DLR des Carriers selbst kommt als sms.delivered- oder sms.failed-Webhook zurück und trägt das Netz, in dem sie ankam, und wie lange es dauerte. Kein Rätselraten von Ihrer Seite.

  5. 05

    Kostengünstigst oder höchstqualitativ, pro Route.

    Routing wägt für jedes Ziel Kosten gegen Zustellqualität ab. Transaktionaler Traffic bevorzugt den schnellsten, zuverlässigsten Pfad; Massentraffic kann zum kostengünstigsten neigen.

Warum Direct-to-Carrier eine Aggregatorkette schlägt.

Ein Großteil des SMS-Traffics passiert zwei oder drei Wiederverkäufer, bevor er einen Betreiber erreicht. Jeder Hop fügt eine Stelle hinzu, an der die Nachricht hängen bleiben, der Preis steigen und die Zustellbestätigung verloren gehen oder gefälscht werden kann. Eine Direktverbindung entfernt diese Mittelsmänner: Die Nachricht geht von Bird zum Carrier, und die Bestätigung kommt auf demselben Weg zurück. So laufen bereits etwa 40% der weltweiten kommerziellen SMS über dieses Netzwerk, mit 95% der Nachrichten in unter 2.5 Sekunden zugestellt.

Die Zustellbestätigung, direkt vom Carrier.

Ein Versand liefert 202 zurück; das Ergebnis trifft als signierter Webhook ein, der das DLR des Carriers trägt. Die Payload sagt Ihnen das Netz, in dem sie ankam, das Zielland und die Round-Trip-Latenz.

POST /webhooks/bird
signed
{
  "type": "sms.delivered",
  "id":   "evt_7jR42x...",
  "created_at": "2026-05-19T15:42:01.221Z",
  "data": {
    "sms_id":     "sms_4kT01Lq2m",
    "from":       "Bird",
    "to":         "+15005550006",
    "mcc_mnc":    "310-260",
    "country":    "US",
    "latency_ms": 1284
  }
}

mcc_mnc identifiziert das genaue Mobilfunknetz, das die Nachricht angenommen hat; ein Wert, der vom Heim-Carrier der Nummer abweicht, ist Ihr Signal, dass der Empfänger portiert hat.

  • sms.deliveredCarrier hat bestätigt, dass das Endgerät die Nachricht empfangen hat (DLR).
  • sms.failedCarrier hat abgelehnt oder konnte nicht zustellen — mit angehängtem Grund.

Routing stützt sich auf Nummern-Intelligenz.

Die MNP-Abfrage, die den richtigen Carrier auswählt, ist dieselbe Nummern-Intelligenz, die Sie eigenständig mit Lookup aufrufen können — Leitungstyp, aktueller Betreiber und Portabilität, bevor Sie senden. Sobald eine Nachricht auf der Leitung ist, verdrahten Sie Webhooks für die Zustellbestätigung und lesen Sie die Fehlerreferenz, um jeden Fehlercode zu behandeln, oder prüfen Sie den Zustellbarkeits-Leitfaden für das, was die Bestätigungen Ihnen verraten.

SMS-Routing-FAQ

Was bedeutet Direct-to-Carrier-Routing?+
Ihre Nachricht wird direkt an den Mobilfunkbetreiber über eine unserer 240 Direktverbindungen übergeben, nicht durch eine Kette von Wiederverkäufern. Weniger Hops bedeuten weniger Stellen, an denen eine Nachricht hängen bleiben oder eine Zustellbestätigung verloren gehen kann.
Was passiert, wenn sich eine Carrier-Route verschlechtert?+
Bird wählt die Route in Echtzeit neu. Wenn ein Pfad anfängt, Bestätigungen zu verlieren oder langsamer zu werden, nimmt die nächste Nachricht eine gesündere Verbindung zum selben Betreiber, und der Versand, den Sie geschrieben haben, ändert sich nie.
Woher weiß ich, dass eine Nachricht das Endgerät tatsächlich erreicht hat?+
Jede Nachricht liefert eine Carrier-Zustellbestätigung als sms.delivered- oder sms.failed-Webhook zurück, der mcc_mnc, das Land und latency_ms trägt. Das ist die Bestätigung des Betreibers selbst, keine Ableitung von unserer Seite.
Prüfen Sie vor dem Senden den Carrier des Empfängers?+
Ja. Wir führen bei jedem Versand eine MNP-Abfrage durch, um den aktuellen Betreiber des Empfängers zu ermitteln, sodass eine portierte Nummer an den Carrier geroutet wird, der sie tatsächlich hält. Für eigenständige Nummern-Intelligenz siehe Lookup.
Kann ich kostengünstigstes statt höchstqualitatives Routing wählen?+
Routing wägt Kosten und Zustellqualität pro Ziel ab. Transaktionaler Traffic wie Einmalpasscodes bevorzugt den höchstqualitativen Pfad; Massentraffic kann zum kostengünstigsten neigen. Die Auswahl erfolgt pro Nachricht, hinter demselben API-Aufruf.

Routing, über das Sie nie nachdenken müssen.

Abdeckung, Carrier-Konnektivität, Failover und Zustellbestätigungen sind eine Funktion der Bird SMS-API, auf einer Infrastruktur, die wir seit einem Jahrzehnt betreiben.

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