SMS-Protokoll
Das SMS-Protokoll auf der Seite Messages ist das Nachrichtenverzeichnis Ihres Workspace. Ausgehende Sendungen und eingehende Antworten erscheinen mit der neuesten zuerst. Nutzen Sie es, um einen Versand zu bestätigen, seinen Zustellungsverlauf zu verfolgen und Segmentanzahl, Kosten und Carrier-Details einzusehen. Die aggregierte Seite Metrics zeigt Raten über alle Nachrichten hinweg; das SMS-Protokoll lässt Sie eine einzelne Nachricht untersuchen. Die Seite enthält außerdem Send SMS für einmalige Sendungen über das Dashboard.
Die Nachrichtenliste
Jede Zeile ist eine Nachricht. Die Spalten sind:
| Spalte | Inhalt |
|---|---|
| Status | Der aktuelle Zustellstatus der Nachricht (siehe Status) |
| From | Der Absender: die Nummer, Sender-ID oder der Kurzcode, von dem die Nachricht gesendet wurde |
| To | Die Nummer des Empfängers |
| Message | Der Anfang des Nachrichtentexts (klicken Sie darauf oder irgendwo in die Zeile, um die Nachricht zu öffnen) |
| Category | Die Nachrichten-Kategorie, als kurzes Badge dargestellt (TXN, MKTG, AUTH, SVC) |
| Sent | Wann der Versand akzeptiert wurde, als relative Zeitangabe (Hover zeigt den genauen Zeitstempel) |
Die Liste ist paginiert, 25 Nachrichten pro Seite; verwenden Sie Prev und Next, um zwischen Seiten zu wechseln.
Suchen und filtern
Ein Nachrichtenprotokoll füllt sich schnell, deshalb beginnt die Seite mit einer Empfängersuche und vier Filtern. Sie lassen sich kombinieren: Ein Statusfilter zusammen mit einem Datumsbereich schränkt auf Nachrichten ein, die beide Kriterien erfüllen.
Empfängersuche. Das Suchfeld findet eine exakte Empfängernummer im E.164-Format. Geben Sie die vollständige Nummer ein, z. B. +31612345678, um jede an sie adressierte Nachricht zu finden. Die Suche erkennt keine Teilzeichenfolgen.
Status. Filtern Sie nach einem oder mehreren Zustellstatus. Status ist Mehrfachauswahl: Sie können z. B. alles anzeigen, was nicht angekommen ist, indem Sie Undelivered, Failed und Expired gemeinsam auswählen. Die Optionen entsprechen den unter Status aufgeführten Werten.
Category. Filtern Sie nach Nachrichtenkategorie: Transactional, Marketing, Authentication oder Service.
Direction. Filtern Sie nach Outbound oder Inbound. Antworten auf Ihre Nummern werden neben Ihren Sendungen gespeichert; Inbound zeigt, was Sie empfangen haben.
Date. Filtern Sie danach, wann die Nachricht gesendet wurde; wählen Sie einen vordefinierten Zeitraum oder einen benutzerdefinierten Bereich im Kalender.
Wenn eine Filterkombination keine Treffer ergibt, zeigt die Seite einen Keine-Ergebnisse-Zustand mit der Aktion Clear filters, um zur vollständigen Liste zurückzukehren.
Status
Der Status einer Nachricht gibt an, wo sie sich im Zustellungsverlauf befindet. Eine Nachricht durchläuft den Weg von accepted bis zu einer abschließenden Empfangsbestätigung.
| Status | Bedeutung |
|---|---|
| Accepted | Bird hat die Nachricht angenommen und bereitet die Übergabe an einen Carrier vor |
| Sent | An den Carrier übergeben; Zustellbestätigung ausstehend |
| Delivered | Der Carrier hat die Zustellung an das Endgerät bestätigt |
| Undelivered | Nicht-permanente Nichtzustellung: Das Endgerät war ausgeschaltet, nicht erreichbar oder der Inhalt wurde blockiert |
| Failed | Ein permanenter Fehler; die Nachricht kann nicht zugestellt werden |
| Rejected | Die Nachricht wurde abgelehnt (Richtlinienprüfung, fehlgeschlagene Belastung oder Ablehnung durch den Carrier) |
| Expired | Der Carrier hat die Zustellversuche eingestellt und die Nachricht als abgelaufen gemeldet |
| Received | Eine eingehende Nachricht |
Das Statuslabel zeigt an, ob eine Nachricht unterwegs, zugestellt, empfangen oder nicht erfolgreich ist. Verlassen Sie sich beim Scannen der Ergebnisse nicht allein auf die Farbe.
Eine Nachricht untersuchen
Klicken Sie auf eine beliebige Zeile, um die Nachricht in einem Seitenpanel zu öffnen. Es enthält zwei Tabs, Events und Details, und der Header zeigt den Nachrichtentext, den aktuellen Status, den Empfänger und die Kategorie. Solange eine Nachricht noch unterwegs ist, aktualisiert sich das Panel alle paar Sekunden automatisch, sodass eine Statusänderung oder Zustellbestätigung ohne manuelles Neuladen erscheint.
Events
Der Standard-Tab ist eine Timeline mit Zeitstempeln für eine einzelne Nachricht. Er rendert den in SMS events beschriebenen Stream: Accepted, dann Sent, dann Delivered, oder ein Fehlerereignis (Undelivered, Failed, Rejected, Expired). Zustellereignisse identifizieren den Carrier und MCC/MNC (das Mobilfunknetz). Fehlerereignisse zeigen die Fehlerbeschreibung; der Tab Details enthält den Fehlercode.
Details
Der Tab Details enthält die Metadaten der Nachricht:
- Message ID, Direction, From, To und Category
- Segments: die abrechenbare Segmentanzahl, die Kodierung (GSM_7BIT oder UCS2) und die Zeichenanzahl (siehe Segmente und Kodierung)
- Cost: Betrag und Währung, sobald die Nachricht bepreist wurde
- Carrier und MCC/MNC: das zustellende Netz, sofern bekannt
- Sent, Handed to carrier und Delivered als Zeitstempel
- Error: Beschreibung und Code bei einer Nachricht, die nicht angekommen ist
- Alle Tags und Metadata, die Sie beim Versand gesetzt haben
Die meisten Felder lassen sich mit einem Klick kopieren.
Öffentliche Nachrichten- und Ereignisabfragen decken die letzten 30 Tage ab. Eine ältere Message-ID liegt außerhalb dieses Abfragefensters; speichern Sie die Datensätze, die Ihre Anwendung benötigt, gemäß Ihrer eigenen Aufbewahrungs- und Einwilligungsrichtlinie.
Dasselbe Protokoll über die API
Die Liste hinter dieser Seite ist GET /v1/sms/messages, deren Filter Status, Kategorie, Tag, exakte Empfängernummer und Zeitfenster abdecken. Rufen Sie die Timeline einer Nachricht mit GET /v1/sms/messages/{message_id}/events ab. Lesen Sie den aktuellen Status mit GET /v1/sms/messages/{message_id}, oder konsumieren Sie Webhook-Events in Echtzeit.
Nächste Schritte
Erkunden Sie SMS-Analytics für den umfassenderen Reporting-Workflow und bidirektionale SMS-Kommunikation für den Umgang mit eingehenden Nachrichten.
- SMS-Metriken: Überwachen Sie aggregierte Zustellrate, Fehlerrate und akzeptiertes Volumen.
- SMS events: Sehen Sie sich das Ereignisvokabular hinter der Timeline an.
- SMS senden: Erstellen Sie eine Sende-Payload mit Kategorien, Tags und Metadaten.
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Das Konzept verstehenWhat does a delivery receipt tell you?Dem Lernpfad folgenOperate messaging reliably
Implementierungs-Briefing erhalten