Journal Verify
Le Verify log, affiché sur la page 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 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) |
| 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, par exemple
+14155550100. - Status : filtrez sur Pending, Converted (
verified), Failed ou Expired. - Channel : filtrez par canal de distribution (
Email,SMS,WhatsApp,TelegramouVoice). - 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.
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
metadatalors 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,VoiceouEmail), son expéditeur, son résultat de livraison (sent,deliveredouundeliveredavec 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/checket 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 synchrone et abonnez-vous aux événements Verify.
Étapes suivantes
- Événements Verify : recevez des webhooks pour les événements
verify.verification.*etverify.attempt.*. - Envoyer des vérifications : configurez la durée de validité du code, les limites de tentatives, les renvois et le repli multicanal.
- Destinations Verify : activez les pays de destination et personnalisez l’ordre de basculement entre canaux.
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet.