Connexion API WhatsApp Business : Comment résoudre les problèmes courants

Guide de dépannage pour la configuration de la Coexistence WhatsApp — éligibilité du numéro, restrictions régionales, retards de synchronisation et plus.

W
WhatsTeam23 mars 2026
Connexion API WhatsApp Business : Comment résoudre les problèmes courants

Depannage de WhatsApp Business API : Problemes courants de configuration et solutions

La configuration de WhatsApp Business API avec le mode Coexistence peut parfois presenter des defis. Ce guide de depannage couvre les problemes les plus courants que vous pouvez rencontrer lors du processus d'integration avec WhatsTeam, ainsi que leurs causes profondes et les instructions de resolution etape par etape.

1. Eligibilite du numero de telephone

Symptome du probleme

Pendant le flux Embedded Signup, vous recevez un message d'erreur indiquant que votre numero de telephone n'est pas eligible pour l'enregistrement avec WhatsApp Business API. Le numero est rejete lors de l'etape de verification et vous ne pouvez pas poursuivre le processus d'integration.

Phone number not eligible for WABA registration
Phone number not eligible for WABA registration

Cause profonde

Tous les numeros de telephone ne sont pas eligibles pour l'enregistrement WhatsApp Business API. Les raisons courantes incluent :

  • Le numero de telephone est deja enregistre aupres d'un autre fournisseur WhatsApp Business API (BSP)
  • Le numero de telephone est une ligne fixe qui ne peut pas recevoir de SMS ou d'appels vocaux pour la verification
  • Le numero de telephone a ete precedemment banni ou signale par WhatsApp
  • Le format du numero est incorrect ou inclut des indicatifs de pays invalides
  • Le numero est un numero virtuel provenant d'un fournisseur VoIP non pris en charge

Etapes de resolution

  1. Verifiez le format du numero : Assurez-vous que le numero de telephone est saisi au format international complet, y compris l'indicatif du pays (par exemple, +1 pour les Etats-Unis, +34 pour l'Espagne), sans zeros en tete apres l'indicatif du pays
  2. Verifiez les enregistrements existants : Si le numero etait precedemment enregistre aupres d'un autre BSP, vous devez d'abord le desenregistrer de l'ancien fournisseur avant de l'enregistrer avec WhatsTeam
  3. Utilisez un numero mobile : Pour une experience optimale, utilisez un numero de telephone mobile capable de recevoir des codes de verification par SMS
  4. Essayez la verification vocale : Si la verification par SMS echoue, selectionnez l'option d'appel vocal pour recevoir le code de verification par appel telephonique
  5. Contactez le support : Si le numero a ete precedemment banni ou si vous continuez a rencontrer des problemes, contactez le support WhatsTeam avec les details de votre numero de telephone afin que nous puissions enqueter aupres de Meta

2. Restrictions regionales

Symptome du probleme

Lors de la tentative d'enregistrement de votre numero de telephone, vous voyez une erreur indiquant que votre pays ou region n'est pas pris en charge pour l'enregistrement WhatsApp Business API. Le flux Embedded Signup bloque l'enregistrement a l'etape de saisie du numero de telephone.

Country prefix not supported for WABA
Country prefix not supported for WABA

Cause profonde

WhatsApp Business API n'est pas disponible dans tous les pays et regions. Meta maintient une liste de marches pris en charge, et les numeros de telephone avec des prefixes de pays provenant de regions non prises en charge ne peuvent pas etre enregistres. De plus, certaines sanctions ou restrictions reglementaires peuvent empecher l'acces a l'API dans des pays specifiques.

Etapes de resolution

  1. Verifiez les regions prises en charge : Consultez la liste officielle de Meta des pays pris en charge pour WhatsApp Business API sur la documentation de Meta
  2. Utilisez un numero alternatif : Si votre pays principal n'est pas pris en charge, envisagez d'utiliser un numero de telephone d'une region prise en charge ou votre entreprise est presente
  3. Verifiez l'indicatif du pays : Verifiez que vous saisissez le bon indicatif de pays pour votre numero. Un indicatif de pays incorrect peut declencher une erreur de restriction regionale meme si votre pays reel est pris en charge
  4. Verifiez les ajouts recents : Meta elargit regulierement ses regions prises en charge. Si votre pays a ete recemment ajoute, reessayez ou videz le cache de votre navigateur avant de reessayer
  5. Contactez le support WhatsTeam : Si vous pensez que votre region devrait etre prise en charge mais que vous rencontrez toujours des problemes, contactez notre equipe de support pour obtenir de l'aide

3. Utilisation precedente de WABA

Symptome du probleme

Pendant l'enregistrement, vous recevez une erreur indiquant que votre numero de telephone est deja associe a un WhatsApp Business Account (WABA). Le systeme vous empeche de completer l'enregistrement car le numero a une association API precedente.

Number already verified with another WABA
Number already verified with another WABA

Cause profonde

Un numero de telephone ne peut etre associe qu'a un seul compte WhatsApp Business API a la fois. Si le numero a ete precedemment utilise avec :

  • Un autre BSP (Business Solution Provider)
  • Un autre compte Meta Business Manager
  • Un deploiement auto-heberge de WhatsApp Business API
  • Un compte WhatsTeam precedent qui n'a pas ete correctement desenregistre

Le numero reste verrouille a cette association precedente jusqu'a ce qu'il soit formellement desenregistre.

Etapes de resolution

  1. Identifiez le fournisseur precedent : Determinez quel BSP ou plateforme avait precedemment votre numero enregistre. Verifiez votre compte Meta Business Manager pour toute association WABA existante
  2. Desenregistrez de l'ancien fournisseur : Contactez l'ancien BSP et demandez qu'il desenregistre votre numero de telephone de son compte WhatsApp Business API
  3. Supprimez de Meta Business Manager : Si vous avez acces au Meta Business Manager ou le numero etait enregistre, naviguez vers la section WhatsApp Manager et supprimez le numero de telephone
  4. Attendez la propagation : Apres le desenregistrement, attendez au moins 24 heures avant de tenter d'enregistrer a nouveau le numero. Dans certains cas, cela peut prendre jusqu'a 48 heures pour que le desenregistrement se propage completement
  5. Retentez l'enregistrement : Une fois la periode de desenregistrement passee, redemarrez le flux Embedded Signup dans WhatsTeam et enregistrez a nouveau votre numero
  6. Escaladez si necessaire : Si le numero reste verrouille apres 48 heures, contactez le support WhatsTeam avec une preuve de propriete, et nous escaladerons le probleme directement aupres de Meta

4. Retards de synchronisation

Symptome du probleme

Apres avoir complete l'Embedded Signup et active le mode Coexistence, votre application WhatsApp Business ne reflete pas la connexion API. Les contacts, messages ou informations du profil professionnel ne se synchronisent pas entre l'application WhatsApp Business et l'API. Le statut de Coexistence apparait comme "En attente" pendant une periode prolongee.

Cause profonde

La synchronisation entre l'application WhatsApp Business et Cloud API peut subir des retards en raison de :

  • Problemes de connectivite reseau sur le telephone executant l'application WhatsApp Business
  • Volumes importants de contacts ou messages existants a synchroniser
  • Retards de traitement cote serveur sur l'infrastructure de Meta
  • L'application WhatsApp Business execute une version obsolete
  • Restrictions d'application en arriere-plan sur le telephone empechant la synchronisation

Etapes de resolution

  1. Verifiez la connexion Internet : Assurez-vous que le telephone executant l'application WhatsApp Business dispose d'une connexion Internet stable, de preference en Wi-Fi
  2. Mettez a jour l'application : Assurez-vous d'executer la derniere version de l'application WhatsApp Business depuis l'App Store (iOS) ou le Google Play Store (Android)
  3. Fermez et rouvrez de force : Fermez completement l'application WhatsApp Business et rouvrez-la pour declencher une nouvelle tentative de synchronisation
  4. Desactivez l'optimisation de la batterie : Sur Android, allez dans Parametres > Batterie > Optimisation de la batterie et desactivez-la pour l'application WhatsApp Business. Sur iOS, assurez-vous que l'actualisation en arriere-plan est activee pour l'application
  5. Attendez patiemment : La synchronisation initiale peut prendre jusqu'a 24 heures pour les comptes avec de grandes listes de contacts ou historiques de messages. Accordez suffisamment de temps avant de considerer la synchronisation comme echouee
  6. Redemarrez le telephone : Un redemarrage complet de l'appareil peut resoudre les problemes sous-jacents de connectivite ou de processus
  7. Reactivez la Coexistence : Si la synchronisation echoue toujours apres 24 heures, essayez de desactiver et de reactiver le mode Coexistence via WhatsTeam. Naviguez vers les parametres de l'appareil, desactivez la Coexistence, attendez 5 minutes, puis reactivez-la

5. Problemes de QR code

Symptome du probleme

Pendant la configuration de la Coexistence, il vous est demande de scanner un QR code avec votre application WhatsApp Business, mais le QR code ne se charge pas, a expire, ou l'application ne le reconnait pas. Scanner le QR code resulte en une erreur ou aucune reponse.

Cause profonde

Les problemes de QR code pendant la configuration de la Coexistence surviennent generalement en raison de :

  • Le QR code a expire (les QR codes sont limites dans le temps et doivent etre scannes en quelques minutes)
  • Le cache du navigateur ou de l'application affiche un QR code ancien ou invalide
  • La version de l'application WhatsApp Business ne prend pas en charge le scan de QR code de Coexistence
  • Les permissions de la camera ne sont pas activees pour l'application WhatsApp Business
  • Le QR code est scanne avec la mauvaise application (WhatsApp standard au lieu de WhatsApp Business)

Etapes de resolution

  1. Actualisez le QR code : Cliquez sur le bouton d'actualisation sur l'ecran du QR code dans WhatsTeam pour generer un nouveau QR code valide. Les QR codes expirent apres environ 60 secondes
  2. Videz le cache du navigateur : Videz le cache de votre navigateur ou essayez d'ouvrir le tableau de bord WhatsTeam dans une fenetre de navigation privee pour vous assurer de voir un QR code frais
  3. Mettez a jour l'application WhatsApp Business : Assurez-vous d'executer la derniere version de l'application WhatsApp Business. Les fonctionnalites de Coexistence necessitent la version la plus recente de l'application
  4. Verifiez les permissions de la camera : Sur votre telephone, verifiez que l'application WhatsApp Business a la permission d'acceder a la camera. Allez dans les Parametres de votre telephone > Applications > WhatsApp Business > Permissions > Camera
  5. Utilisez la bonne application : Assurez-vous de scanner le QR code avec l'application WhatsApp Business, pas l'application WhatsApp standard. Le mode Coexistence n'est disponible que sur l'application WhatsApp Business
  6. Essayez un autre appareil : Si la camera de votre appareil principal a des problemes, essayez de scanner le QR code avec un autre appareil qui a le meme compte WhatsApp Business
  7. Verifiez l'eclairage et l'affichage : Assurez-vous que la luminosite de votre ecran d'ordinateur est suffisamment elevee et qu'il n'y a pas de reflet sur l'ecran pouvant interferer avec le scan du QR code

6. Erreurs de connexion de la page Facebook

Symptome du probleme

Pendant le flux Embedded Signup, vous rencontrez une erreur en essayant de connecter votre WhatsApp Business Account a une page Facebook Business. Le systeme n'affiche aucune page disponible, affiche une erreur de permissions, ou ne parvient pas a etablir la connexion entre votre WABA et la page Facebook.

Cause profonde

Les erreurs de connexion de page Facebook surviennent generalement en raison de :

  • Vous n'avez pas d'acces administrateur a la page Facebook que vous essayez de connecter
  • La page Facebook est deja connectee a un autre WhatsApp Business Account
  • Votre Meta Business Manager n'a pas la propriete de la page Facebook
  • Il y a une incoherence entre le Meta Business Manager utilise pour le WABA et celui qui gere la page Facebook
  • La page Facebook a des restrictions ou a ete depubliee

Etapes de resolution

  1. Verifiez l'acces administrateur a la page : Confirmez que votre compte Facebook a un acces de niveau administrateur a la page que vous souhaitez connecter. Allez sur la page Facebook > Parametres > Roles de la page pour verifier
  2. Verifiez les connexions existantes : Dans Meta Business Manager, naviguez vers Parametres de l'entreprise > Comptes > Comptes WhatsApp pour voir si la page est deja liee a un autre WABA. Deconnectez-la de l'autre compte d'abord
  3. Utilisez le bon Business Manager : Assurez-vous d'etre connecte au meme compte Meta Business Manager qui possede a la fois la page Facebook et le WABA que vous configurez
  4. Revendiquez la page : Si la page ne fait pas encore partie de votre Meta Business Manager, allez dans Parametres de l'entreprise > Comptes > Pages > Ajouter et revendiquez la propriete de la page
  5. Creez une nouvelle page : Si vous ne pouvez pas resoudre les permissions sur une page existante, creez une nouvelle page Facebook Business via Meta Business Manager et utilisez-la pour votre connexion WABA
  6. Verifiez le statut de la page : Assurez-vous que la page Facebook est publiee et non restreinte. Les pages depubliees ou restreintes ne peuvent pas etre connectees au WABA
  7. Contactez le support Meta : Si aucune des etapes ci-dessus ne resout le probleme, contactez le support Meta Business via votre Meta Business Manager pour obtenir de l'aide avec les problemes de connexion de page

7. Desactivation de la Coexistence

Symptome du probleme

Vous souhaitez desactiver le mode Coexistence pour utiliser WhatsApp Business API independamment (sans l'application WhatsApp Business connectee), mais l'option de desactivation est grisee, produit une erreur, ou le processus ne se termine pas correctement.

Cause profonde

La desactivation de la Coexistence peut echouer en raison de :

  • Il y a des conversations actives ou des messages en attente traites via l'application WhatsApp Business
  • L'application WhatsApp Business n'a pas ete correctement deconnectee du telephone
  • Un verrouillage au niveau du systeme est en place pendant que la synchronisation est encore en cours
  • Permissions insuffisantes dans WhatsTeam pour modifier les parametres de l'appareil
  • Limites de taux API ou restrictions de service temporaires de Meta

Etapes de resolution

  1. Completez les synchronisations en attente : Assurez-vous que toute la synchronisation des messages entre l'application WhatsApp Business et l'API est terminee avant de tenter de desactiver la Coexistence
  2. Verifiez les permissions : Verifiez que votre compte WhatsTeam a un acces de niveau administrateur aux parametres de l'appareil. Seuls les utilisateurs administrateurs peuvent activer ou desactiver le mode Coexistence
  3. Deconnectez d'abord l'application : Sur votre telephone, ouvrez l'application WhatsApp Business et dissociez tous les appareils connectes avant de desactiver la Coexistence dans WhatsTeam
  4. Attendez et reessayez : Si le systeme affiche une synchronisation en cours, attendez au moins 30 minutes avant de reessayer. Tenter de desactiver pendant une synchronisation active peut provoquer des erreurs
  5. Effacez la session : Dans WhatsTeam, allez dans les parametres de l'appareil et effacez toutes les sessions actives avant de desactiver la Coexistence
  6. Contactez le support : Si l'option de desactivation reste indisponible ou continue a produire des erreurs, contactez le support WhatsTeam. Dans certains cas, la Coexistence peut necessiter une desactivation depuis le backend de Meta, ce qui necessite que notre equipe se coordonne avec Meta

8. Incompatibilite des appareils compagnons

Symptome du probleme

Apres avoir active le mode Coexistence, vous tentez d'utiliser l'application WhatsApp Business sur un appareil compagnon (tel qu'une tablette ou un telephone secondaire), mais l'appareil compagnon ne peut pas se connecter, affiche des erreurs, ou ne recoit pas les messages correctement.

Cause profonde

Le mode Coexistence a des limitations specifiques concernant les appareils compagnons :

  • La prise en charge des appareils compagnons de l'application WhatsApp Business est limitee a certains types d'appareils et versions de systeme d'exploitation
  • L'appareil principal doit rester connecte et actif pour que les appareils compagnons fonctionnent
  • Il y a un nombre maximum d'appareils compagnons autorises (generalement 4)
  • Certaines fonctionnalites des appareils compagnons peuvent ne pas etre entierement compatibles avec le mode Coexistence
  • L'appareil compagnon peut executer une version obsolete de l'application WhatsApp Business

Etapes de resolution

  1. Verifiez la compatibilite de l'appareil : Assurez-vous que votre appareil compagnon repond aux exigences minimales de WhatsApp. Pour Android, la version 5.0 ou ulterieure est requise. Pour iOS, la version 15.1 ou ulterieure est requise
  2. Mettez a jour tous les appareils : Assurez-vous que le telephone principal et l'appareil compagnon executent la derniere version de l'application WhatsApp Business
  3. Gardez l'appareil principal en ligne : Le telephone principal doit rester connecte a Internet pour que les appareils compagnons fonctionnent. Si l'appareil principal se deconnecte pendant plus de 14 jours, les appareils compagnons seront deconnectes
  4. Verifiez les limites des appareils compagnons : WhatsApp autorise jusqu'a 4 appareils compagnons. Si vous avez atteint la limite, dissociez un appareil compagnon existant avant d'en ajouter un nouveau
  5. Reassociez l'appareil compagnon : Supprimez l'appareil compagnon de l'application WhatsApp Business (Parametres > Appareils lies) et configurez-le a nouveau en scannant le QR code depuis l'appareil principal
  6. Verifiez la compatibilite de la Coexistence : Certaines fonctionnalites des appareils compagnons peuvent avoir des fonctionnalites limitees en mode Coexistence. Consultez la documentation de WhatsTeam pour les dernieres informations de compatibilite
  7. Testez sans Coexistence : Desactivez temporairement la Coexistence pour determiner si le probleme de l'appareil compagnon est lie specifiquement a la Coexistence ou s'il s'agit d'un probleme general de connectivite WhatsApp

9. Changements de nom apres l'integration

Symptome du probleme

Apres avoir complete le processus d'integration WhatsApp Business API, vous souhaitez changer le nom d'affichage de votre entreprise mais le changement est rejete par Meta, prend un temps prolonge a traiter, ou n'apparait pas sur votre profil WhatsApp.

Cause profonde

Les changements de nom d'affichage WhatsApp Business API sont soumis au processus d'examen et d'approbation de Meta :

  • Meta applique des directives strictes en matiere de noms pour les noms d'affichage professionnels
  • Les changements de nom necessitent un nouvel examen et une approbation, ce qui peut prendre jusqu'a 72 heures
  • Les noms qui violent les politiques de denomination de Meta seront rejetes
  • Les changements de nom frequents peuvent declencher un examen supplementaire ou des retards
  • Le nom d'affichage doit correspondre au nom de l'entreprise associe a votre Meta Business Manager

Etapes de resolution

  1. Consultez les directives de denomination : Avant de soumettre un changement de nom, consultez les directives de nom d'affichage de Meta. Les noms doivent representer votre entreprise avec precision et ne peuvent pas inclure :
    • Des termes generiques sans le nom de votre entreprise
    • Toutes les lettres en majuscules (sauf s'il s'agit d'un acronyme)
    • Des noms trompeurs ou mensongers
    • Des noms personnels (sauf si l'entreprise porte le nom d'une personne)
    • Une ponctuation ou des caracteres speciaux excessifs
  2. Soumettez via WhatsTeam : Naviguez vers les parametres de votre appareil dans WhatsTeam et mettez a jour le nom d'affichage professionnel. Le changement sera soumis a Meta pour examen
  3. Attendez l'approbation : Les changements de nom prennent generalement 24 a 72 heures pour que Meta les examine. Ne soumettez pas plusieurs demandes de changement pendant cette periode, car cela pourrait retarder davantage l'examen
  4. Verifiez les informations de l'entreprise : Assurez-vous que les informations de votre Meta Business Manager correspondent au nom d'affichage que vous demandez. Les divergences entre l'enregistrement de votre entreprise et le nom d'affichage peuvent provoquer des rejets
  5. Fournissez des documents justificatifs : Si votre changement de nom est rejete, vous devrez peut-etre fournir des documents supplementaires tels que des certificats d'enregistrement d'entreprise, des enregistrements de marques ou des preuves de propriete de domaine
  6. Utilisez un nom alternatif : Si votre nom prefere continue d'etre rejete, envisagez des variantes qui representent toujours votre entreprise tout en respectant les directives de Meta
  7. Contactez le support : Si votre changement de nom est en attente depuis plus de 72 heures ou a ete rejete sans raison claire, contactez le support WhatsTeam et nous escaladerons l'examen aupres de Meta

Obtenir une aide supplementaire

Si vous continuez a rencontrer des problemes qui ne sont pas couverts dans ce guide de depannage :

  • Support WhatsTeam : Contactez notre equipe de support via le chat en direct de la plateforme ou par email
  • Centre d'aide Meta Business : Visitez le support Meta Business pour les problemes specifiques a WhatsApp
  • Documentation WhatsApp Business API : Consultez la documentation API officielle pour les details techniques
  • Forums communautaires : Rejoignez la communaute WhatsTeam pour echanger avec d'autres utilisateurs qui ont peut-etre rencontre des problemes similaires

Articles Connexes

Prêt à commencer ?

Essayez WhatsTeam gratuitement