WhatsApp-Protokoll

Die Seite Messages im Bird-Dashboard ist das Protokoll Ihres Workspace über jede gesendete WhatsApp-Nachricht: Jeder Versand über POST /v1/whatsapp/messages landet hier, neueste zuerst. Nutzen Sie die Seite, um zu prüfen, ob eine Nachricht gesendet wurde, wo sie sich im Zustellungszyklus befindet und welches Template sie erzeugt hat. Einen Überblick über die Einordnung dieser Seite im Dashboard finden Sie in der Dashboard-Tour.

Die Nachrichtenliste

Die WhatsApp-Messages-Seite im Bird-Dashboard: eine Tabelle gesendeter Nachrichten mit Status (Sent, Failed, Delivered), Absender- und Empfänger-Telefonnummern, dem Template-Slug, einem Category-Badge (Authentication, Utility) und einer relativen Sendezeit, über einem Suchfeld für exakte Telefonnummern sowie Status- und Datumsfiltern

Jede Zeile ist eine Nachricht. Die Spalten sind:

Spalte	Inhalt
Status	Der aktuelle Status der Nachricht (siehe Status), als farbiger Punkt
From	Die WhatsApp-Absendernummer, von der die Nachricht gesendet wurde
To	Die Nummer des Empfängers
Template	Das Template, aus dem die Nachricht gesendet wurde (klicken Sie auf die Zeile, um die Nachricht zu öffnen)
Category	Die Kategorie des Templates
Sent	Wann der Versand angenommen wurde, als relative Zeitangabe (Hover für den exakten 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, daher beginnt die Seite mit einer Empfängersuche und zwei Filtern. Sie lassen sich kombinieren: Ein Statusfilter zusammen mit einem Datumsbereich schränkt auf Nachrichten ein, die beide Bedingungen erfüllen.

Suche nach Empfänger. Das Suchfeld gleicht eine exakte Empfängernummer im E.164-Format ab. Geben Sie die vollständige Nummer ein, an die Sie gesendet haben, z. B. +14155550100, um jede an sie adressierte Nachricht zu finden. Die Suche gleicht den gesamten Wert ab, nicht einen Teilstring.

Status. Filtern Sie nach einem oder mehreren Status. Status ist Mehrfachauswahl, d. h. Sie können z. B. alles noch in Zustellung Befindliche anzeigen, indem Sie Accepted und Sent zusammen auswählen. Die Optionen sind Accepted, Sent, Delivered, Failed, Rejected und Received.

Date. Filtern Sie nach dem Sendezeitpunkt der Nachricht: Wählen Sie eine Voreinstellung (letzte 3, 7 oder 30 Tage) 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 zeigt an, wo sie sich aktuell im Lebenszyklus befindet. Eine Nachricht durchläuft den Weg von accepted bis zu einer abschließenden Statusmeldung.

Status	Bedeutung
Accepted	Die Nachricht wurde angenommen und wird für die Übergabe an WhatsApp vorbereitet
Sent	An WhatsApp übergeben; Zustellbestätigung steht aus
Delivered	WhatsApp hat die Zustellung an den Empfänger bestätigt
Failed	Senden oder Zustellung fehlgeschlagen; prüfen Sie den aufgezeichneten Fehler
Rejected	Bird hat die Nachricht vor dem Senden abgelehnt. Sie wurde nicht gesendet und Ihnen nicht berechnet
Scheduled	Zum Senden zu einem zukünftigen Zeitpunkt eingereiht
Canceled	Eine geplante Nachricht, die vor dem Senden abgebrochen wurde; kein nachfolgender Versand
Received	Eine eingehende Nachricht

Eine Nachricht ist rejected, wenn der Empfänger auf der Unterdrückungsliste Ihres Workspace steht, das Guthaben den Versand nicht decken konnte oder für das Ziel kein Preis konfiguriert ist. Eine Lesebestätigung ist kein Status: Wenn ein Empfänger eine zugestellte Nachricht liest, zeichnet Bird einen read_at-Zeitstempel und ein whatsapp.read-Ereignis auf der Nachricht auf, und der Zustellstatus bleibt delivered.

Eine Nachricht prüfen

Klicken Sie auf eine beliebige Zeile, um die Nachricht zu öffnen. Der Header zeigt das Template, das sie erzeugt hat, den aktuellen Status, den Empfänger und das Kategorie-Badge, über zwei Tabs:

Das WhatsApp-Nachrichtendetail-Sheet im Bird-Dashboard, geöffnet für eine zugestellte bird_order_confirmation-Nachricht: der Events-Tab mit der Lebenszyklus-Timeline der Nachricht – Accepted, Sent, Delivered und Read, jeweils mit Zeitstempel – über der abgedunkelten Nachrichtenliste

Events: eine Timeline aller Ereignisse der Nachricht, in chronologischer Reihenfolge, jeweils mit Zeitstempel. Sie beginnt mit Accepted, Sent, Delivered, dann die Lesebestätigung, falls der Empfänger sie gelesen hat, oder ein Fehler bzw. eine Ablehnung mit Fehlerbeschreibung. Das ist derselbe Stream, den Sie mit GET /v1/whatsapp/messages/{message_id}/events abrufen können.
Details: die Metadaten der Nachricht. Hier finden Sie die ID (mit Kopier-Button), die Absender- und Empfängernummern, den Slug, die Sprache und die Kategorie des Templates sowie die Zeitstempel für Versand, Zustellung und Lesen. Außerdem enthält der Tab die Fehlerbeschreibung bei einer nicht zugestellten Nachricht sowie etwaige Tags und Metadaten, die der Versand mitgeführt hat.

Dasselbe Protokoll über die API

Alle Daten dieser Seite stammen aus GET /v1/whatsapp/messages und den zugehörigen Sub-Ressourcen pro Nachricht. Die Liste übernimmt drei der seiteneigenen Filter: status, category und den Datumsbereich (created_after/created_before). Hinzu kommen mehrere, für die die Seite kein Steuerelement hat: direction, ein Tag und ein exakter to oder from. to und from bezeichnen dieselben Enden der Nachricht wie die Antwort, d. h. to ist der Kontakt bei einer ausgehenden Nachricht und Ihre Geschäftsnummer bei einer eingehenden; beide akzeptieren eine E.164-Telefonnummer oder eine business-scoped User-ID. Die Empfängersuche der Seite ist der einzige Filter ohne direkte Entsprechung, da sie einen Kontakt in beiden Richtungen abgleicht und to oder from allein das nicht ausdrücken können. Die Timeline hinter dem Events-Tab ist GET /v1/whatsapp/messages/{message_id}/events; WhatsApp-Events beschreibt das programmatische Auslesen.

Nächste Schritte

WhatsApp-Nachrichten senden: der Send-Payload hinter jeder Zeile
WhatsApp-Events: der Lebenszyklus-Stream pro Nachricht hinter der Timeline
WhatsApp-Metriken: die aggregierte Ansicht über alle Nachrichten hier
WhatsApp-Preise: was eine Nachricht kostet, nach Ziel und Kategorie