Verify-Protokoll

Das Verify log auf der Seite Verifications unter Verify > Verifications verzeichnet jede Verifizierungssitzung Ihres Workspace. Die neuesten Verifizierungen stehen oben. Damit prüfen Sie, ob eine Verifizierung erstellt wurde, verfolgen jeden Kanalversuch und jede Prüfung und sehen Konversionszeit und Kosten pro Versuch ein. Der generierte Einmal-Bestätigungscode wird nie im Klartext gespeichert oder im Dashboard angezeigt.

Die Seite Verifications listet Verifizierungen mit den Spalten Status, Verifizierungs-ID, Empfänger, Kanal, Kosten und Erstellungszeit auf

Die Verifizierungsliste

Jede Zeile entspricht einer Verifizierungssitzung. Die Spalten sind:

Spalte	Inhalt
Status	Der aktuelle Status der Sitzung (Pending, Converted, Failed, Expired, Canceled oder Blocked; siehe Status)
Verification	Die ID der Verifizierung (`vrf_...`)
Recipient	Die zu verifizierende Telefonnummer oder E-Mail-Adresse
Channel	Der Zustellkanal des letzten Versuchs (`Email`, `SMS`, `WhatsApp`, `Telegram` oder `Voice`)
Cost	Gesamter berechneter Betrag über alle Zustellversuche der Sitzung
Created	Zeitpunkt, zu dem die Verifizierung erstellt wurde

Die Liste zeigt 25 Verifizierungen pro Seite.

Suchen und filtern

Über einer Zeitleiste des Volumens bietet die Seite eine Suche nach Empfängern und drei Filter. Kombinieren Sie Filter, um die Liste einzugrenzen:

Search by phone number: Suchen Sie nach einer exakten Telefonnummer des Empfängers im E.164-Format, zum Beispiel +14155550100.
Status: Filtern Sie nach Pending, Converted (verified), Failed oder Expired.
Channel: Filtern Sie nach Zustellkanal (Email, SMS, WhatsApp, Telegram oder Voice).
Date range: Wählen Sie einen vordefinierten Zeitraum oder legen Sie im Kalender oder auf der Zeitleiste einen eigenen Zeitraum fest.

Wenn keine Verifizierungen zu den aktiven Filtern passen, setzen Sie die Ansicht mit Clear filters zurück.

Status

Eine Verifizierung beginnt im Status Pending (pending) und wechselt genau einmal in einen Endzustand:

Bezeichnung im Dashboard	API `status`	Bedeutung
Pending	`pending`	Die Verifizierung ist aktiv und wartet vor `expires_at` auf eine Prüfung mit dem passenden Bestätigungscode
Converted	`verified`	Ein Prüfaufruf hat vor Ablauf den passenden Code übermittelt
Failed	`failed`	Die Sitzung hat ihre zulässigen Prüfversuche (`attempts_exhausted`) aufgebraucht, oder die Zustellung ist auf jedem Kanal fehlgeschlagen
Expired	`expired`	Die Gültigkeitsdauer des Codes (`ttl_elapsed`) ist abgelaufen, ohne dass eine Prüfung erfolgreich war oder die Versuche aufgebraucht wurden
Canceled	`canceled`	Die Sitzung wurde vor dem Abschluss abgebrochen
Blocked	`blocked`	Eine Sicherheits- oder Richtlinienprüfung hat die Verifizierung blockiert

Wie Statusübergänge und Gründe für den Endstatus mit erneutem Senden und Kanal-Fallback zusammenwirken, erfahren Sie unter Verifizierungen senden.

Eine Verifizierung untersuchen

Wählen Sie eine beliebige Zeile aus, um das Detailblatt der Verifizierung zu öffnen. Es gliedert die Sitzung in drei Abschnitte:

Zusammenfassung

Der Kopfbereich der Zusammenfassung zeigt das Ergebnis und die Konfiguration der Sitzung:

Outcome: Bei einer konvertierten Sitzung die Dauer bis zur Konvertierung (Converted in) und welcher Prüfversuch übereinstimmte (zum Beispiel Code matched on 1st check). Bei einer fehlgeschlagenen Sitzung die Anzahl der fehlgeschlagenen Prüfungen.
Code: Die konfigurierte Ziffernlänge und das Ablaufzeitfenster der Sitzung.
Channels used: Jeder Kanal, der während der Sitzung eine Zustellung versucht hat.
Metadata: Alle Schlüssel-Wert-Paare, die Sie beim Erstellen der Verifizierung in metadata übergeben haben.

Zeitachse des Lebenszyklus

Die Zeitachse ordnet jeden Schritt der Sitzung von der Erstellung bis zum Abschluss:

Channel attempts: Jeder Versand eines Bestätigungscodes (SMS, WhatsApp, Telegram, Voice oder Email), sein Absender, sein Zustellergebnis (sent, delivered oder undelivered mit dem Fehlergrund), die verstrichene Zustellzeit und die Kosten pro Versuch. Geplante Fallback-Kanäle, die noch nicht ausgelöst wurden, erscheinen als bevorstehende Schritte, solange die Sitzung aussteht.
Code checks: Jeder POST /v1/verify/verifications/check-Aufruf und ob der Code übereinstimmte.
Terminal state: Der Zeitpunkt, zu dem die Sitzung ihren Endstatus erreicht hat.

Kostenaufschlüsselung

Wenn eine Sitzung kostenpflichtige Versuche enthält, gruppiert Cost breakdown die Kosten nach Kanal und Absenderklasse (Shared sender, Custom domain, Dedicated sender oder Managed sender) und zeigt daneben den Total der Sitzung in der Währung Ihres Workspace.

Die Verifizierungsliste und die Detailansichten gibt es nur im Dashboard, es gibt keinen öffentlichen API-Endpunkt zum Auflisten oder Abrufen. Um die Erstellung von Verifizierungen, die Zustellung pro Versuch und die Konversion programmatisch zu verfolgen, nutzen Sie die synchrone Check-Antwort und abonnieren Sie Verify-Events.

Nächste Schritte

Verify-Events: Empfangen Sie Webhook-Zustellungen für verify.verification.*- und verify.attempt.*-Events.
Verifizierungen senden: Konfigurieren Sie Code-Gültigkeitsdauer, Versuchslimits, erneutes Senden und Fallback über mehrere Kanäle.
Verify-Ziele: Aktivieren Sie Zielländer und passen Sie die Reihenfolge der Kanal-Fallbacks an.

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.

Übung ausprobieren und ein Implementierungs-Briefing erhalten

Verwandte Ressourcen