Présentation de Verify

Bird Verify confirme qu'un utilisateur contrôle une adresse e-mail ou un numéro de téléphone. Demandez à Bird d'envoyer un code de vérification à usage unique, recueillez-le dans votre application, puis demandez à Bird s'il correspond. Le flux utilise deux appels API : POST /v1/verify/verifications envoie le code et POST /v1/verify/verifications/check le vérifie. Les expéditeurs partagés de Bird ne nécessitent ni enregistrement d'expéditeur ni configuration de modèle. Email, SMS et WhatsApp peuvent utiliser Bird Verify par défaut, Authifly ou un expéditeur appartenant à votre espace de travail ; Telegram utilise son propre compte de notification vérifié. Expéditeurs et personnalisation détaille ce choix.

Vous créez une vérification avec un destinataire : une adresse e-mail, un numéro de téléphone, ou les deux. Bird génère un code de vérification numérique et le distribue via les canaux du destinataire. Une adresse e-mail reçoit le code par e-mail ; un numéro de téléphone le reçoit par SMS ou WhatsApp, dans l'ordre et selon la disponibilité définis par votre configuration par pays pour le pays de destination. L'utilisateur saisit le code dans votre application, et vous le soumettez au endpoint de vérification, qui répond success: true ou false avec une raison.

Une vérification suit un cycle de vie court : elle commence pending et se termine verified (un code correct est arrivé dans le délai), failed (trop de tentatives erronées) ou expired (la fenêtre a expiré). La page Verifications affiche chaque vérification et son état ; chaque état et raison est détaillé dans Envoi de vérifications.

Dans le tableau de bord, Verify est l'une des applications de l'espace de travail. Ses pages, et où se trouve le guide de chacune :

La page Verifications liste chaque vérification de l'espace de travail et donne accès au destinataire, au plan de canaux et aux détails de timing de chacune. Par programmation, la réponse de vérification contient l'état actuel de la vérification. Abonnez-vous aux événements Verify pour les mises à jour de création, de distribution et de vérification réussie. Les endpoints de liste et de lecture sont accessibles au tableau de bord mais pas à l'API publique.

Verify distribue les codes sur quatre canaux. Le canal reçu par un destinataire dépend du type de destinataire et, pour les numéros de téléphone, de votre configuration par pays.

Pour un destinataire téléphonique, WhatsApp est essayé en premier et SMS sert de solution de repli dans la plupart des pays, bien que certains utilisent SMS par défaut en premier. Telegram se place après SMS et avant l'e-mail dans l'ordre de repli de la plateforme. Vous pouvez modifier l'ordre ou désactiver un canal par pays. Si un envoi échoue, la distribution passe au canal suivant dans le plan. Vous pouvez aussi la faire avancer quand un utilisateur signale ne pas avoir reçu le code ; voir Envoyer le code sur un autre canal. Expéditeurs et branding montre chaque message et les contrôles d'expéditeur disponibles.

Votre espace de travail démarre avec les valeurs par défaut de la plateforme Bird pour le code lui-même (longueur, durée de vie), la limite de tentatives de vérification et le délai de renvoi. Chacune est modifiable dans le tableau de bord sous Configure, et la longueur du code aussi par requête ; les valeurs et plages se trouvent dans Paramètres de vérification. Au-dessus de celles-ci se trouvent des garde-fous anti-abus que vous ne configurez pas : plafonds d'envoi et de vérification par destinataire, listés dans Garde-fous anti-abus. Le message du code adopte par défaut la langue du numéro de téléphone du destinataire, parmi 40 traductions intégrées, et options.language la remplace par requête. Voir Langue du message.