Vérification du téléphone : API OTP, SMS et WhatsApp

La vérification du téléphone de Didit offre une méthode fiable pour vérifier les numéros de téléphone des utilisateurs au moyen de codes à usage unique (OTP). Cette fonctionnalité ajoute une couche de sécurité essentielle à votre processus de vérification d’identité, garantissant la légitimité des coordonnées de vos utilisateurs. Dans la leçon de l’Academy consacrée à la lecture d’un résultat de vérification, le chapitre à 8:08 aborde la vérification du téléphone et la détection des doublons.

​

Comment ça fonctionne

Notre solution de vérification du téléphone assure une validation complète des numéros de téléphone à travers un processus simple et intuitif. Le système associe la vérification par OTP à une évaluation avancée des risques pour proposer une vérification du téléphone fiable et à grande échelle.

​

Fonctionnalités de vérification

Notre service de Vérification du téléphone propose plusieurs fonctionnalités clés pour améliorer votre processus de vérification :

​

Vérification par OTP

• Génération sécurisée de code : codes à usage unique générés de manière aléatoire
• Livraison par SMS : livraison rapide et fiable sur les appareils mobiles
• Délais configurables : définissez les durées d’expiration selon vos exigences de sécurité
• Options de nouvelle tentative : permettez aux utilisateurs de demander de nouveaux codes avec une limite de débit appropriée
• Codes personnalisés avec votre marque : les codes par SMS affichent le nom de votre marque au lieu d’être envoyés avec un message générique, sans frais supplémentaires. Consultez Messages de vérification personnalisés avec votre marque.
• Votre propre numéro WhatsApp : les codes WhatsApp peuvent provenir de votre propre numéro WhatsApp Business. Consultez Envoyer des codes WhatsApp depuis votre propre numéro.

​

Messages de vérification personnalisés avec votre marque

Les codes de vérification par SMS peuvent mentionner votre marque, afin que vos utilisateurs identifient le message comme venant de vous :

123456 est votre code de vérification pour Acme Bank

Seul le nom est personnalisable. Le reste de la formulation est un texte standard enregistré auprès des opérateurs mobiles dans chaque pays, ce qui évite que les codes soient filtrés comme spam, et il est traduit dans la langue du destinataire. L’ajout de votre marque est gratuit : un code personnalisé coûte le même prix qu’un code non personnalisé. Définissez votre nom d’expéditeur SMS dans la Business Console, dans Vérification du téléphone → Paramètres d’un workflow ou sous Marque blanche → SMS. Il appartient à votre application et non à un workflow unique : il signe chaque code SMS envoyé par l’application, dans chaque workflow et via l’API autonome, avec ou sans personnalisation en marque blanche. Nom utilisé pour un code, la première correspondance s’applique :

1. options.sms_sender_name sur POST /v3/phone/send/, pour ce code précis.
2. Le nom d’expéditeur SMS de votre application.
3. Pour les envois en marque blanche uniquement (un workflow avec personnalisation en marque blanche, ou options.use_white_label_customization: true sur l’API), votre nom public en marque blanche.
4. Sinon, le code est envoyé sans nom.

Un nom d’expéditeur comporte de 1 à 30 caractères : lettres, chiffres, espaces et ’ & - ! uniquement, pas uniquement des chiffres, avec des espaces simples entre les mots. L’API rejette tout nom ne respectant pas ces règles avec une erreur 400 avant l’envoi du code.

• Canaux : le nom est ajouté aux messages SMS, y compris à un SMS envoyé en repli depuis un autre canal. Les codes WhatsApp sont envoyés avec un message fixe et ne l’affichent pas ; pour y faire figurer le nom de votre entreprise, envoyez-les depuis votre propre numéro.
• Modifications par jour : chaque application peut commencer à utiliser jusqu’à deux nouveaux noms par jour (UTC), en comptant à la fois les nouveaux noms d’expéditeur et les nouvelles valeurs de sms_sender_name. Au-delà, les codes conservent le nom actuel de l’application jusqu’au lendemain, et un nouveau nom fourni par requête est envoyé avec le nom de l’application. Un nom déjà utilisé auparavant n’est pas recomptabilisé.
• Priorité à la livraison : un problème de marque ne bloque jamais un code. Si un nom ne peut pas être appliqué, le code est envoyé avec le nom de l’application, ou sans nom.

​

Rédiger votre propre texte de SMS et identifiant d’expéditeur

Vous pouvez remplacer le texte de vos codes SMS ainsi que l’expéditeur vu par vos utilisateurs. Configurez les deux dans la Business Console sous Marque blanche → SMS. Ils appartiennent à votre application, tout comme le nom d’expéditeur SMS, et s’appliquent à chaque code SMS qu’elle envoie, dans chaque workflow et via l’API autonome. Votre propre texte est rédigé pour chaque langue. Un code est envoyé avec votre texte lorsque vous en avez rédigé un pour la langue d’envoi du code ; toutes les autres langues conservent le texte traduit de Didit. Utilisez {code} pour le code et, éventuellement, {brand} pour votre nom d’expéditeur SMS, par exemple Acme: {code} is your login code for {brand}. Un texte doit :

• contenir {code} exactement une fois, et aucun autre espace réservé en dehors de {code} et {brand} ;
• ne contenir aucun lien : les opérateurs bloquent les codes de vérification qui en contiennent ;
• tenir dans un seul SMS avec un code à 8 chiffres et un nom de 30 caractères : jusqu’à 160 caractères, ou 70 lorsqu’il utilise des caractères hors de l’alphabet latin de base (par exemple cyrillique, arabe ou emoji).

Votre propre identifiant d’expéditeur utilise de 3 à 11 lettres, chiffres et espaces, pas uniquement des chiffres, par exemple AcmeBank. Il est utilisé dans les pays où Didit active les identifiants d’expéditeur personnalisés, c’est-à-dire les pays dont les opérateurs acceptent un nom d’expéditeur sans enregistrement préalable ; partout ailleurs, vos codes sont envoyés sous l’expéditeur de Didit. Contactez le support pour demander l’activation d’un pays où l’enregistrement de l’identifiant d’expéditeur est nécessaire.

• Priorité à la livraison : lorsqu’un code est renvoyé par un canal qui ne peut pas prendre en charge votre texte ou votre identifiant d’expéditeur, il est envoyé avec le texte de Didit, signé avec votre nom d’expéditeur SMS et l’expéditeur de Didit, afin que le code arrive toujours à destination.

​

Envoyer des codes WhatsApp depuis votre propre numéro

Par défaut, les codes WhatsApp proviennent du numéro WhatsApp Business de Didit. Vous pouvez plutôt connecter votre propre numéro WhatsApp Business, afin que vos utilisateurs reçoivent leurs codes depuis le nom et le numéro de votre entreprise. Connectez un numéro dans la Business Console, dans Vérification du téléphone → Paramètres → Numéro WhatsApp d’un workflow, et sélectionnez Connecter un numéro WhatsApp. Une fenêtre de connexion s’ouvre : connectez-vous au compte professionnel qui gère votre numéro WhatsApp Business, puis choisissez le compte WhatsApp Business et le numéro d’envoi. Didit enregistre ensuite le numéro pour l’envoi et crée son message de vérification. Sa modification nécessite l’autorisation de modifier la personnalisation, tout comme pour le nom d’expéditeur SMS. Le numéro appartient à votre application et non à un seul workflow : une fois connecté, il envoie chaque code WhatsApp émis par l’application, dans chaque workflow et via l’API autonome.

• Approbation : le nouveau message de vérification doit être approuvé avant que le numéro ne puisse envoyer des codes, généralement en quelques minutes. Entre-temps, la carte indique que le numéro est en attente d’approbation, et les codes continuent d’être envoyés depuis le numéro de Didit.
• Texte du message : les messages de vérification sur WhatsApp utilisent un texte standard dans la langue de votre utilisateur : le code, une mention de sécurité et un bouton de copie. Le texte ne peut pas être modifié, mais l’expéditeur est votre entreprise.
• Livraison : si un code ne peut pas être livré sur WhatsApp, il est envoyé par SMS, signé avec votre nom d’expéditeur SMS.
• Facturation : les messages envoyés par votre numéro sont facturés sur votre compte WhatsApp Business ; Didit ne facture donc que ses frais de vérification ($0.02) pour ces codes. Les codes envoyés par SMS sont facturés comme d’habitude.
• Action requise : si le numéro ne peut plus envoyer de messages (par exemple, si son accès a été révoqué depuis votre compte professionnel), les codes sont à nouveau envoyés depuis le numéro de Didit et la carte vous invite à reconnecter le numéro.
• Déconnecter à tout moment depuis la même carte. Les codes sont à nouveau envoyés depuis le numéro de Didit ; le numéro et son message de vérification restent dans votre compte WhatsApp Business.

​

Analyse du numéro de téléphone

• Validation du format : vérifiez que le numéro de téléphone respecte le format international approprié
• Détection de l’opérateur : identifiez le fournisseur de télécommunications associé au numéro
• Type de numéro : faites la distinction entre les numéros mobiles, fixes et VoIP
• Validation du pays : vérifiez que le numéro de téléphone correspond au format attendu pour le pays

​

Évaluation des risques

• Détection de numéros jetables : identifiez les numéros temporaires utilisés pour éviter la traçabilité
• Identification des numéros virtuels : signalez les numéros susceptibles d’être virtuels ou basés sur la VoIP
• Surveillance de l’activité : surveillez les schémas suspects sur l’ensemble des tentatives de vérification
• Vérification de la liste de blocage : effectuez une vérification par rapport aux listes internes de numéros ayant fait l’objet d’abus antérieurs

​

Tarifs

La vérification du téléphone est facturée par message envoyé, avec une tarification transparente à l’usage : La réduction de votre forfait s’applique uniquement aux frais Didit de $0.02 ; les frais de l’opérateur sont refacturés au prix coûtant et ne font jamais l’objet d’une réduction. Consultez Réductions. Nous prenons en charge plusieurs canaux de livraison avec des tarifs différents (la disponibilité varie selon les pays) : → Tarifs de la vérification du téléphone