Envoyer des codes de vérification (OTP) sur WhatsApp
Pour envoyer un code de vérification (OTP) sur WhatsApp, une entreprise crée un template d'authentification, le format fixe de Meta « <code> is your verification code. » avec un bouton de copie du code ou un bouton en un seul appui, puis son backend l'envoie via la Cloud API avec le code renseigné deux fois, dans le corps et dans le bouton. Les codes peuvent compter jusqu'à 15 caractères, et l'avertissement d'expiration facultatif peut aller de 1 à 90 minutes.
easyCoexistence relie votre numéro WhatsApp Business à la Cloud API de Meta via Coexistence et fournit à votre backend ce qu'il faut pour envoyer des templates d'authentification : l'endpoint Send, le token d'accès et, via votre IA, create_template et get_template_status.
Longueur maximale qu'un paramètre de template d'authentification peut atteindre ; les URL, médias et emojis ne sont pas autorisés dans son contenu ni dans ses paramètres.
Plage acceptée pour code_expiration_minutes, qui ajoute la ligne « This code expires in N minutes. » au message.
Durée de vie par défaut (TTL) d'un template d'authentification ; elle peut être réglée de 30 secondes à 15 minutes.
Erreur renvoyée lorsqu'un template d'authentification est envoyé à un identifiant d'utilisateur limité à une entreprise, au lieu d'un numéro de téléphone.
Les messages d'authentification ne sont livrés que sur l'appareil WhatsApp principal de l'utilisateur ; les appareils associés affichent une invite à la place.
Débit fixe d'un numéro Coexistence, plafond pour une rafale de codes de connexion.
Qu'est-ce qu'un template d'authentification WhatsApp ?
Le seul format autorisé par Meta pour les mots de passe à usage unique et les codes de vérification : si une application propose des codes par WhatsApp, elle doit utiliser ce format, et les templates utilitaires ou marketing ne peuvent pas contenir de code. Le texte est fixe, « <code> is your verification code. », avec deux lignes facultatives : « For your security, do not share this code. » et « This code expires in <N> minutes. » Le seul élément que vous choisissez est le bouton. WhatsApp désactive le transfert de ces messages, et sur iOS 26 et versions ultérieures, le code est aussi proposé comme suggestion du clavier, sans aucune action de votre part.
Comment créer le template d'authentification ?
Choisissez-le dans la bibliothèque de templates de WhatsApp Manager, ou soumettez-le via l'API, ce que votre IA peut faire avec create_template et la catégorie AUTHENTICATION. Vous n'envoyez aucun texte de corps : Meta le rédige à partir de vos paramètres, dans la langue choisie, et transforme le bouton OTP en bouton URL à la création. Un template par langue. La fonction create_template du connecteur ne transmet pas message_send_ttl_seconds : la durée de vie par défaut de 10 minutes s'applique donc, sauf si vous la modifiez via l'API de Meta.
{
"connection_id": "<from list_numbers>",
"name": "login_code",
"language": "en_US",
"category": "AUTHENTICATION",
"components": [
{ "type": "BODY", "add_security_recommendation": true },
{ "type": "FOOTER", "code_expiration_minutes": 5 },
{ "type": "BUTTONS", "buttons": [
{ "type": "OTP", "otp_type": "COPY_CODE", "text": "Copy code" }
]}
]
}Comment votre backend envoie-t-il le code ?
Une requête par code vers l'endpoint /messages du numéro, avec le token d'accès obtenu via get_api_credentials ou via la carte « Plug in your own system » du tableau de bord. Le même code est transmis deux fois : dans le paramètre du corps et dans le paramètre du bouton URL à l'index 0, et le destinataire doit être un numéro de téléphone. Avant l'envoi, le backend génère le code, stocke un hachage de ce code accompagné d'une heure d'expiration et d'un compteur de tentatives, puis compare ensuite ce que l'utilisateur saisit avec ce hachage.
POST https://graph.facebook.com/<VERSION>/<PHONE_NUMBER_ID>/messages
Authorization: Bearer <ACCESS_TOKEN>
{
"messaging_product": "whatsapp",
"to": "5511987654321",
"type": "template",
"template": {
"name": "login_code",
"language": { "code": "en_US" },
"components": [
{ "type": "body",
"parameters": [{ "type": "text", "text": "482913" }] },
{ "type": "button", "sub_type": "url", "index": "0",
"parameters": [{ "type": "text", "text": "482913" }] }
]
}
}Pourquoi le code vient-il de votre backend et non d'une automatisation ?
Parce que le système qui connecte l'utilisateur doit créer le code, le mémoriser et le vérifier, et que lui seul sait quand un code est nécessaire. Les automatisations répondent aux messages envoyés par les clients, et un écran de connexion n'écrit jamais sur votre numéro. Le template lui-même les exclut aussi : le bouton OTP porte le code en tant que variable de bouton, et l'étape « Envoyer un template » ne remplit que les variables du corps, elle ne peut donc pas envoyer de template d'authentification. Votre IA peut en envoyer un via send_template, qui transmet les composants de bouton à Meta, mais c'est pour un test, et non pour un flux de connexion.
Qu'est-ce qui rend un flux OTP WhatsApp sécurisé ?
Les bonnes pratiques de Meta et les limites du format mènent à la même liste de contrôle. Rien de tout cela ne demande plus que votre backend et la Cloud API :
- Confirmez le numéro WhatsApp avec l'utilisateur avant le premier code, et indiquez que le code arrivera sur WhatsApp.
- Réglez la durée de vie égale ou inférieure à l'expiration du code, pour qu'une livraison tardive n'affiche jamais un code expiré.
- Limitez les tentatives et les renvois par numéro, et faites expirer les codes dès la première utilisation.
- Ne faites pas du code WhatsApp le seul facteur de récupération de compte : des numéros de téléphone recyclés peuvent encore atteindre un ancien compte WhatsApp.
- Surveillez le webhook de statut et proposez le SMS ou l'e-mail lorsqu'un code ne parvient pas à être livré.
Qu'est-ce qui change lorsque le numéro fonctionne aussi dans l'application WhatsApp Business ?
L'envoi fonctionne comme sur tout numéro Cloud API, jusqu'à 20 messages par seconde. Meta reflète dans les conversations de l'application les messages envoyés via l'API : sur un numéro Coexistence, les codes que vous envoyez apparaissent donc aussi dans ces conversations, sur le téléphone professionnel. Gardez ce téléphone entre les mains de personnes de confiance, ou envoyez les codes depuis un numéro distinct. Les bonnes pratiques de Meta demandent aussi à chaque entreprise d'envoyer ses templates d'authentification depuis son propre numéro, jamais depuis un numéro partagé entre entreprises. L'authentification est une catégorie de template payante, facturée par message livré selon le pays du destinataire, avec des tarifs d'authentification internationale distincts dans certains marchés ; easyCoexistence n'applique aucune majoration.
Comment le configurer
- Connect the numberConnect your WhatsApp Business number to easyCoexistence through Meta's Coexistence flow, or use a separate number reserved for codes.
- Create the authentication templateAsk your AI to submit login_code with create_template, category AUTHENTICATION, a copy-code button and an expiry, then check get_template_status for APPROVED.
- Store the credentials on your serverCall get_api_credentials or open "Plug in your own system" in the dashboard, and put the Send endpoint and access token in your backend's secrets.
- Build generate, send and verifyGenerate the code, store its hash with an expiry, send the template with the code in the body and button, then check the user's entry against the hash.
- Handle failuresRead failed statuses from the number's webhook, then offer SMS or email and show the user which number the code went to.
Erreurs courantes
- Écrire le code dans un template utilitaire du type « Your code is {{1}} ». Meta n'autorise les codes que dans les templates d'authentification et rejette les templates utilitaires ou marketing qui en contiennent.
- N'inscrire le code que dans le corps. Le bouton de copie a besoin de la même valeur comme paramètre : Meta attend le code deux fois dans la requête.
- Garder une durée de vie de 30 jours sur un ancien template d'authentification. Un téléphone resté hors ligne pendant une heure reçoit alors un code expiré ; réglez-la égale ou inférieure à l'expiration du code.
- Adresser le code à un identifiant d'utilisateur limité à une entreprise. Les templates d'authentification ne vont qu'aux numéros de téléphone, et Meta renvoie l'erreur 131062.
Le numéro est surveillé en permanence, donc une déconnexion qui bloquerait les codes de connexion vous est signalée par e-mail. De US$ 9 à US$ 0,75 par numéro et par mois, qui baisse à mesure que vous ajoutez des numéros, avec les 3 premiers jours gratuits.
Questions fréquemment posées
Un code OTP WhatsApp est-il moins cher qu'un code SMS ?
Meta facture chaque message d'authentification livré au tarif du pays du destinataire, avec des tarifs spéciaux dans certains marchés ; les prix du SMS varient selon l'opérateur et la route. Pour vos principaux pays, comparez la grille de Meta à celle de votre fournisseur SMS avant de changer.
Est-ce la même chose que le code PIN de validation en deux étapes de WhatsApp ?
Non. La validation en deux étapes est le code PIN à six chiffres qui protège le numéro WhatsApp de l'entreprise elle-même. Un template d'authentification envoie un code à vos clients pour que votre application ou votre site puisse vérifier leur identité.
Les utilisateurs doivent-ils donner leur accord pour recevoir des codes ?
Oui. La politique de Meta exige une autorisation avant qu'une entreprise envoie un message à quelqu'un, et ses recommandations OTP suggèrent de proposer un choix de canaux, comme WhatsApp, SMS ou e-mail. Choisir WhatsApp sur votre écran de connexion, à côté du numéro, constitue cette autorisation.
Une agence peut-elle envoyer des codes pour plusieurs clients depuis un seul numéro ?
Non. Les bonnes pratiques de Meta exigent que chaque entreprise dispose de son propre compte WhatsApp Business et de son propre numéro de téléphone pour les templates d'authentification ; partager un numéro entre entreprises va à l'encontre des conditions et de la politique de Meta. Connectez plutôt un numéro par client.
Poursuivre la lecture
Prêt à commencer ?
Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.
Commencer l'essai gratuitVérifié le