Guide d'intégration du Reverse OTP pour la vérification de numéro de téléphone
Un guide complet, étape par étape, pour mettre en place la vérification Reverse OTP dans votre application mobile : intégration de l'API, détection de WhatsApp, gestion des cas limites et stratégies de repli pour une authentification fluide.

Où se situe cette page
Cette page est le pas-à-pas d'implémentation. Pour comprendre ce qu'est le Reverse OTP et comment les éléments s'articulent, lisez le fonctionnement du Reverse OTP ; pour les arguments en faveur d'un changement de canal, lisez Reverse OTP et SMS OTP. La référence des endpoints se trouve dans le guide d'intégration de l'API de vérification WhatsApp.
Le Reverse OTP est une approche innovante de la vérification des utilisateurs qui s'appuie sur des messageries comme WhatsApp pour simplifier le processus. Au lieu d'envoyer un SMS OTP à l'utilisateur, c'est l'application elle-même qui envoie un message prérempli, et le serveur vérifie l'expéditeur. Cela réduit les risques de fraude, accélère le parcours et peut diminuer les coûts par rapport aux SMS OTP traditionnels.
Dans cet article, nous verrons comment intégrer le Reverse OTP à votre parcours de vérification de numéro de téléphone existant : intégration de l'API, détection de l'application, gestion des cas limites, et que faire lorsque WhatsApp n'est pas disponible.

Détecter WhatsApp sur l'appareil de l'utilisateur
Avant de lancer la vérification, votre application doit contrôler si WhatsApp est installé grâce à canOpenURL.
Implémentation iOS :
Déclarez d'abord whatsapp:// comme schéma de requête dans l'Info.plist de votre application, sous LSApplicationQueriesSchemes.
Configuration de l'Info.plist
<key>LSApplicationQueriesSchemes</key>
<array>
<string>whatsapp</string>
</array>Implémentation Android :
Utilisez PackageManager pour vérifier la présence du package WhatsApp.
Détection de WhatsApp sur Android
try {
PackageManager pm = getPackageManager();
pm.getPackageInfo("com.whatsapp", PackageManager.GET_ACTIVITIES);
// WhatsApp is installed
} catch (PackageManager.NameNotFoundException e) {
// WhatsApp is not installed
}Bonne pratique : si WhatsApp est disponible, poursuivez avec le Reverse OTP. Sinon, repliez-vous en douceur sur le SMS.
Lancer le Reverse OTP
Générez sur votre backend un court code de session unique (ce peut être un identifiant existant, comme l'UUID de l'utilisateur). Appelez avec ce code notre API start-verification-flow. Elle renvoie un token unique, qui sert à générer un lien profond WhatsApp prérempli.
Format du lien profond WhatsApp
https:/PHONE_NUMBER?text=VERIFY-12345Le texte généré contient ce token de vérification entre crochets, afin que le backend puisse le détecter et le rattacher à la session d'origine.
L'utilisateur touche le lien, WhatsApp s'ouvre, il appuie sur envoyer, et le numéro de téléphone de l'utilisateur est extrait côté backend à partir des métadonnées WhatsApp.
L'utilisateur reçoit directement sur WhatsApp un message de confirmation contenant une URL de callback pour revenir sur votre service.
Exemple d'intégration de l'API
const response = await fetch('/api/start-verification', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
session_id: userSessionId,
phone_number: userPhoneNumber
})
});
const { validation_token, whatsapp_url } = await response.json();Interroger le résultat
Une fois l'utilisateur de retour dans le parcours, votre backend interroge le statut de la session ouverte précédemment pour récupérer directement le numéro de téléphone. Vous pouvez enregistrer ce numéro et marquer la vérification comme réussie.
Implémentation de la vérification du statut
const checkStatus = async (sessionId) => {
const response = await fetch('/api/check-verification-status', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ session_id: sessionId })
});
const result = await response.json();
if (result.status === 'verified') {
// Save the verified phone number
saveVerifiedPhoneNumber(result.phone_number);
markVerificationComplete();
}
return result;
};Astuce : mettez en place un polling pour contrôler le statut de la vérification toutes les quelques secondes, jusqu'à son aboutissement ou à l'expiration du délai.
Gérer les cas limites
Il arrive que des utilisateurs ouvrent WhatsApp sans terminer le processus :
- Ils refusent une fenêtre de demande d'autorisations WhatsApp
- L'application est déchargée ou supprimée
- Le message reste bloqué à l'envoi à cause d'une mauvaise connectivité
Comment y répondre :
Expiration en douceur :
Si le message n'arrive pas au bout de quelques minutes, proposez à l'utilisateur :
Mécanisme de nouvelle tentative :
Proposez un bouton « Renvoyer via WhatsApp » qui régénère un lien.
Options de repli :
Proposez toujours un autre canal de vérification pour ne pas bloquer l'onboarding.
Persistance de l'état :
Si l'utilisateur revient plus tard, gardez sa session active et reproposez les options de vérification sans l'obliger à recommencer l'onboarding.
Implémentation de la gestion des cas limites
const handleVerificationTimeout = () => {
showDialog({
title: "Verification Incomplete",
message: "It looks like your verification didn't complete. Would you like to try again or switch to SMS?",
buttons: [
{ label: "Try WhatsApp Again", action: retryWhatsAppVerification },
{ label: "Use SMS Instead", action: fallbackToSMS },
{ label: "Cancel", action: closeDialog }
]
});
};
// Set timeout for 3 minutes
setTimeout(handleVerificationTimeout, 180000);Repli pour les utilisateurs sans WhatsApp
Si canOpenURL (iOS) ou PackageManager (Android) détecte que WhatsApp n'est pas disponible, basculez automatiquement sur un SMS OTP ou un OTP par e-mail.
Implémentation du repli
const initiateVerification = async () => {
const hasWhatsApp = await checkWhatsAppAvailability();
if (hasWhatsApp) {
// Use Reverse-OTP via WhatsApp
return initiateReverseOTP();
} else {
// Fall back to SMS OTP
return initiateSMSOTP();
}
};
const checkWhatsAppAvailability = async () => {
if (Platform.OS === 'ios') {
return await Linking.canOpenURL('whatsapp://');
} else {
// Android package check
return await isAppInstalled('com.whatsapp');
}
};Conseil d'expérience utilisateur : rendez le repli transparent en évitant de demander à l'utilisateur de choisir. Utilisez automatiquement la meilleure méthode disponible pour son appareil.
Conclusion
Le Reverse OTP rend la vérification plus rapide, plus sûre et souvent moins chère que le SMS. Mais il est essentiel de concevoir le parcours en tenant compte des interruptions du monde réel - des autorisations de l'application aux échecs de remise des messages - pour que l'utilisateur ait toujours une issue simple. Un parcours de repli bien pensé permet de maximiser à la fois la sécurité et le taux de conversion.
