--- title: "Registro di Verify" description: "Sfoglia, filtra e ispeziona ogni sessione di verifica nella dashboard di Bird: stati, tentativi per canale, tempi di conversione e ripartizione dei costi." canonical: "https://bird.com/it-it/documentazione/guides/verify/verify-log" --- # Registro di Verify Il **Verify log**, visibile nella pagina [**Verifications**](https://bird.com/dashboard/w/verify/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. ![La pagina Verifications che elenca le verifiche con le colonne stato, ID della verifica, destinatario, canale, costo e data di creazione](/images/docs/dashboard-verify-verifications.png) ## L'elenco delle verifiche Ogni riga corrisponde a una sessione di verifica. Le colonne sono: | Colonna | Cosa mostra | | :--------------- | :-------------------------------------------------------------------------------------------------------------------------------------- | | **Status** | Lo stato attuale della sessione (**Pending**, **Converted**, **Failed**, **Expired**, **Canceled** o **Blocked**; vedi [Stati](#stati)) | | **Verification** | L'ID della verifica (`vrf_...`) | | **Recipient** | Il numero di telefono o l'indirizzo email da verificare | | **Channel** | Il canale di consegna usato per l'ultimo tentativo (`Email`, `SMS`, `WhatsApp`, `Telegram` o `Voice`) | | **Cost** | Importo totale addebitato per tutti i tentativi di consegna della sessione | | **Created** | Quando è stata creata la verifica | 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](https://en.wikipedia.org/wiki/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: | Etichetta nella dashboard | API `status` | Significato | | :------------------------ | :----------- | :------------------------------------------------------------------------------------------------------------------------------------ | | **Pending** | `pending` | La verifica è attiva e attende un controllo con il codice di verifica corretto prima di `expires_at` | | **Converted** | `verified` | Una chiamata di controllo ha fornito il codice corretto prima della scadenza | | **Failed** | `failed` | La sessione ha esaurito i tentativi di controllo consentiti (`attempts_exhausted`) oppure la consegna non è riuscita su nessun canale | | **Expired** | `expired` | La durata del codice è scaduta (`ttl_elapsed`) senza un controllo riuscito né l'esaurimento dei tentativi | | **Canceled** | `canceled` | La sessione è stata annullata prima del completamento | | **Blocked** | `blocked` | La verifica è stata bloccata da un controllo di sicurezza o di policy | 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](/docs/guides/verify/sending-verifications#statuses). ## 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`](/docs/api/reference/create-verification-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](/docs/guides/verify/sending-verifications#check-the-code) sincrona e iscriviti agli [eventi di Verify](/docs/guides/verify/events). ## Passaggi successivi - [Eventi di Verify](/docs/guides/verify/events): ricevi tramite webhook gli eventi `verify.verification.*` e `verify.attempt.*`. - [Invio delle verifiche](/docs/guides/verify/sending-verifications): configura la durata del codice, i limiti di tentativi, i reinvii e il fallback su più canali. - [Destinazioni di Verify](/docs/guides/verify/destinations): abilita i paesi di destinazione e personalizza l'ordine di fallback dei canali. ## Related resources - [Verify phone numbers at signup](/learn/series/verify-phone-numbers-at-signup) (video) - [What does OTP mean? One-time passwords explained](/explained/verify/what-does-otp-mean) (answer) - [Customer verification](/verify-api) (product) - [Build your first integration](/learn/paths/integration) (course) [Get an implementation brief](/learn/workspace?topic=verify)