SMS API-Protokolle
Auf der Seite SMS API-Protokolle können Sie SMS-Nachrichten, die über die SMS API gesendet wurden, durchsuchen und Fehlersuche betreiben. Verwenden Sie diese Seite, um Zustellungsprobleme zu untersuchen, den Nachrichtenstatus zu verifizieren und Protokolle zur weiteren Analyse herunterzuladen.
Anmerkung: Wenn Sie den SMS-Verkehr über die Messages APIverwenden Sie die Messages API-Protokolle stattdessen.
Bevor Sie beginnen
- SMS-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 SMS-Protokolle
- Melden Sie sich bei der Vonage API Dashboard
- Navigieren Sie zu SMS API-Protokolle
Suchmethoden
Die Seite SMS API Logs bietet fünf Suchmethoden:
Zeitspanne
Durchsuchen Sie Nachrichten innerhalb eines bestimmten Zeitraums, um die Leistung zu untersuchen oder den Datenverkehr zu überwachen.
Verfügbare Filter:
- Zeitspanne - Letzte Stunde, Letzte 24 Stunden, Letzte 7 Tage, Letzte 30 Tage oder benutzerdefinierter Bereich
- Richtung - Ausgehende oder eingehende Nachrichten
Telefon-Nummer
Suchen Sie nach Nachrichten, die an oder von bestimmten Telefonnummern gesendet wurden, um Kundenprobleme zu untersuchen oder die Zustellung an einen bestimmten Empfänger zu verifizieren.
Verfügbare Filter:
- 'To' Number - Die Zielrufnummer
- Von - Die Absender-ID oder Telefonnummer
- Zeitspanne - Wenn die Nachricht gesendet wurde
- Richtung - Ausgehend oder eingehend
Tipp: Verwenden Sie für Telefonnummern das internationale Format (Landesvorwahl + Nummer).
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-IDs
- Richtung - Ausgehend oder eingehend
Webhook
Fehlerbehebung bei Rückrufen zur Zustellungsquittung (DLR) und Webhooks für eingehende Nachrichten, um sicherzustellen, dass Ihre Anwendung Statusaktualisierungen korrekt empfängt.
Verfügbare Filter:
- Richtung - Ausgehender Rückruf (DLR-Status) oder Eingehender Rückruf
- Zeitspanne - Wann der Webhook gesendet wurde
- Nummer des Empfängers - Die Telefonnummer für die Webhook-Zustellung (z. B. 447777889900)
Das ist wichtig: Webhook-Protokolle zeigen, ob Vonage den Rückruf erfolgreich an Ihren Server übermittelt hat, nicht ob Ihr Server ihn korrekt verarbeitet hat.
Nicht gesendet
Finden Sie Nachrichten, die von der Vonage-Plattform vor der Zustellung abgelehnt wurden. Diese Nachrichten wurden nicht für die Zustellung eingeplant, haben keinen DLR-Status und werden nicht in Rechnung gestellt.
Verfügbare Filter:
- 'To' Number - Die vorgesehene Zielnummer
- Von - Die Absender-ID oder -Nummer
- Zeitspanne - Wenn die Nachricht abgelehnt wurde
Arbeiten mit Ergebnissen
Anzeigen von Protokolldetails
Jeder Protokolleintrag enthält wichtige Informationen über die Nachricht:
- Nachrichten-ID - Eindeutiger Bezeichner für die Nachricht
- Von - Absender-ID oder Rufnummer
- An - Ziel-Telefonnummer
- Status - Zustellungsstatus (übermittelt, zugestellt, fehlgeschlagen usw.)
- Zeit - Wann die Nachricht gesendet oder der Status aktualisiert wurde
- Netzwerk - Mobilfunknetzbetreiber
- Preis - Kosten der Nachricht
Klicken Sie auf einen Protokolleintrag, um alle Details, einschließlich Fehlercodes und Netzwerkinformationen, anzuzeigen.
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 wird alle Felder der Suchergebnisse enthalten
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: Abhängig vom Zeitplan des Netzbetreibers (Sekunden bis Stunden)
- Aktualisierungen in Echtzeit: Verwenden Sie Lieferungseingang Webhooks stattdessen