Recevoir des codes de vérification WhatsApp sans mobiliser le téléphone d'un collaborateur

Pourquoi une équipe a-t-elle besoin d'un numéro WhatsApp qui n'appartient à personne en particulier ?

La situation est classique. Une équipe produit construit un parcours de support sur WhatsApp, ou teste la façon dont son application redirige les utilisateurs vers une conversation, et quelqu'un doit créer un compte. Le plus rapide, c'est le téléphone d'un collègue. Mais cela rattache une configuration professionnelle à la SIM d'un seul salarié, mélange le trafic de test avec ses conversations privées, et tout s'écroule le jour où il quitte l'entreprise.

Les agences qui configurent WhatsApp pour leurs clients se heurtent au même mur, tout comme les ingénieurs QA qui ont besoin d'un compte de test sur un marché précis pour observer le comportement d'un parcours d'inscription régional. Un numéro de téléphone WhatsApp issu de l'OTP Gateway garde ce travail à l'écart des lignes personnelles : vous choisissez le pays, vous recevez le code d'inscription, et vous passez à la suite.

Quand WhatsApp demande-t-il un code de vérification par téléphone ?

WhatsApp identifie chaque compte par son numéro de téléphone ; il vérifie donc le contrôle de ce numéro avec un code à usage unique à plusieurs moments :

• Inscription : un nouveau compte reçoit par SMS un code à six chiffres, et WhatsApp peut proposer un appel vocal à la place.
• Nouvel appareil : une réinstallation ou un changement de téléphone relance la vérification, et l'ancien téléphone est déconnecté.
• Comptes professionnels : la configuration de l'application WhatsApp Business sur un numéro passe par la même étape.
• Vérification en deux étapes : un code PIN facultatif choisi par l'utilisateur. Il n'est jamais envoyé par SMS, mais il est demandé en plus du code lorsqu'il est activé.

Pour les tests, l'enseignement est simple : le SMS prouve que vous détenez le numéro à cet instant, donc un numéro que vous ne détenez plus ne pourra pas vérifier le compte plus tard.

Comment fonctionne l'API de code de vérification WhatsApp ?

Utilisez l'identifiant de service whatsapp avec l'identifiant du pays du marché testé, par exemple in, br ou us. Avec une clé Bearer créée dans la console Développeur :

1. GET /api/v1/prices?country=<id>&service=whatsapp renvoie le prix en direct et indique si cette route est ouverte à l'instant.
2. POST /api/v1/activations avec {"service": "whatsapp", "country": "<id>"} réserve un numéro et lance la fenêtre de 20 minutes.
3. Saisissez le numéro sur l'écran d'inscription de WhatsApp et demandez le SMS.
4. Le code vous parvient sous forme d'événement webhook activation.sms_received, ou vous interrogez GET /api/v1/activations/{id} toutes les quelques secondes.
5. Si le test est abandonné, POST /api/v1/activations/{id}/cancel remet le montant dans le portefeuille.

Vérifiez X-OTPRoute-Signature avant de faire confiance au corps de la requête : calculez un HMAC-SHA256 sur <t>.<raw body> avec le secret du endpoint, comparez-le à v1 et refusez les horodatages trop anciens. Enregistrez ensuite l'événement avec son identifiant d'activation, afin qu'une livraison répétée ne change rien. L'interrogation (polling) est plus simple lorsqu'un exécuteur de tests ne peut pas exposer d'URL publique ; la documentation développeur décrit les deux approches.

Dans quels pays trouve-t-on des numéros WhatsApp, et le choix compte-t-il ?

Les routes WhatsApp sont actuellement disponibles dans 198 pays, dont l'Inde, le Brésil, l'Indonésie, le Nigeria, l'Allemagne, le Mexique, le Royaume-Uni, les États-Unis, le Pakistan, les Philippines, l'Égypte, le Kenya, l'Espagne, la Turquie et l'Afrique du Sud. L'ensemble figure sur la page des pays.

Choisissez le pays avec intention. Si votre parcours d'inscription vise des utilisateurs brésiliens, un numéro en +55 montre comment votre application met en forme, valide et affiche un numéro local. Si le compte professionnel doit servir un seul marché, alignez-vous sur ce marché. Un pays pris au hasard n'économise rien et peut rendre un résultat de test sans valeur.

Pourquoi le code WhatsApp peut-il ne pas arriver ?

WhatsApp décide lui-même vers quels numéros il envoie des codes, et il peut refuser purement et simplement un numéro virtuel pour l'inscription. Dans ce cas, rien n'arrive sur l'activation, la fenêtre se ferme et le montant total est restitué à votre portefeuille ; vous ne payez que si un code arrive réellement. D'autres causes sont plus banales : une route saturée, WhatsApp qui vous demande d'attendre avant de réclamer un nouveau code, ou un code demandé par appel vocal plutôt que par SMS.

Ce qu'il faut faire :

• Laissez l'activation ouverte pendant toute sa fenêtre au lieu de l'annuler après une minute.
• Vérifiez que l'écran d'inscription a bien demandé un SMS et non un appel.
• Réessayez plus tard, ou essayez la route d'un autre pays si le marché du compte le permet.
• Espacez vos tentatives. Enchaîner les demandes de code dans une boucle rapide aggrave généralement la situation.

Un compte WhatsApp durable doit-il utiliser un numéro dédié ?

En général, oui. Un numéro OTP Gateway sert pour un seul code ; si le compte doit être vérifié à nouveau après un changement de téléphone ou une réinstallation, il vous faut récupérer ce même numéro. Pour une ligne de support, un compte professionnel partagé ou un compte QA que les testeurs réutilisent pendant des mois, un Numéro virtuel dédié convient mieux. Ces numéros sont vendus instantanément aux États-Unis et au Canada à partir de $1.95/mois, se renouvellent depuis le portefeuille, transmettent les SMS entrants à votre webhook sous la forme number.sms_received et peuvent être libérés à tout moment. En dehors de ces deux pays, il n'existe pas de ligne longue durée en libre-service ; écrivez à [email protected] pour poser la question. Les détails se trouvent sur la page numéros virtuels.

Peut-on le faire depuis le tableau de bord sans accès à l'API ?

Oui. Connectez-vous, rechargez le portefeuille par carte ou en USDT/USDC, choisissez WhatsApp et un pays, confirmez le prix affiché, puis commandez. Saisissez le numéro dans WhatsApp, et le code apparaît sur la page d'activation dès sa réception. Il n'y a ni abonnement mensuel ni forfait, chaque rechargement donne lieu à une facture PDF envoyée par e-mail, et la même règle de remboursement s'applique que dans l'API. Les développeurs qui veulent d'abord répéter une intégration peuvent demander au support de passer un compte de développement en sandbox, où des numéros et des codes simulés permettent de tester le webhook sans dépenser de fonds.

Qu'est-ce qu'un usage responsable des numéros WhatsApp ?

OTP Route existe pour tester et exploiter vos propres produits et comptes légitimes. Respectez les conditions d'utilisation de WhatsApp, limitez-vous à un compte par personne réelle ou par entreprise, et n'utilisez pas les routes pour créer des comptes en masse, envoyer des messages non sollicités ou revenir sur la plateforme après un bannissement. La politique d'utilisation acceptable d'OTP Route s'applique à chaque activation. WhatsApp est une marque de son propriétaire, et OTP Route n'est pas affilié à WhatsApp.

Questions fréquentes

Puis-je recevoir un code WhatsApp (OTP) sans carte SIM ?

Oui. Un numéro OTP Gateway reçoit le SMS d'inscription WhatsApp et affiche le code dans votre tableau de bord ou l'envoie à votre webhook, sans aucune SIM physique.

Quel est l'identifiant du service WhatsApp dans l'API ?

Utilisez whatsapp comme service dans GET /api/v1/prices et POST /api/v1/activations, avec un identifiant de pays tel que in ou us.

WhatsApp acceptera-t-il tous les numéros virtuels ?

Non. WhatsApp peut refuser les numéros virtuels, c'est pourquoi une activation qui ne reçoit aucun code est remboursée intégralement sur votre portefeuille.

Puis-je me reconnecter plus tard au compte WhatsApp avec le même numéro ?

Pas avec un numéro de la passerelle, qui ne couvre qu'un seul code. Si le compte devra être vérifié à nouveau, utilisez un Numéro virtuel dédié aux États-Unis ou au Canada.

Combien coûte un numéro de vérification WhatsApp ?

Les prix commencent à $0.20 par code et varient selon le pays. Le prix en direct s'affiche dans le tableau de bord et via le endpoint des prix avant que vous ne commandiez.

La vérification SMS WhatsApp pour les tests est-elle possible dans un pipeline CI ?

Oui, pour vos propres comptes de test. Développez avec le sandbox, puis appelez les routes en direct avec parcimonie, en laissant un délai croissant entre les tentatives.

Les noms de services sont des marques déposées de leurs propriétaires respectifs. OTP Route n'est affilié à aucun d'entre eux. Utilisez les numéros de manière licite et respectez les conditions de chaque service ainsi que notre Politique d'utilisation acceptable.