SMS Überblick
Bird SMS versendet Textnachrichten über dieselbe Plattform und dieselben API-Schlüssel wie Bird Email. Rufen Sie Bird mit einem bk_{region}_…-Schlüssel gegen Ihren regionalen Host auf (https://us1.platform.bird.com oder https://eu1.platform.bird.com). Bird wählt eine Route zum Mobilfunkanbieter des Empfängers, teilt Ihren Text in abrechenbare Segmente auf und meldet jede Nachricht über ihre Zustellbestätigung. SMS-Endpunkte beginnen mit /v1/sms/.
Sie können Freitext mit einem Absender und einer Kategorie Ihrer Wahl senden oder eines der integrierten Templates von Bird verwenden, das Nachrichtentext, Kategorie und Absender liefert. Bird empfängt auch Antworten auf Ihre Nummern. Jede eingehende Nachricht wird zusammen mit Ihren Sendungen gespeichert und als sms.received ausgegeben. Wenn eine Antwort einem unterstützten Opt-out-Schlüsselwort wie STOP entspricht, zeichnet Bird auch eine Absender-und-Abonnenten-Unterdrückung auf. Siehe Opt-outs und Schlüsselwörter für Abdeckung und Konfiguration.
So funktioniert der Versand
Senden Sie eine SMS mit POST /v1/sms/messages: ein Empfänger und eine Nachricht, entweder mit Ihrem eigenen text samt Absender und Kategorie oder einer template-Referenz mit deren Variablenwerten. Bird validiert die Anfrage und das Ziel, löst den Absender auf und gibt 202 Accepted mit einer Nachrichten-ID zurück. Die Zustellung erfolgt dann asynchron. Verfolgen Sie das Ergebnis über Events und Webhooks oder die Nachrichten-Lese-Endpunkte. Um viele unabhängige Nachrichten in einem Aufruf zu senden, verwenden Sie den Batch-Endpunkt.
Drei Konzepte prägen die gesamte API:
- Versand und Zustellung sind getrennte Phasen. Ein 202 bedeutet, dass Bird die Nachricht angenommen hat. Der Mobilfunkanbieter verarbeitet sie nach der Annahme und kann später eine Zustellbestätigung zurückgeben. Eine Fehlermeldung ist ebenfalls ein Endergebnis; prüfen Sie den gemeldeten Status, bevor Sie den Versand als zugestellt behandeln.
- Text wird in Segmenten abgerechnet. Eine Nachricht, die länger als ein Segment ist, wird aufgeteilt und pro Segment abgerechnet. Die Kapazität pro Segment hängt von den verwendeten Zeichen ab. Zeichenlimits enthält die Kodierungsregeln, den vollständigen Zeichensatz und wie Sie Nachrichten auf ein Segment beschränken.
- Der Zweck Ihrer Nachricht zählt. Jede Nachricht trägt eine Kategorie: transactional, marketing, authentication oder service. Bird und Mobilfunkanbieter nutzen sie, um den Zweck der Nachricht zu verstehen. Bei einem Template-Versand stammt die Kategorie aus dem Template.
Aktivieren Sie vor Ihrem ersten Versand die Zielländer, die Sie bedienen, unter SMS > Destinations. Die standardmäßig ablehnende Allowlist hat zunächst nur das Heimatland Ihrer Organisation aktiviert. Bird lehnt einen Versand in jedes andere Land ab. Sending SMS behandelt diese Voraussetzung.
Für Einmal-Bestätigungscodes sollten Sie Bird Verify in Betracht ziehen, anstatt die Nachricht selbst zu verfassen. Verify generiert und liefert den Code über SMS oder E-Mail, prüft die Antwort und setzt Ablauf, Versuchslimits und Wartezeiten zwischen erneuten Sendungen durch.
Die SMS-App im Dashboard
Im Dashboard ist SMS eines der Produkte in der Seitenleiste. Die zugehörigen Seiten und wo der jeweilige Leitfaden zu finden ist:
| Seite | Wofür sie da ist |
|---|---|
| Messages | Jede gesendete Nachricht mit Event-Timeline und Zustelldetails pro Nachricht. Leitfaden: SMS-Protokoll |
| Templates | Die integrierten Templates, die Sie senden können: Name, Kategorie, Sprachen und Variablen. Leitfaden: SMS-Templates |
| Metrics | Zustellrate, Fehlerrate und akzeptiertes Volumen im Zeitverlauf. Leitfaden: SMS-Metriken |
| Senders | Die Absender-IDs und Nummern, von denen Sie senden können, und wo jede registriert ist. Leitfaden: SMS-Absender-IDs |
| Destinations | Die Länder, in die Ihr Workspace senden darf; aktivieren Sie ein Ziel, bevor Sie dorthin senden. Leitfaden: Sending SMS |
Sichtbarkeit
Nutzen Sie Nachrichtendatensätze und die verfügbare Event-Timeline, um Annahme, Carrier-Übergabe und Zustellergebnisse zu untersuchen. Nachrichtendetails umfassen Segmente und etwaige kostenpflichtige Komponenten. Öffentliche Nachrichtenabfragen decken das Aufbewahrungsfenster ab, das im SMS-Protokoll beschrieben ist.
- SMS-Protokoll: die Einzelnachrichtenansicht im Dashboard. Jeder Versand, seine Event-Timeline, Segmente, Kosten und Carrier-Details.
- SMS-Metriken: die aggregierte Zustellrate, Fehlerrate, das akzeptierte Volumen und die Zustelllatenz über alle Ihre Sendungen hinweg.
- Events: das SMS-Event-Vokabular, der Nachrichtenlebenszyklus und die Webhook-Zustellung an Ihre eigenen Endpunkte.
Nächste Schritte
Erkunden Sie die SMS-Plattform für Kampagnen, Anwendungsnachrichten und Antworten, oder nutzen Sie die SMS-Ressourcenbibliothek, um einen Workflow auszuwählen.
| Seite | Was sie behandelt |
|---|---|
| Sending SMS | Der Versand-API: Ziele, Absender, Nachrichtentext, Segmente, Kategorien, Tags |
| Character limits | GSM-7- und UCS-2-Kodierung, Limits pro Segment und das 12-Segment-Maximum |
| SMS-Templates | Der integrierte Template-Katalog und der Versand per Template-Referenz |
| SMS-Absender-IDs | Auswahl eines Absendertyps und Registrierung pro Zielland |
| 10DLC-Registrierung | Registrierung einer Marke, Kampagne und Nummer für den US-A2P-Versand |
| SMS-Protokoll | Jede Nachricht, ihre Event-Timeline, Segmente und Kosten |
| SMS-Metriken | Zustellrate, Fehlerrate und Latenz |
| Events | Die SMS-Event-Typen und Webhook-Zustellung |
| Webhooks & Events | Endpunkt-Einrichtung, Signaturverifizierung, Wiederholungen und Replay |
| Verify-Überblick | Einmal-Bestätigungscodes über SMS und E-Mail, gesendet und geprüft von Bird |
| Steuern, wohin Ihr Konto senden kann | Ein Video: Zeigt, was ein Versand an ein deaktiviertes Ziel zurückgibt |
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Anleitung ansehenSMS pumping explainedDas Konzept verstehenWhat is SMS pumping, and how do I stop it?Die Funktion erkundenSMS destinationsDem Lernpfad folgenBuild your first integration
Implementierungs-Briefing erhalten