--- title: "Journal Verify" description: "Parcourez, filtrez et examinez chaque session de vérification dans le tableau de bord Bird : statuts, tentatives par canal, délai de conversion et détail des coûts." canonical: "https://bird.com/fr-fr/documentation/guides/verify/verify-log" --- # Journal Verify Le **Verify log**, affiché sur la page [**Verifications**](https://bird.com/dashboard/w/verify/verifications) sous **Verify** > **Verifications**, enregistre chaque session de vérification de votre espace de travail. Les vérifications les plus récentes apparaissent en premier. Utilisez-le pour confirmer qu'une vérification a bien été créée, suivre chaque tentative d'envoi et chaque contrôle par canal, et examiner le délai de conversion et le coût de chaque tentative. Le code de vérification à usage unique généré n'est jamais stocké en clair ni affiché dans le tableau de bord. ![La page Verifications listant les vérifications avec les colonnes statut, identifiant de vérification, destinataire, canal, coût et date de création](/images/docs/dashboard-verify-verifications.png) ## La liste des vérifications Chaque ligne correspond à une session de vérification. Les colonnes sont les suivantes : | Colonne | Contenu | | :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------- | | **Status** | Le statut actuel de la session (**Pending**, **Converted**, **Failed**, **Expired**, **Canceled** ou **Blocked** ; voir [Statuts](#statuts)) | | **Verification** | L’identifiant de la vérification (`vrf_...`) | | **Recipient** | Le numéro de téléphone ou l’adresse e-mail en cours de vérification | | **Channel** | Le canal de distribution utilisé pour la dernière tentative (`Email`, `SMS`, `WhatsApp`, `Telegram` ou `Voice`) | | **Cost** | Montant total facturé pour l’ensemble des tentatives de distribution de la session | | **Created** | Date et heure de création de la vérification | La liste affiche 25 vérifications par page. ## Rechercher et filtrer Au-dessus d’une chronologie du volume, la page propose une recherche par destinataire et trois filtres. Vous pouvez combiner les filtres pour affiner la liste : - **Search by phone number** : recherchez un numéro de téléphone de destinataire exact au format [E.164](https://en.wikipedia.org/wiki/E.164), par exemple `+14155550100`. - **Status** : filtrez sur **Pending**, **Converted** (`verified`), **Failed** ou **Expired**. - **Channel** : filtrez par canal de distribution (`Email`, `SMS`, `WhatsApp`, `Telegram` ou `Voice`). - **Date range** : choisissez une période prédéfinie ou sélectionnez une plage personnalisée dans le calendrier ou sur la frise chronologique. Si aucune vérification ne correspond aux filtres actifs, utilisez **Clear filters** pour réinitialiser l’affichage. ## Statuts Une vérification commence à l’état **Pending** (`pending`) et passe une seule fois à un état final : | Libellé du tableau de bord | API `status` | Signification | | :------------------------- | :----------- | :----------------------------------------------------------------------------------------------------------------------------- | | **Pending** | `pending` | La vérification est active et attend une vérification de code correspondante avant `expires_at` | | **Converted** | `verified` | Un appel de vérification a fourni le code correspondant avant l’expiration | | **Failed** | `failed` | La session a épuisé ses tentatives de vérification autorisées (`attempts_exhausted`) ou la remise a échoué sur tous les canaux | | **Expired** | `expired` | La durée de validité du code s’est écoulée (`ttl_elapsed`) sans vérification réussie ni épuisement des tentatives | | **Canceled** | `canceled` | La session a été annulée avant de se terminer | | **Blocked** | `blocked` | La vérification a été bloquée par un contrôle de sécurité ou de politique | Pour savoir comment les transitions de statut et les motifs d'état final interagissent avec les renvois et le basculement entre canaux, consultez [Envoi de vérifications](/docs/guides/verify/sending-verifications#statuses). ## Inspecter une vérification Sélectionnez une ligne pour ouvrir le panneau de détail de la vérification. Il organise la session en trois sections : ### Résumé L'en-tête du résumé indique le résultat et la configuration de la session : - **Outcome** : pour une session convertie, la durée de conversion (`Converted in`) et la tentative de contrôle qui a correspondu (par exemple, `Code matched on 1st check`). Pour une session en échec, le nombre de contrôles échoués. - **Code** : la longueur configurée du code et sa durée de validité pour la session. - **Channels used** : chaque canal qui a tenté une remise pendant la session. - **Metadata** : les paires clé-valeur transmises dans `metadata` lors de la création de la vérification. ### Chronologie du cycle de vie La chronologie présente dans l’ordre chaque étape de la session, de sa création à sa résolution : - **Channel attempts** : chaque envoi du code de vérification (`SMS`, `WhatsApp`, `Telegram`, `Voice` ou `Email`), son expéditeur, son résultat de livraison (`sent`, `delivered` ou `undelivered` avec le motif de l’erreur), le délai de livraison écoulé et le coût par tentative. Tant que la session est en attente, les canaux de repli prévus qui n’ont pas encore été déclenchés apparaissent comme des étapes à venir. - **Code checks** : chaque appel à [`POST /v1/verify/verifications/check`](/docs/api/reference/create-verification-check) et le fait que le code corresponde ou non. - **Terminal state** : le moment où la session a atteint son statut final. ### Détail des coûts Lorsqu’une session comporte des tentatives facturées, **Cost breakdown** regroupe les frais par canal et par classe d’expéditeur (`Shared sender`, `Custom domain`, `Dedicated sender` ou `Managed sender`), à côté du **Total** de la session dans la devise de votre espace de travail. La liste des vérifications et les vues détaillées sont disponibles uniquement dans le tableau de bord : aucun endpoint API public ne permet de les lister ou de les lire. Pour suivre par programmation la création des vérifications, la livraison de chaque tentative et la conversion, utilisez la [réponse de vérification](/docs/guides/verify/sending-verifications#check-the-code) synchrone et abonnez-vous aux [événements Verify](/docs/guides/verify/events). ## Étapes suivantes - [Événements Verify](/docs/guides/verify/events) : recevez des webhooks pour les événements `verify.verification.*` et `verify.attempt.*`. - [Envoyer des vérifications](/docs/guides/verify/sending-verifications) : configurez la durée de validité du code, les limites de tentatives, les renvois et le repli multicanal. - [Destinations Verify](/docs/guides/verify/destinations) : activez les pays de destination et personnalisez l’ordre de basculement entre canaux. ## 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)