Registro di Verify

Il Verify log, visibile nella pagina Verifications in Verify > Verifications, registra ogni sessione di verifica del tuo spazio di lavoro. Le verifiche più recenti compaiono per prime. Usalo per confermare che una verifica è stata creata, seguire ogni tentativo di invio per canale e ogni controllo, ed esaminare i tempi di conversione e il costo di ciascun tentativo. Il codice di verifica monouso generato non viene mai memorizzato in chiaro né mostrato nella dashboard.

L'elenco delle verifiche

Ogni riga corrisponde a una sessione di verifica. Le colonne sono:

L'elenco mostra 25 verifiche per pagina.

Ricerca e filtri

Sopra una cronologia dei volumi, la pagina offre una ricerca per destinatario e tre filtri. Puoi combinare i filtri per restringere l'elenco:

• Search by phone number: cerca un numero di telefono del destinatario esatto in formato E.164, ad esempio +14155550100.
• Status: filtra per Pending, Converted (verified), Failed o Expired.
• Channel: filtra per canale di consegna (Email, SMS, WhatsApp, Telegram o Voice).
• Date range: scegli un intervallo predefinito oppure seleziona un intervallo personalizzato dal calendario o dalla barra della cronologia.

Se nessuna verifica corrisponde ai filtri attivi, usa Clear filters per reimpostare la visualizzazione.

Stati

Una verifica parte nello stato Pending (pending) e passa una sola volta a uno stato finale:

Per capire come le transizioni di stato e i motivi dello stato finale interagiscono con i reinvii e il fallback tra canali, consulta Invio delle verifiche.

Esaminare una verifica

Seleziona una riga qualsiasi per aprire il pannello di dettaglio della verifica. Il pannello organizza la sessione in tre sezioni:

Riepilogo

L'intestazione del riepilogo riporta l'esito e la configurazione della sessione:

• Outcome: per una sessione convertita, la durata della conversione (Converted in) e il tentativo di controllo che ha trovato la corrispondenza (ad esempio, Code matched on 1st check). Per una sessione non riuscita, il numero di controlli falliti.
• Code: il numero di cifre e la finestra di scadenza configurati per la sessione.
• Channels used: ogni canale che ha tentato la consegna durante la sessione.
• Metadata: le coppie chiave-valore passate in metadata alla creazione della verifica.

Cronologia del ciclo di vita

La cronologia mostra in ordine ogni passaggio della sessione, dalla creazione alla risoluzione:

• Channel attempts: ogni invio del codice di verifica (SMS, WhatsApp, Telegram, Voice o Email), il mittente, l'esito della consegna (sent, delivered o undelivered con il motivo dell'errore), il tempo di consegna trascorso e il costo del singolo tentativo. Mentre la sessione è in sospeso, i canali di fallback previsti che non sono ancora stati attivati compaiono come passaggi successivi.
• Code checks: ogni chiamata POST /v1/verify/verifications/check e se il codice corrispondeva.
• Terminal state: il momento in cui la sessione ha raggiunto lo stato finale.

Ripartizione dei costi

Quando una sessione include tentativi addebitati, Cost breakdown raggruppa gli addebiti per canale e classe di mittente (Shared sender, Custom domain, Dedicated sender o Managed sender) insieme al Total della sessione nella valuta del tuo spazio di lavoro.

L'elenco delle verifiche e le viste di dettaglio sono disponibili solo nella dashboard e non esiste un endpoint API pubblico per elencarle o leggerle. Per monitorare tramite codice la creazione delle verifiche, la consegna di ogni tentativo e la conversione, usa la risposta del controllo sincrona e iscriviti agli eventi di Verify.

Passaggi successivi

• Eventi di Verify: ricevi tramite webhook gli eventi verify.verification.* e verify.attempt.*.
• Invio delle verifiche: configura la durata del codice, i limiti di tentativi, i reinvii e il fallback su più canali.
• Destinazioni di Verify: abilita i paesi di destinazione e personalizza l'ordine di fallback dei canali.