Messages API-Protokolle
Auf der Seite "Messages API Logs" können Sie Nachrichten, die über die Messages API gesendet wurden, in allen unterstützten Kanälen, einschließlich WhatsApp, SMS, RCS, MMS, Viber, Messenger und Instagram, suchen und Fehler beheben. Verwenden Sie diese Seite, um Zustellungsprobleme zu untersuchen, den Nachrichtenstatus kanalübergreifend zu verifizieren und Protokolle zur Analyse herunterzuladen.
Anmerkung: Wenn Sie den SMS-Verkehr über die SMS APIverwenden Sie die SMS API-Protokolle stattdessen.
Bevor Sie beginnen
- Messages API-Protokolle sind verfügbar für Nur 30 Tage
- Für Protokolle, die älter als 30 Tage sind, verwenden Sie die Reports API
- Es gibt eine Verzögerung von ein paar Minuten, bevor die Protokolle erscheinen
- Einrichten einer Lieferungseingang Webhook für Status-Updates in Echtzeit
Zugriff auf Messages API-Protokolle
- Melden Sie sich bei der Vonage API Dashboard
- Navigieren Sie zu Monitor → Protokolle
- Wählen Sie Messages API-Protokolle
Suchmethoden
Die Seite Messages API Logs bietet drei Suchmethoden:
Zeitspanne
Suchen Sie nach Nachrichten innerhalb eines bestimmten Zeitraums, um den Datenverkehr über alle Kanäle hinweg zu überwachen oder nach bestimmten Anbietern zu filtern.
Verfügbare Filter:
- Zeitspanne - Letzte Stunde, Letzte 24 Stunden, Letzte 7 Tage, Letzte 30 Tage oder benutzerdefinierter Bereich
- Anbieter - Beliebig, WhatsApp, SMS, MMS, RCS, Viber, Messenger oder Instagram
- Richtung - Ausgehende oder eingehende Nachrichten
- Nachrichtentext einschließen - Inhalt der Nachricht in den Ergebnissen anzeigen
Telefonnummer / ID
Suchen Sie nach Nachrichten, die an oder von bestimmten Telefonnummern oder externen Account-IDs gesendet wurden, um Kundenprobleme zu untersuchen oder die Zustellung zu verifizieren.
Verfügbare Filter:
- Von - Die Telefonnummer oder Account-ID des Absenders
- An - Die Zielrufnummer oder Account-ID
- Anbieter - Beliebig, WhatsApp, SMS, MMS, RCS, Viber, Messenger oder Instagram
- Richtung - Ausgehend oder eingehend
- Zeitspanne - Wenn die Nachricht gesendet wurde
- Nachrichtentext einschließen - Inhalt der Nachricht in den Ergebnissen anzeigen
Tipp: Bei WhatsApp können Sie nach Telefonnummer oder WhatsApp Business Account ID (WABA ID) suchen.
Nachrichten-ID
Suchen Sie nach einer oder mehreren bestimmten Nachrichten anhand ihrer eindeutigen Nachrichten-IDs. Diese Methode ist ideal, wenn Sie Nachrichten-IDs aus API-Antworten oder Webhooks haben.
Verfügbare Filter:
- Nachrichten-IDs - Eine oder mehrere durch Komma getrennte Nachrichten-UUIDs
- Richtung - Ausgehend oder eingehend
- Nachrichtentext einschließen - Inhalt der Nachricht in den Ergebnissen anzeigen
Anmerkung: Messages API verwendet Nachrichten-IDs im UUID-Format, die sich von den Nachrichten-IDs der SMS API unterscheiden.
Arbeiten mit Ergebnissen
Anzeigen von Protokolldetails
Jeder Protokolleintrag enthält wichtige Informationen über die Nachricht:
- Nachrichten-ID - Eindeutige UUID für die Nachricht
- Kanal - Der Messaging-Anbieter (WhatsApp, SMS, RCS, usw.)
- Von - Absender-Telefonnummer oder Account-ID
- An - Ziel-Telefonnummer oder Account-ID
- Status - Zustellungsstatus (übermittelt, zugestellt, gelesen, abgelehnt usw.)
- Zeit - Wann die Nachricht gesendet oder der Status aktualisiert wurde
- Netzwerk - Mobilfunknetzbetreiber (nur für SMS/MMS/RCS)
- Preis - Kosten der Nachricht
Verstehen des Nachrichtenstatus
Verschiedene Kanäle unterstützen unterschiedliche Statuswerte:
| Status | Beschreibung | Kanäle |
|---|---|---|
| eingereicht | Nachricht von Vonage angenommen | Alle Kanäle |
| geliefert | Nachricht an Empfänger zugestellt | Alle Kanäle |
| lesen | Nachricht vom Empfänger gelesen | WhatsApp, Viber, Messenger, Instagram |
| abgelehnt | Nachricht vom Anbieter abgelehnt | Alle Kanäle |
| unzustellbar | Nachricht konnte nicht zugestellt werden | Alle Kanäle |
Einschließlich Nachrichtentext
Standardmäßig wird der Inhalt der Nachricht aus Datenschutz- und Leistungsgründen nicht angezeigt. Prüfen Sie die Nachrichtentext einschließen um den Inhalt der Nachricht in Ihren Ergebnissen anzuzeigen.
Das ist wichtig: Der Inhalt der Nachricht ist nur verfügbar, wenn er gespeichert wurde. Bei einigen Kanälen wird der Nachrichteninhalt aufgrund von Datenschutzrichtlinien nicht gespeichert.
Herunterladen von Protokollen
Exportieren Sie die Suchergebnisse in CSV-Dateien für Offline-Analysen oder zur Archivierung.
Zum Herunterladen von Protokollen:
- Eine Suche mit einer beliebigen Methode durchführen
- Klicken Sie auf CSV herunterladen
- Die CSV-Datei enthält alle Felder der Suchergebnisse, einschließlich des Nachrichtentextes, falls aktiviert
Anmerkung: CSV-Downloads sind auf die angezeigten Ergebnisse beschränkt. Für Massenexporte oder programmatischen Zugriff verwenden Sie die Reports API.
Verstehen von Protokollverzögerungen
- Regelmäßige Protokolle: Verfügbar innerhalb von 2-5 Minuten nach dem Senden
- Lieferscheine: Variiert je nach Kanal:
- WhatsApp: Nahezu in Echtzeit (Sekunden)
- SMS/MMS: Abhängig vom Netzbetreiber (Sekunden bis Stunden)
- RCS: Nahezu in Echtzeit (Sekunden)
- Soziale Kanäle: Nahezu in Echtzeit (Sekunden)
- Aktualisierungen in Echtzeit: Verwenden Sie Lieferungseingang Webhooks für sofortige Benachrichtigungen