Dziennik Verify

Verify log, wyświetlany na stronie Verifications w sekcji Verify > Verifications, to zapis wszystkich sesji weryfikacji w Twoim obszarze roboczym. Najnowsze weryfikacje są wyświetlane na początku. Korzystaj z niego, aby potwierdzić utworzenie weryfikacji, śledzić każdą próbę w kanale i każde sprawdzenie kodu oraz sprawdzać czas do konwersji i koszt poszczególnych prób. Wygenerowany jednorazowy kod weryfikacyjny nigdy nie jest przechowywany jako zwykły tekst ani wyświetlany w panelu.

Strona Verifications z listą weryfikacji i kolumnami statusu, identyfikatora weryfikacji, odbiorcy, kanału, kosztu i czasu utworzenia

Lista weryfikacji

Każdy wiersz to jedna sesja weryfikacji. Dostępne kolumny:

Kolumna	Co pokazuje
Status	Bieżący status sesji (Pending, Converted, Failed, Expired, Canceled lub Blocked; zobacz Statusy)
Verification	Identyfikator weryfikacji (`vrf_...`)
Recipient	Weryfikowany numer telefonu lub adres e-mail
Channel	Kanał dostarczenia użyty przy ostatniej próbie (`Email`, `SMS`, `WhatsApp`, `Telegram` lub `Voice`)
Cost	Łączna naliczona kwota za wszystkie próby dostarczenia w sesji
Created	Kiedy utworzono weryfikację

Lista jest podzielona na strony po 25 weryfikacji.

Wyszukiwanie i filtrowanie

Nad osią czasu z liczbą weryfikacji strona udostępnia wyszukiwarkę odbiorców i trzy filtry. Łącz filtry, aby zawęzić listę:

Search by phone number: wyszukaj dokładny numer telefonu odbiorcy w formacie E.164, na przykład +14155550100.
Status: filtruj według statusu Pending, Converted (verified), Failed lub Expired.
Channel: filtruj według kanału dostarczania (Email, SMS, WhatsApp, Telegram lub Voice).
Date range: wybierz gotowy przedział czasu albo zaznacz własny zakres w kalendarzu lub na pasku osi czasu.

Jeśli żadna weryfikacja nie pasuje do aktywnych filtrów, kliknij Clear filters, aby zresetować widok.

Statusy

Weryfikacja zaczyna się w statusie Pending (pending) i jednokrotnie przechodzi do stanu końcowego:

Etykieta w panelu	API `status`	Znaczenie
Pending	`pending`	Weryfikacja jest aktywna i czeka na sprawdzenie pasującego kodu weryfikacyjnego przed `expires_at`
Converted	`verified`	Wywołanie sprawdzające dostarczyło pasujący kod przed jego wygaśnięciem
Failed	`failed`	Sesja wyczerpała dozwoloną liczbę prób sprawdzenia (`attempts_exhausted`) lub dostarczenie nie powiodło się na żadnym kanale
Expired	`expired`	Czas ważności kodu upłynął (`ttl_elapsed`), zanim nastąpiło udane sprawdzenie lub wyczerpanie prób
Canceled	`canceled`	Sesja została anulowana przed zakończeniem
Blocked	`blocked`	Weryfikacja została zablokowana przez kontrolę bezpieczeństwa lub zasad

Informacje o tym, jak zmiany statusu i przyczyny stanu końcowego współdziałają z ponownym wysyłaniem i przełączaniem na kanał zapasowy, znajdziesz w sekcji Wysyłanie weryfikacji.

Sprawdzanie weryfikacji

Wybierz dowolny wiersz, aby otworzyć panel szczegółów weryfikacji. Dzieli on sesję na trzy sekcje:

Podsumowanie

Nagłówek podsumowania zawiera wynik i konfigurację sesji:

Outcome: W przypadku sesji zakończonej konwersją czas do konwersji (Converted in) oraz to, która próba sprawdzenia kodu była zgodna (na przykład Code matched on 1st check). W przypadku sesji nieudanej liczba nieudanych sprawdzeń.
Code: Skonfigurowana liczba cyfr i okres ważności kodu w sesji.
Channels used: Wszystkie kanały, którymi w trakcie sesji próbowano dostarczyć kod.
Metadata: wszystkie pary klucz-wartość przekazane w metadata podczas tworzenia weryfikacji.

Oś czasu cyklu życia

Oś czasu porządkuje wszystkie kroki sesji, od utworzenia do rozstrzygnięcia:

Channel attempts: każda wysyłka kodu weryfikacyjnego (SMS, WhatsApp, Telegram, Voice lub Email), jej nadawca, wynik doręczenia (sent, delivered lub undelivered wraz z przyczyną błędu), czas doręczenia i koszt danej próby. Zaplanowane kanały zapasowe, które jeszcze nie zostały użyte, są widoczne jako nadchodzące kroki, dopóki sesja oczekuje.
Code checks: każde wywołanie POST /v1/verify/verifications/check oraz informacja, czy kod był zgodny.
Terminal state: moment, w którym sesja osiągnęła status końcowy.

Zestawienie kosztów

Jeśli sesja zawiera płatne próby, sekcja Cost breakdown grupuje opłaty według kanału i klasy nadawcy (Shared sender, Custom domain, Dedicated sender lub Managed sender) i pokazuje obok sumę sesji Total w walucie obszaru roboczego.

Lista weryfikacji i widoki szczegółów są dostępne wyłącznie w panelu i nie mają publicznego punktu końcowego API do wyświetlania listy ani odczytu. Aby programowo śledzić tworzenie weryfikacji, doręczenie poszczególnych prób i konwersję, korzystaj z synchronicznej odpowiedzi na sprawdzenie i zasubskrybuj zdarzenia Verify.

Następne kroki

Zdarzenia Verify: odbieraj dostarczenia webhooków dla zdarzeń verify.verification.* i verify.attempt.*.
Wysyłanie weryfikacji: skonfiguruj czas ważności kodu, limity prób, ponowne wysyłki i wielokanałowy mechanizm zapasowy.
Miejsca docelowe Verify: włącz kraje docelowe i dostosuj kolejność zapasowych kanałów.

Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.

Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy

Powiązane zasoby