Passer au contenu principal

Dépannage des erreurs WhatsApp

Écrit par Eric Fitzgerald

Erreurs d'intégration et de configuration

Ce numéro est enregistré sur un compte WhatsApp existant

Cette erreur apparaît lorsque le numéro de téléphone a été utilisé auparavant avec un autre fournisseur WhatsApp Business API ou avec l'application mobile/business WhatsApp. Si le numéro a été utilisé dans l'application WhatsApp standard, vous devez le déconnecter avant de le connecter à Intercom.

Si utilisé avec un autre fournisseur API :
Suivez le processus d'intégration pour migrer un numéro de téléphone WhatsApp existant, puis quittez l'intégration intégrée après l'étape 2.

Si utilisé avec une application mobile WhatsApp :
Suivez les étapes sous le lien En savoir plus affiché dans l'erreur pour déconnecter le numéro de ce compte WhatsApp, puis vous devriez pouvoir réessayer notre processus d'intégration avec succès.

Note : La déconnexion d'un compte WhatsApp supprime l'historique des discussions sauf s'il est sauvegardé.

Si aucune des conditions ne s'applique, contactez le support avec vos :

  • ID du compte WhatsApp

  • Numéro de téléphone

Nous pouvons tenter une connexion manuelle.


Le code n'a pas pu être envoyé

Vérifiez la console de votre navigateur pour plus de détails.

Si cela s'est produit lors de la migration :
La migration a peut-être déjà réussi. Essayez d'utiliser le flux « J'intègre WhatsApp pour la première fois » et sélectionnez les comptes nouvellement créés.

Astuce : Cette erreur se résout souvent en passant simplement par le chemin de configuration initiale.

Si cela échoue toujours, contactez le support.


Erreur 500 dans la console lors de l'inscription

Si vous ne pouvez pas enregistrer les paramètres de votre profil professionnel et recevez une erreur 500 dans la console de votre navigateur, il s'agit probablement d'une erreur de validation renvoyée par WhatsApp sur le paramètre de profil que vous essayez de mettre à jour. Vous trouverez des détails sur les restrictions telles que le nombre maximum de caractères ici.


Impossible de migrer le numéro de téléphone

Erreur complète : « Impossible de migrer le numéro de téléphone. Le compte WhatsApp auquel ce numéro est enregistré n'est pas configuré correctement ».

Vérifiez :

  1. Le numéro de téléphone est entièrement vérifié dans Meta.

  2. Il n'est pas encore connecté à l'application WhatsApp Business.

Si les deux vérifications échouent : Envoyer au support une capture d'écran du numéro vérifié dans Business Manager aide à accélérer la résolution.

Fournissez au support vos :

  • Capture d'écran vérifiée

  • Numéro de téléphone

  • ID WABA


Accès au compte WhatsApp Business non partagé

Contactez le support client Intercom pour obtenir de l'aide avec cette erreur.


Impossible de créer le certificat. Veuillez vous assurer que l'authentification à deux facteurs est désactivée

Assurez-vous que votre numéro WhatsApp est connecté sur la page d'installation.

Note : L'authentification à deux facteurs doit être désactivée dans WhatsApp pour la création du certificat.


Veuillez vous assurer d'autoriser pleinement l'accès à votre compte WhatsApp Business

Vérifiez que le numéro de téléphone est entièrement approuvé dans Meta.

Conseil : Les délais entre l'approbation Meta et la synchronisation Intercom peuvent parfois causer cela temporairement. Attendez quelques minutes et réessayez.


Veuillez réessayer dans un moment ou contactez le support pour résoudre le problème

Cela se produit généralement en raison de mots restreints ou interdits dans les champs titre ou description.

Note : Meta applique strictement les règles de nommage. Évitez les termes politiques, médicaux ou sensibles. Ce post des développeurs Facebook vaut la peine d'être consulté.


Le WABA saisi (ID xxxx) utilise déjà une méthode de paiement

Cela se produit souvent pour les numéros fournis par des prestataires tiers. Essayez à nouveau les étapes d'intégration de la migration. Si cela échoue, contactez le support Intercom.


Nous ne pouvons pas vérifier le compte Meta Business que vous avez sélectionné…

Cette erreur doit être résolue par Meta Support et ne peut pas être corrigée dans Intercom.


Requête get non prise en charge

Erreur complète : « Requête get non prise en charge. L'objet avec l'ID XXXXXXXXXXXX n'existe pas, ne peut pas être chargé en raison de permissions manquantes, ou ne supporte pas cette opération »

Lorsque vous essayez de connecter un numéro, assurez-vous que le code qui vous est montré est un ID de compte WhatsApp.

Conseil : Les ID de compte WhatsApp diffèrent des ID de Business Manager — vérifiez bien celui que vous saisissez. Vous pouvez les trouver ici.


Code d'erreur (#100) Paramètre invalide

Cela est généralement signalé par Meta en raison d'une erreur de migration de téléphone. Consultez les docs Meta pour plus de détails.

De plus, si vous rencontrez l'erreur suivante : Type : OAuthException Code : 1 Error_subcode : 23881 Message : Paramètre invalide Error_user_title : Impossible de créer le certificat Error_user_msg : Votre entreprise ne répond pas aux exigences de la politique WhatsApp. Si vous pensez que votre entreprise est éligible, contactez le support Meta Business Suite. La documentation officielle est disponible ici.

Si vous rencontrez un message d'erreur comme « (#1) Erreur de paramètre » lors de la connexion de votre numéro WhatsApp : Prenez une capture d'écran du message d'erreur. Souvent, la résolution nécessite le support Meta. Vérifiez que tous les paramètres dans Meta et Intercom sont correctement configurés avant de contacter le support.


Erreurs OAuthException

Exemples :

  • Type : OAuthException

  • Code : 1

  • Error_subcode : 23881

  • « Impossible de créer le certificat »

  • « Votre entreprise ne répond pas aux exigences de la politique WhatsApp »

Ces erreurs indiquent que votre entreprise peut ne pas répondre aux normes de politique WhatsApp. Si vous pensez que votre entreprise est éligible, contactez le support Meta Business Suite. La documentation officielle est disponible ici.


« (#1) Erreur de paramètre » lors de la connexion de votre numéro

Prenez une capture d'écran et vérifiez vos paramètres. La plupart des erreurs de paramètre proviennent de Meta et doivent être résolues via le support Meta.


« Message non envoyé en raison d'un nombre incorrect de paramètres. Assurez-vous que tous les paramètres du modèle sont remplis, puis réessayez. »

Ce message d'erreur signifie que le nombre de valeurs de paramètres variables que vous avez inclus dans votre demande de message WhatsApp ne correspond pas au nombre de paramètres variables définis dans votre modèle WhatsApp. Vous devez modifier votre modèle et ajouter des valeurs pour toutes les variables.


Erreur de connexion au compte WhatsApp : code : 1, error_subcode : 99, message : Une erreur inconnue est survenue [HTTP 500]

Suivez ces étapes :

  1. Allez dans les paramètres de l'application WhatsApp.

  2. Choisissez « Je migre depuis un WhatsApp existant… »

  3. Sélectionnez Créer un nouveau compte WhatsApp Business.

  4. Fermez la fenêtre contextuelle après la création du compte WhatsApp Business mais avant d'ajouter le numéro de téléphone.

  5. Vous serez invité dans Intercom à saisir l'ID du nouveau compte WhatsApp Business que vous avez créé - vous pouvez le trouver dans votre compte WhatsApp Business.

  6. Vous pouvez ensuite continuer à suivre les instructions dans notre article d'aide pour compléter le processus de migration.

Note : Fermer la fenêtre contextuelle au bon moment est essentiel pour éviter cette erreur. Voici la fenêtre que vous devez fermer 👇


Action en attente requise chez Meta

Si vous voyez l'erreur :

« Votre compte professionnel a une action en attente, vous devez la compléter avant d'envoyer »

Cela signifie que Meta (WhatsApp Business Manager) bloque l'envoi de messages car votre compte WhatsApp Business (WABA) ou la configuration du numéro de téléphone n'est pas entièrement terminée/vérifiée du côté de Meta.

Dans ce cas, veuillez vous rendre dans vos paramètres Meta pour vérifier les prochaines étapes requises.


Problèmes de modèles de messages WhatsApp

Modèles n'apparaissant pas dans Intercom

Vérifiez :

  • Le modèle contient uniquement du texte brut ou des boutons de réponse rapide.

  • Pas de média ni de variables non prises en charge.

  • Le modèle est entièrement approuvé par Meta.

  • La langue correspond aux paramètres d’Intercom.

  • Intercom a été actualisé.

Note : Le mode conversation 1:1 WhatsApp doit être activé pour que les modèles apparaissent dans les conversations 1:1.

Astuce : L’approbation Meta peut prendre de quelques minutes à plusieurs heures, les problèmes de synchronisation se résolvent souvent avec le temps.


Formatage des variables dans les modèles de messages WhatsApp

Intercom exige que les modèles utilisent des espaces réservés numériques (par ex., {{1}}) plutôt que descriptifs comme {{sf_full_name}}. Exemple : Bonjour {{1}}, votre commande {{2}} a été expédiée.

Si vos modèles utilisant des variables comme {{sf_full_name}} échouent, modifiez votre modèle dans Meta pour remplacer les espaces réservés descriptifs par des numériques et mappez-les dans Intercom. Cela garantit la compatibilité entre WhatsApp et Intercom en associant directement les variables aux attributs Intercom.


Prévenir la reclassification des modèles en « Marketing »

Les modèles marketing ne sont pas pris en charge dans Intercom. Seuls les modèles transactionnels approuvés par Meta sont disponibles ; les modèles marketing n’apparaîtront pas dans la sélection ni ne seront utilisables dans Intercom.

Pour garantir que les modèles restent non marketing :

  • Évitez le langage promotionnel.

  • Évitez la personnalisation excessive.

  • N’incluez pas de média sauf si nécessaire.

  • Spécifiez clairement l’objectif support ou transactionnel lors de la soumission. Rendez-le explicite et non marketing.


Problèmes d’envoi de messages WhatsApp

Le destinataire est incapable de recevoir ce message / Message non distribuable

WhatsApp n’a pas pu livrer ce message car le compte WhatsApp du destinataire n’est pas actuellement en mesure de recevoir des messages. Cela peut arriver si le numéro de téléphone n’est pas enregistré sur WhatsApp, si le destinataire n’a pas accepté les dernières Conditions d’utilisation ou la Politique de confidentialité de WhatsApp, ou s’il utilise une version obsolète de l’application WhatsApp (versions minimales requises : Android/SMBA 2.21.15.15, iOS/SMBI 2.21.170.4, KaiOS 2.2130.10 et Web 2.2132.6). D’autres facteurs pouvant bloquer la livraison incluent un compte signalé par Meta en raison d’actions en attente ou de dépassement des limites de fréquence de messages.

Pour résoudre ce problème, demandez au destinataire via un autre canal de communication (SMS, e-mail ou téléphone) de confirmer qu’il peut envoyer un message à votre numéro WhatsApp Business, d’accepter les éventuelles invites des Conditions d’utilisation en allant dans Paramètres > Aide ou Paramètres > Informations sur l’application, et de mettre à jour son client WhatsApp vers la dernière version.

Une fois ces étapes terminées, WhatsApp devrait pouvoir livrer vos messages avec succès.


Ce message n’a pas pu être livré en raison des limites de fréquence de messagerie de WhatsApp

Ce message n’a pas été livré car WhatsApp l’a bloqué pour maintenir un engagement sain de l’écosystème, ce qui signifie généralement que le destinataire a atteint une limite sur le nombre de messages de modèles marketing qu’il peut recevoir dans une certaine période.

Si vous pensez que c’est la cause, la meilleure action est d’attendre au moins 24 heures avant de tenter de renvoyer le message modèle. Le renvoyer plus tôt entraînera probablement la même erreur, car la limite peut rester active pendant des durées variables. La durée pour lever la limite de fréquence peut varier, consultez la documentation WhatsApp pour les délais spécifiques de réinitialisation.

Astuce : Pour plus de détails sur le fonctionnement de ces limites et leur réinitialisation, consultez la documentation sur les limites de messages modèles marketing par utilisateur de WhatsApp.


Ce message n’a pas pu être livré car le numéro du destinataire fait partie d’une expérience WhatsApp

Ce message n’a pas été envoyé dans le cadre d’une expérience. Pour plus de détails sur les expériences, consultez la documentation sur l’expérience de message marketing de WhatsApp.


Le type de média n’est pas pris en charge par WhatsApp

Ce message n’a pas pu être livré car WhatsApp n’a pas pu télécharger le média inclus, ce qui se produit généralement lorsque le fichier utilise un format non pris en charge ou ne respecte pas les exigences de WhatsApp en matière de médias.

Pour résoudre ce problème, vérifiez le fichier média que vous essayez d’envoyer et confirmez que son format et sa taille sont pris en charge par WhatsApp. Une fois que le média respecte les exigences de WhatsApp, vous devriez pouvoir renvoyer le message avec succès.


Ce message ne peut pas être envoyé

Ce message n’a pas pu être livré car plus de 24 heures se sont écoulées depuis la dernière réponse du destinataire à votre numéro WhatsApp, et WhatsApp n’autorise les messages libres que dans cette fenêtre de conversation active de 24 heures. Cette erreur peut aussi se produire si le numéro du destinataire a changé pendant la conversation, ce qui réinitialise effectivement la session.

Pour continuer à envoyer des messages, vous devrez envoyer un message modèle approuvé par WhatsApp à la place. Une fois que le destinataire répond, la fenêtre de 24 heures se rouvrira et les messages libres pourront être envoyés à nouveau.


Le compte WhatsApp Business a été verrouillé

Ce message n’a pas pu être livré car le compte WhatsApp Business connecté à votre application a été restreint ou désactivé. Cela se produit généralement lorsque WhatsApp détecte une violation de ses politiques de plateforme, ou lorsque les détails de la requête ne peuvent pas être vérifiés par rapport à la configuration du compte — par exemple, un code PIN de vérification en deux étapes incorrect.

Pour résoudre ce problème, consultez les directives d’application des politiques de WhatsApp pour comprendre le type de violation et les étapes nécessaires pour restaurer le compte. Vous pouvez également vérifier l’API d’état de santé WhatsApp pour obtenir des informations plus spécifiques sur la raison du verrouillage ou de la restriction du compte. Une fois le problème sous-jacent résolu, la livraison des messages devrait reprendre normalement.

Avez-vous trouvé la réponse à votre question ?