HarborOrganizationWorkspacesProductionSandbox
Delivery agent
API key · Customer operations teamALAlex Lee AdminPermissions updated
Der Weg vom
Versand bis zum Empfänger.
Erreichen Sie Kunden über eine einzige Sende-API, während Bird die Carrier-Konnektivität übernimmt. Wählen Sie unterstützte Ziele und den passenden Absender, dann verfolgen Sie das gemeldete Zustellergebnis. Untersuchen Sie Fehler nach Land oder Carrier, wenn eine Route, ein Empfänger oder eine Registrierung Aufmerksamkeit erfordert.
Die Route hinter Ihrer Nachricht
Sende-Workflow
01
Ihre Anwendung
Wählen Sie Empfänger, Absender, Kategorie und Nachricht.
02
Ziel- und Absenderprüfungen
Verwenden Sie einen freigeschalteten Markt und die erforderliche Registrierung.
03
Carrier-Übergabe
Bird übermittelt die Nachricht über seine Carrier-Verbindungen.
04
Ein gemeldetes Ergebnis
Verfolgen Sie die Zustellbestätigung in Nachrichtendatensätzen, Webhooks und Analysen.
Ein konzeptioneller Ablauf. Annahme, Carrier-Übergabe und Zustellbestätigung beschreiben verschiedene Phasen im Lebenszyklus einer Nachricht.
Die Schicht, auf der Ihr Versand fährt.
Routing befindet sich unterhalb der Bird SMS API. Bird prüft Ziel und Absender vor der Annahme und übermittelt die vorbereitete Nachricht dann an den Carrier-Transport. Untersuchen Sie den gemeldeten Carrier und das Ergebnis, um zu entscheiden, ob ein Absender-, Ziel- oder Empfängerproblem vorliegt.
Verstehen Sie die Entscheidungen vor der Carrier-Übergabe.
Berechtigung, Nachrichtenvorbereitung und Carrier-Übermittlung haben unterschiedliche Aufgaben.
- 01
Carrier-Konnektivität.
Bird verwaltet die Carrier-Verbindungen hinter Ihrem Versand. Nutzen Sie den Zielkatalog, um unterstützte Absendertypen und Registrierungsanforderungen für Ihre Märkte zu prüfen.
- 02
Ein vorbereiteter Absender und ein vorbereitetes Ziel.
Absendertyp, Zielregeln und Registrierung bestimmen, welcher Originator verwendet werden kann. Ein gültiges Setup wird hergestellt, bevor die Nachricht zum Transport eingereiht wird.
- 03
Betreiberinformationen, sofern verfügbar.
Die Verarbeitung kann den Betreiber des Empfängers für die Preisberechnung ermitteln. Eine fehlende oder fehlgeschlagene Abfrage fällt auf Länderpreise zurück. Carrier-Informationen in einer Zustellbestätigung können ebenfalls fehlen; leiten Sie kein Netz allein aus dem Rufnummernpräfix ab.
- 04
Zustellbestätigungen als Carrier-Nachweis.
Eine Carrier-Bestätigung kann die Zustellung oder ein endgültiges Nichtzustellergebnis melden. Manche Nachrichten warten weiterhin auf eine Bestätigung, und fehlende Carrier-Felder sind unbekannt. Lesen Sie die Ereigniszeitleiste zusammen mit dem aktuellen Status.
- 05
Besprechen Sie Routenanforderungen für einen Rollout.
Die öffentliche SMS-Anfrage bietet keine Auswahl zwischen günstigster und qualitativ hochwertigster Route. Besprechen Sie Zielmix, Absenderanforderungen und Durchsatz mit einem SMS-Spezialisten, wenn Sie größere Volumen planen.
Ein Zustellergebnis, das Sie untersuchen können.
Ein erfolgreicher SMS-Versand hängt von Ziel, Absenderregistrierung, Nachrichteninhalt und Carrier-Pfad ab. Bird vereint diese Entscheidungen in einem Sende-Workflow. Beginnen Sie mit den Anforderungen des Ziels, dann nutzen Sie Nachrichtendatensätze und Carrier-Ergebnisse, um zu erkennen, was geändert werden muss.
Die Zustellbestätigung, direkt vom Carrier.
Eine erfolgreiche Anfrage gibt 202 vor der Carrier-Zustellung zurück. Nachfolgende Ereignisse können den gemeldeten Carrier und MCC/MNC enthalten. Behandeln Sie fehlende Felder als unbekannt und untersuchen Sie die Nachrichtenzeitleiste auf verfügbare Nachweise.
POST /webhooks/bird
signed
{
"type": "sms.delivered",
"timestamp": "2026-05-19T15:42:01.221Z",
"data": {
"sms_id": "sms_4kT01Lq2m",
"workspace_id": "ws_8KQ2",
"to": "+15005550006",
"from": "+12025550188",
"tags": null,
"metadata": null,
"carrier": "Verizon",
"mcc_mnc": "311480",
"cost": {
"amount": "0.0079",
"currency_code": "USD",
"transaction_amount": "0.0079",
"passthrough_amount": null
}
}
}
Carrier- und MCC/MNC-Felder werden gemeldet, sofern verfügbar. Eine Abweichung von präfixbasierten Erwartungen ist ein Grund zur Untersuchung; sie beweist allein noch keine Rufnummernportierung.
sms.deliveredCarrier hat bestätigt, dass das Endgerät die Nachricht empfangen hat (DLR).sms.failedCarrier hat die Nachricht abgelehnt oder konnte sie nicht zustellen – mit Angabe des Grundes.
Routing stützt sich auf Nummern-Intelligenz.
Verwenden Sie Lookup, wenn Ihre Anwendung unterstützte Rufnummerninformationen benötigt. Abonnieren Sie Webhooks für SMS-Ergebnisse und nutzen Sie die Fehlerreferenz und den Zustellbarkeitsleitfaden, um gemeldete Fehler zu interpretieren. Ein Lookup-Ergebnis stellt weder Absenderberechtigung noch Zustellgarantie her.
Fragen, bevor Sie loslegen
Wie prüfe ich die Ziellandabdeckung?
Öffnen Sie den Ziellandkatalog und prüfen Sie die Absendertypen und Registrierungsanforderungen für jeden Markt. Ihr Workspace muss die Destination ebenfalls zulassen, bevor ein Versand akzeptiert wird.
Was belegt eine Carrier-Empfangsbestätigung?
Sie meldet ein Zustellergebnis vom Carrier. Empfangsbestätigungen können nach der Annahme eintreffen, und der Nachrichtenstatus kann noch ausstehend sein. Eine Zustellung belegt nicht, ob jemand den Text gelesen oder darauf reagiert hat.
Wie sollte ich eine fehlgeschlagene Route untersuchen?
Beginnen Sie mit dem Nachrichtenstatus und dem Fehlergrund. Vergleichen Sie die Auswertung nach Carrier, Land oder Absender und prüfen Sie dann die Registrierungs- und Zielkonfiguration. Eine aggregierte Fehlerquote allein identifiziert die Ursache nicht.
Kann ich eine Telefonnummer separat prüfen?
Verwenden Sie Lookup, wenn Ihre Anwendung vor dem Versand Informationen zur Telefonnummer benötigt. Prüfen Sie die Signale und die Verfügbarkeit für diese Abfrage, anstatt einen SMS-Zustellbericht als vollständige Nummernprüfung zu behandeln.
Der Rest der SMS-Plattform
Eine API, ein Satz Keys. Entdecken Sie die anderen Funktionen.
SendenDie Sende-API: Segmente, Unicode-Sicherheit, Batch und Idempotenz.NummernLong Codes, Short Codes, Toll-Free und alphanumerische Sender-IDs.Zwei-WegeEingehende SMS und dialogorientierte Antworten als HMAC-signierte Webhooks.ComplianceA2P 10DLC-Registrierung, Opt-out-Schlüsselwörter und Sender-ID-Regeln.AnalyticsZustellergebnisse, Fehlerursachen und Latenz aus Carrier-Bestätigungen.SMS-API-ÜberblickDie vollständige SMS-API: Senden, Nummern, Zwei-Wege, Compliance, Routing und Analytics.SMS-RessourcenbibliothekFinden Sie Leitfäden, erklärte Antworten und Tools für Ihren nächsten Schritt.
Skalieren, ohne
die Kontrolle zu verlieren.
Organisieren Sie Teams in Workspaces, steuern Sie den API-Zugriff und verfolgen Sie Änderungen über Audit-Logs.
HarborOrganizationActive
Audit log
Production- Workspace
- Production
- Resource
- Delivery agent
- ReadRead & write
Team Customer operationsActor role AdminOutcome SucceededTime 22 Sep, 09:42:18 UTC
Succeeded