Problemes courants lors de l'inscription WhatsApp : Guide de depannage
Resume
La configuration de WhatsApp Business API via WhatsTeam devrait etre un processus simple, mais certaines situations peuvent causer des complications lors de l'inscription. Que votre numero soit deja connecte a un autre fournisseur de solutions commerciales (BSP), enregistre sur un compte WhatsApp personnel, ou lie a un autre portefeuille Meta, chaque scenario necessite un parcours de resolution specifique.
Ce guide complet vous accompagne a travers les problemes les plus courants rencontres lors de l'inscription WhatsApp et fournit des instructions claires, etape par etape, pour les resoudre afin que votre entreprise puisse etre operationnelle sur WhatsTeam le plus rapidement possible.
Liste de verification pre-integration
Avant de commencer le processus d'inscription WhatsApp sur WhatsTeam, assurez-vous d'avoir les elements suivants prets. Completer cette liste de verification au prealable vous fera gagner du temps et previendra les blocages les plus courants.

- Un numero de telephone valide : Ce numero doit pouvoir recevoir des SMS ou des appels vocaux pour la verification. Il ne devrait pas actuellement etre actif sur l'application mobile WhatsApp standard ou WhatsApp Business, sauf si vous prevoyez de le migrer.
- Un Meta Business Account : Vous avez besoin d'un Meta Business Account actif (anciennement Facebook Business Manager). Si vous n'en avez pas, il sera cree pendant le flux Embedded Signup.
- Documents de verification de l'entreprise : Preparez vos documents juridiques d'entreprise tels que les certificats d'enregistrement d'entreprise, les numeros d'identification fiscale ou les statuts constitutifs.
- Acces administrateur a Meta Business Suite : Si vous avez deja un Meta Business Account, assurez-vous d'avoir les permissions de niveau administrateur.
- Authentification a deux facteurs (2FA) desactivee : Si le numero de telephone est actuellement utilise sur une application mobile WhatsApp, desactivez la 2FA dans les parametres de l'application avant de continuer.
- Exigences du navigateur : Utilisez un navigateur moderne (Chrome, Firefox, Edge) avec les pop-ups activees pour le flux de connexion Meta.

Conseil : Avoir tous ces elements prepares avant de commencer reduira considerablement la probabilite de rencontrer des erreurs pendant le processus d'inscription.
Numero connecte a une autre plateforme professionnelle
L'un des problemes les plus frequents se produit lorsque votre numero de telephone est deja enregistre aupres d'un autre fournisseur de solutions commerciales WhatsApp (BSP). WhatsApp applique une politique stricte d'un seul fournisseur par numero, ce qui signifie qu'un seul numero de telephone ne peut etre actif que sur un seul BSP a un moment donne.

Vous verrez generalement l'un des messages d'erreur suivants lors de l'inscription :
- "Ce numero est enregistre sur un compte WhatsApp existant"
- "Impossible de migrer le numero de telephone. Le compte WhatsApp auquel ce numero est enregistre n'est pas configure correctement."
- "Le numero de telephone est deja utilise par un autre client WhatsApp Business API"
Pourquoi cela se produit
Cette situation survient lorsque :
- Votre numero etait precedemment connecte a un autre BSP (comme Twilio, MessageBird, ou 360dialog) et n'a jamais ete formellement deconnecte.
- Votre numero est toujours actif sur l'application mobile WhatsApp Business.
- Un ancien employe ou une agence a configure le numero sur une plateforme differente a votre insu.

Apercu de la resolution
La resolution depend de votre configuration actuelle. Vous avez deux parcours principaux :
- Parcours Cloud API : Deconnectez completement le numero du fournisseur actuel et re-enregistrez-le sur WhatsTeam.
- Parcours Coexistence : Si vous souhaitez garder votre numero actif sur l'application mobile WhatsApp Business tout en l'utilisant egalement via l'API de WhatsTeam.
Les deux parcours sont decrits en detail dans les sections suivantes.
Changer de BSP
Si votre numero est actuellement gere par un autre BSP et que vous souhaitez le transferer vers WhatsTeam, vous devez effectuer une migration formelle. Ce processus implique une coordination entre votre fournisseur actuel, Meta et WhatsTeam.

Avant de changer
- Informez votre BSP actuel : Certains fournisseurs necessitent un preavis avant de liberer un numero. Consultez leur documentation ou contactez leur equipe de support.
- Exportez vos modeles : Les modeles de messages WhatsApp sont lies au WhatsApp Business Account (WABA), pas au BSP. Si vous passez a un nouveau WABA, vous devrez recreer vos modeles.
- Notez vos limites de messagerie : Votre niveau de messagerie actuel (1K, 10K, 100K ou illimite) peut ou non etre transfere selon que vous conservez ou non le meme WABA.
- Sauvegardez les donnees de conversation : Les conversations actives et l'historique des discussions sont geres par le BSP. Exportez toutes les donnees dont vous avez besoin avant d'initier le changement.
Migration vs nouveau depart
| Facteur | Migration (meme WABA) | Nouveau depart (nouveau WABA) |
|---|
| Modeles | Preserves | A recreer |
| Limite de messagerie | Preservee | Recommence a 1K/jour |
| Note de qualite | Preservee | Recommence a zero |
| Nom d'affichage | Preserve | A re-approuver |
| Temps d'arret | Minutes | Minutes a heures |

Recommandation : Dans la mesure du possible, migrez en utilisant le meme WABA pour preserver vos limites de messagerie et vos approbations de modeles. C'est particulierement important pour les entreprises avec des volumes de messages quotidiens eleves.
Supprimer le numero du compte WhatsApp actuel
Avant de pouvoir enregistrer votre numero sur WhatsTeam, vous devez le supprimer de son compte WhatsApp actuel. Le processus differe selon que votre numero est sur Cloud API ou que vous prevoyez d'utiliser le mode Coexistence.
Parcours Cloud API
Le parcours Cloud API consiste a supprimer completement le numero de son enregistrement WhatsApp actuel afin qu'il puisse etre enregistre a nouveau sur WhatsTeam.

Etape 1 : Acceder a Meta Business Suite
- Allez sur business.facebook.com et connectez-vous avec votre compte administrateur.
- Naviguez vers Parametres dans la barre laterale gauche.
- Cliquez sur Comptes WhatsApp dans le menu Parametres de l'entreprise.

Etape 2 : Localiser votre numero de telephone
- Selectionnez le WhatsApp Business Account qui contient votre numero de telephone.
- Cliquez sur l'onglet Numeros de telephone.
- Trouvez le numero que vous souhaitez supprimer de ce compte.

Etape 3 : Supprimer le numero de telephone
- Cliquez sur le numero de telephone pour le selectionner.
- Cliquez sur le bouton Supprimer (icone de corbeille) a cote du numero.
- Confirmez la suppression lorsque vous y etes invite.
- Attendez au moins 5 minutes pour que les systemes de Meta traitent completement la suppression.

Avertissement : La suppression d'un numero de telephone d'un WABA est permanente. Tout l'historique des messages, les conversations actives et les messages en attente associes a ce numero seront perdus. Assurez-vous d'avoir exporte toutes les donnees necessaires avant de continuer.
Etape 4 : Verifier que le numero est libere
- Retournez a l'onglet Numeros de telephone.
- Confirmez que le numero n'apparait plus dans la liste.
- Si le numero apparait toujours, attendez quelques minutes supplementaires et actualisez la page.

Etape 5 : Effacer l'application mobile WhatsApp (si applicable)
Si le numero etait egalement utilise sur l'application mobile WhatsApp ou WhatsApp Business :
- Ouvrez l'application WhatsApp sur votre telephone.
- Allez dans Parametres > Compte > Supprimer mon compte.
- Entrez votre numero de telephone et confirmez la suppression.
- Desinstallez l'application pour empecher la re-inscription automatique.

Parcours Coexistence
Le parcours Coexistence vous permet de continuer a utiliser l'application mobile WhatsApp Business sur votre telephone tout en connectant simultanement le meme numero a WhatsTeam via Cloud API. C'est ideal pour les entreprises qui souhaitent maintenir leur presence WhatsApp existante tout en beneficiant des capacites API.

Etape 1 : Assurez-vous d'utiliser l'application WhatsApp Business
La Coexistence ne fonctionne qu'avec l'application WhatsApp Business (icone verte avec un "B"), pas l'application WhatsApp grand public standard. Si vous utilisez l'application WhatsApp standard, vous devez d'abord migrer vers l'application WhatsApp Business.

Etape 2 : Desactiver les fonctionnalites de reponse automatique
Avant de vous connecter via la Coexistence, desactivez toutes les fonctionnalites de reponse automatique dans votre application WhatsApp Business :
- Ouvrez l'application WhatsApp Business.
- Allez dans Parametres > Outils professionnels > Message d'absence et desactivez-le.
- Allez dans Parametres > Outils professionnels > Message d'accueil et desactivez-le.
- Allez dans Parametres > Outils professionnels > Reponses rapides et passez-les en revue (elles peuvent rester actives mais sachez qu'elles peuvent entrer en conflit avec les automatisations API).
Etape 3 : Ne supprimez pas le numero
Contrairement au parcours Cloud API, vous ne devez pas supprimer le numero de l'application mobile. Le numero reste actif sur l'application pendant que vous le connectez a WhatsTeam via le processus Embedded Signup.
Etape 4 : Proceder a l'inscription WhatsTeam
Avec l'application mobile toujours active, procedez au processus d'inscription WhatsTeam. Pendant l'Embedded Signup, selectionnez l'option Coexistence lorsque vous y etes invite. Les etapes detaillees de ce processus sont couvertes dans notre guide Coexistence dedie.

Creer un nouveau compte WhatsApp
Si vous partez de zero ou que votre compte precedent ne peut pas etre recupere, vous devrez creer un nouveau WhatsApp Business Account. Il existe deux methodes principales pour le faire via WhatsTeam.
Embedded Sign-Up via WhatsTeam
Le flux Embedded Signup (ES) est la methode la plus rapide et la plus recommandee. Il cree votre Meta Business Account et votre WhatsApp Business Account dans un processus unique et simplifie directement au sein de la plateforme WhatsTeam.

Etape 1 : Naviguer vers les parametres WhatsTeam
- Connectez-vous a votre compte WhatsTeam sur whats.team.
- Allez dans Parametres > Connexions WhatsApp.
- Cliquez sur le bouton Connecter un nouveau numero.
Etape 2 : Demarrer l'Embedded Signup
- Une fenetre de connexion Meta apparaitra.
- Connectez-vous avec vos identifiants de compte Facebook.
- Si vous n'avez pas de Meta Business Account, un sera cree automatiquement pendant ce processus.

Etape 3 : Creer ou selectionner un portefeuille d'entreprise
- Choisissez Creer un nouveau portefeuille d'entreprise si c'est votre premiere fois, ou selectionnez-en un existant dans le menu deroulant.
- Entrez le nom de votre entreprise exactement tel qu'il apparait sur vos documents juridiques.
- Cliquez sur Continuer.

Etape 4 : Creer un WhatsApp Business Account
- Choisissez Creer un nouveau WhatsApp Business Account.
- Entrez un nom d'affichage pour votre entreprise (c'est ce que les clients verront).
- Selectionnez la categorie de votre entreprise dans le menu deroulant.
- Cliquez sur Continuer.
Etape 5 : Ajouter votre numero de telephone
- Entrez le numero de telephone que vous souhaitez enregistrer.
- Selectionnez votre methode de verification preferee : SMS ou Appel vocal.
- Entrez le code de verification lorsque vous le recevez.
- Cliquez sur Verifier.

Etape 6 : Completer la configuration
- Passez en revue toutes les informations que vous avez fournies.
- Acceptez les conditions generales.
- Cliquez sur Terminer la configuration.
- Vous serez redirige vers le tableau de bord WhatsTeam ou votre nouvelle connexion apparaitra.

Via le portefeuille Meta Business
Si vous preferez creer votre WhatsApp Business Account directement via Meta avant de vous connecter a WhatsTeam, vous pouvez le faire via Meta Business Suite.

Etape 1 : Acceder a Meta Business Suite
- Allez sur business.facebook.com.
- Connectez-vous avec votre compte administrateur Facebook.
- Naviguez vers Parametres > Parametres de l'entreprise.
Etape 2 : Creer un WhatsApp Business Account
- Dans la barre laterale gauche, cliquez sur Comptes > Comptes WhatsApp.
- Cliquez sur le bouton Ajouter.
- Remplissez les details requis : nom du compte, devise et fuseau horaire.
- Cliquez sur Creer.

Etape 3 : Ajouter un numero de telephone
- Dans votre nouveau WABA, allez dans l'onglet Numeros de telephone.
- Cliquez sur Ajouter un numero de telephone.
- Entrez le numero et verifiez-le par SMS ou appel vocal.
Etape 4 : Partager l'acces avec WhatsTeam
- Dans les parametres de votre WABA, allez dans la section Partenaire ou Fournisseur de solution.
- Ajoutez WhatsTeam comme fournisseur de solution en utilisant l'identifiant Business Manager de WhatsTeam.
- Accordez les permissions requises (gerer les numeros de telephone, gerer les modeles, envoyer des messages).
Etape 5 : Connecter dans WhatsTeam
- Retournez au tableau de bord WhatsTeam.
- Allez dans Parametres > Connexions WhatsApp.
- Cliquez sur Connecter un compte existant.
- Selectionnez le WABA que vous venez de creer dans la liste.

Lier le WhatsApp Business Account au portefeuille (Coexistence)
Lorsque vous utilisez le mode Coexistence, vous devrez peut-etre lier votre WhatsApp Business Account a un portefeuille Meta Business specifique. Cette etape garantit que le WABA est correctement associe a votre identite professionnelle et que la facturation, les permissions et la conformite sont correctement configurees.

Quand est-ce necessaire ?
- Vous avez cree un WABA via l'Embedded Signup et devez l'assigner a un portefeuille different.
- Vous configurez la Coexistence et Meta exige que le WABA soit sous un portefeuille verifie.
- Votre entreprise a plusieurs portefeuilles et vous devez consolider vos comptes WhatsApp.
- Ouvrez Meta Business Suite et allez dans Parametres de l'entreprise.
- Naviguez vers Comptes > Comptes WhatsApp.
- Selectionnez le WABA que vous souhaitez lier.
- Cliquez sur Assigner un partenaire ou Ajouter des personnes/partenaires.
- Entrez l'identifiant du portefeuille d'entreprise ou vous souhaitez que le WABA reside.
- Confirmez l'assignation et attendez que Meta traite le changement (cela peut prendre jusqu'a 24 heures).

Verifier la liaison
Apres la liaison, verifiez que :
- Le WABA apparait sous le bon portefeuille dans les parametres Meta Business.
- Tous les numeros de telephone dans le WABA sont visibles et actifs.
- Les approbations de modeles et les limites de messagerie sont intactes.
- WhatsTeam peut toujours acceder au WABA via la connexion.

Enregistrer a nouveau le numero sous un nouveau compte
Dans certains cas, vous devrez peut-etre enregistrer un numero de telephone qui a ete precedemment utilise sur un autre compte WhatsApp. Ce processus necessite une execution soignee pour eviter les erreurs.

Prerequis
Avant de tenter de re-enregistrer un numero :
- Assurez-vous que le numero est completement supprime de tout compte WhatsApp precedent (Cloud API, On-Premises API ou application mobile).
- Attendez la periode de refroidissement requise. Apres la suppression, Meta impose une periode d'attente qui peut aller de quelques minutes a 24 heures selon l'historique du compte.
- Verifiez la propriete du numero. Vous devez pouvoir recevoir des SMS ou des appels vocaux sur le numero pendant l'etape de verification.
Re-enregistrement etape par etape
Etape 1 : Confirmer la suppression
Allez dans Meta Business Suite et verifiez que le numero n'apparait sous aucun WhatsApp Business Account. S'il apparait toujours, completez le processus de suppression decrit plus haut dans ce guide.

Etape 2 : Initier une nouvelle inscription sur WhatsTeam
- Connectez-vous a votre compte WhatsTeam.
- Naviguez vers Parametres > Connexions WhatsApp.
- Cliquez sur Connecter un nouveau numero.
- Suivez le flux Embedded Signup comme decrit dans la section "Creer un nouveau compte WhatsApp" ci-dessus.
Etape 3 : Verifier le numero
- Lorsque vous y etes invite, entrez le numero de telephone.
- Selectionnez SMS ou Appel vocal pour la verification.
- Entrez le code OTP que vous recevez.
- Si le code n'arrive pas, attendez 60 secondes et essayez la methode de verification alternative.

Etape 4 : Confirmer l'enregistrement reussi
- Apres la verification, le numero devrait apparaitre dans votre tableau de bord WhatsTeam avec un statut Actif.
- Envoyez un message de test pour confirmer que la connexion fonctionne correctement.
- Si l'enregistrement echoue avec une erreur indiquant que le numero est toujours utilise, attendez 30 minutes supplementaires et reessayez.

Questions frequentes
Combien de temps faut-il pour liberer un numero d'un autre BSP ?
Le processus de liberation est generalement instantane une fois que vous supprimez le numero du WABA precedent. Cependant, dans certains cas, les systemes de Meta peuvent prendre jusqu'a 24 heures pour propager completement le changement. Si vous rencontrez toujours des problemes apres 24 heures, contactez le support WhatsTeam a support@whats.team.
Puis-je utiliser le meme numero a la fois sur l'application WhatsApp Business et Cloud API ?
Oui, c'est exactement ce que le mode Coexistence permet. Vous pouvez continuer a utiliser l'application mobile WhatsApp Business tout en envoyant et recevant des messages via l'API de WhatsTeam. Cependant, il existe certaines limitations de fonctionnalites en mode Coexistence. Consultez notre guide Coexistence dedie pour les details complets.
Que se passe-t-il pour mes modeles de messages lorsque je change de BSP ?
Si vous conservez le meme WABA, vos modeles approuves seront preserves. Si vous creez un nouveau WABA, vous devrez soumettre a nouveau tous les modeles pour approbation, ce qui peut prendre jusqu'a 24 heures par modele.
Vais-je perdre mon niveau de limite de messagerie lors du re-enregistrement ?
Si vous supprimez un numero d'un WABA et l'enregistrez sous un nouveau WABA, votre limite de messagerie se reinitialise au niveau par defaut (generalement 1 000 conversations initiees par l'entreprise par 24 heures). Pour preserver votre niveau de messagerie, migrez le numero au sein du meme WABA dans la mesure du possible.
Je continue a recevoir "Le code n'a pas pu etre envoye" pendant la verification. Que dois-je faire ?
Cette erreur indique generalement un probleme temporaire avec le service de verification de Meta. Essayez les solutions suivantes :
- Attendez 5 a 10 minutes et reessayez.
- Alternez entre les methodes de verification SMS et appel vocal.
- Assurez-vous que le numero n'est pas sur un service VoIP qui bloque les codes courts.
- Verifiez la console developpeur de votre navigateur pour des details d'erreur supplementaires.
- Si le probleme persiste, contactez le support WhatsTeam avec les logs de votre console navigateur.
Mon numero affiche "En attente" apres l'inscription. Est-ce normal ?
Oui, un bref statut "En attente" est normal pendant que Meta traite l'enregistrement. Cela se resout generalement en 5 a 15 minutes. Si le statut reste "En attente" pendant plus d'une heure, essayez d'actualiser votre connexion dans le tableau de bord WhatsTeam ou contactez le support.