Cette erreur apparaît lorsque le numéro de téléphone a été utilisé précédemment 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.

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

Nous pouvons tenter une connexion manuelle.

Ouvrez les outils de développement de votre navigateur (appuyez sur F12, ou faites un clic droit sur la page et sélectionnez Inspecter), puis allez dans l'onglet Console pour voir le message d'erreur complet.

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.

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.

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 :

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 :

Cela se produit lorsque votre WhatsApp Business Account (WABA) n'a pas été partagé avec Intercom lors de l'inscription intégrée de Meta, donc Intercom ne peut pas y accéder. Relancez le processus de connexion et assurez-vous d'accorder l'accès à Intercom au WABA lorsqu'on vous le demande. Si l'erreur persiste, contactez le support Intercom avec votre ID WABA.

Assurez-vous que votre numéro WhatsApp est connecté sur la page d'installation. S'il ne l'est pas, complétez d'abord le flux de configuration WhatsApp. Une fois connecté, désactivez l'authentification à deux facteurs dans WhatsApp (voir la note ci-dessous), puis réessayez la création du certificat.

Vérifiez que le numéro de téléphone est entièrement approuvé dans Meta Business Manager. S'il y a des étapes de révision ou des exigences d'approbation en attente sur le numéro, complétez-les avant de réessayer dans Intercom.

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

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.

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

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.

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 une erreur (#1) de paramètre lors de la connexion de votre numéro, consultez la section dédiée ci-dessous.

Exemples :

Ces erreurs indiquent que votre entreprise pourrait ne pas respecter les normes de la politique WhatsApp. Si vous pensez que votre entreprise est éligible, contactez le support Meta Business Suite. La documentation officielle est disponible ici.

Pour résoudre cette erreur :

Ce message d'erreur signifie que le nombre de valeurs de paramètres variables que vous avez inclus dans votre requête 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.

Suivez ces étapes :

Note : Fermer la fenêtre contextuelle au bon moment est essentiel pour éviter cette erreur. Fermez la fenêtre de création du compte WhatsApp Business affichée ci-dessous après la création du compte, mais avant d'ajouter votre numéro de téléphone :

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.

Accédez à votre compte Meta Business Manager, allez dans Comptes WhatsApp et vérifiez s'il y a des actions en attente signalées sur votre compte WhatsApp Business (WABA) ou votre numéro de téléphone. Complétez toutes les étapes de vérification en attente, puis réessayez d'envoyer votre message.

Avant de contacter le support, vérifiez ce qui suit — les modèles qui n'apparaissent pas dans Intercom échouent généralement à l'un de ces contrôles :

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

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 d'Intercom.

Pour garantir que les modèles restent non marketing :

WhatsApp n'a pas pu livrer ce message car le compte WhatsApp du destinataire n'est actuellement pas 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 WhatsApp (les exigences minimales de version sont listées dans le tableau ci-dessous). D'autres facteurs pouvant bloquer la livraison incluent le compte du destinataire signalé par Meta en raison d'actions en attente ou le dépassement des limites de fréquence de messages. Intercom identifie cela comme code d'erreur 131026, affiché comme « message non distribuable » ou « destinataire incapable ».

Pour résoudre le problème, demandez au destinataire via un autre canal de communication (comme SMS, e-mail ou téléphone) de confirmer qu'il peut envoyer un message à votre numéro WhatsApp Business, d'accepter toute invite en attente des Conditions d'utilisation en allant dans Paramètres > Aide ou Paramètres > Informations sur l'application, et de mettre à jour leur 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 é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 modèles marketing qu'il peut recevoir dans une certaine période. Intercom identifie cela comme code d'erreur 131049 (engagement de l'écosystème). Pour les étapes de dépannage et les délais de réinitialisation, consultez le guide de dépannage des échecs de messages WhatsApp.

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 de WhatsApp pour des indications sur les délais de réinitialisation spécifiques.

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 de l’expérience de message marketing de 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 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 également se produire si le numéro de téléphone 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.

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 WhatsApp Health Status 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.