Dépanner la configuration des canaux Meta

Partez du symptôme observable. Vérifiez cette connexion, corrigez et répétez le même test. Le parcours de configuration donne la séquence complète ; cette page aide lorsqu’une étape ne produit pas le résultat attendu.

Identifiants ou actifs professionnels

Symptôme	Où vérifier	Correction et nouveau test
Permission requise absente du dialogue de jeton	Application → Use cases → bon canal → Permissions and features ; application choisie dans l’assistant	Ajoutez/personnalisez le cas ou résolvez son accès, puis générez le jeton pour cette application
Page introuvable ou jeton rejeté	Business settings → Accounts → Pages ; System User → Assigned assets ; permissions et Page ID	Affectez Page/application prévues et obtenez le bon jeton. Enregistrez via Configurer Messenger et Instagram, puis vérifiez à nouveau
App Secret rejeté ou identité non confirmée	App ID du compte et App settings → Basic de cette application	Utilisez le secret correspondant, pas celui du produit Instagram login. Lisez la note exacte ; l’enregistrement ne prouve pas que toutes les vérifications distantes ont réussi
Compte Instagram non lié ou différent de celui stocké	Compte professionnel lié à la Page, portefeuille, permissions et accès	Corrigez association/accès, relancez Vérifier et enregistrer et consultez l’ID Instagram
Connexion auparavant fonctionnelle, appels en échec	Expiration/révocation et changements récents d’accès à l’application, aux actifs ou de l’administrateur	Suivez le remplacement des identifiants, puis testez réception/réponse

Aucun message entrant dans Salesforce

Confirmez la destination client. Comparez numéro, Page ou profil professionnel réel utilisé par le participant aux ID du compte.
Vérifiez la disponibilité pour ce participant. Les rôles Messenger et l’avertissement de publication WhatsApp diffèrent. Utilisez les instructions par canal.
Pour Instagram, vérifiez le parcours. Le compte doit être professionnel, lié à la Page et autoriser les outils connectés à lire les messages. Un webhook seulement sous Instagram login n’est pas le bon parcours.
Lisez la liste de configuration. Vérifiez à nouveau callback, abonnement application-actif, compte/canal actifs et configurations.
Consultez les journaux Connect. Cherchez Meta Inbound Receipt à l’heure du test. S’il existe, consultez son résultat pour distinguer traitement/correspondance/fichiers d’un webhook jamais arrivé.
Répétez le même test après correction. Pour une réception Messenger/Instagram conservée, Rejouer le webhook Meta permet de réessayer. Confirmez la présence dans le fil.

Sans réception enregistrée, ne concluez pas immédiatement à un problème de mappage Salesforce. Examinez livraison Meta et callback d’abord. Avec une réception, utilisez son résultat plutôt que de changer tous les paramètres.

Validation ou destination du webhook

Vérification en échec : confirmez URL HTTPS du Site actif, préfixe et endpoint entrants. En vérification manuelle, utilisez le jeton de vérification du compte, pas le jeton d’accès.
Envoi à une autre adresse : identifiez l’organisation concernée. Utilisez Remplacer seulement pour le changement prévu ; examinez la substitution WABA avant le callback partagé.
Événements Instagram rejetés sur Page : utilisez les listes distinctes. messaging_seen est notamment un événement Instagram.
Messages reçus sans livraison/lecture : examinez les abonnements correspondants et l’action du client. Le succès du texte ne signifie pas qu’une confirmation existe pour chaque message.

Réception correcte, mais correspondance ou création incorrecte

Ouvrez les lignes Configuration de compte Connect actives du compte/canal. Confirmez Nom d'API de l'objet, Champ d'identité du canal, priorité et ligne Nouvel enregistrement par défaut voulue. Messenger utilise le PSID propre à la Page ; Instagram son ID propre au canal. Un nom d’utilisateur ou un ID de Page professionnelle ne correspond pas à l’identité du client.

Vérifiez champs obligatoires et identité via {{phone}} dans Valeurs défaut nouvel enregistrement. En cas de création refusée, consultez l’erreur réelle de validation. Pour le compte, saisissez le nom d’API du champ contenant son ID, pas l’ID lui-même. Consultez les exemples Lead et objet personnalisé.

Un nom de profil de remplacement ne prouve pas un échec de message. Les informations de profil peuvent manquer alors que la messagerie est autorisée. Pour les nouveaux expéditeurs, REDA Connect conserve l’identité et utilise nom/nom d’utilisateur disponible ou remplacement du canal.

Réception fonctionnelle, réponse en échec

Ouvrez le message en échec et lisez son erreur dans le fil ou les détails.
Pour Messenger/Instagram, confirmez un message client dans la fenêtre actuelle de 24 heures. Un envoi ne la rouvre pas ; demandez au participant un nouveau message de test.
Vérifiez refus de messages du canal, compte/canal actifs, identité du destinataire et statut du jeton.
Confirmez un type compatible. Cette version permet réponses texte et modèles/étapes de scénario texte uniquement ; elle n’ajoute ni envois Meta en masse ni étapes structurées/avec médias.
Corrigez le point précis et envoyez une nouvelle réponse de test convenue. Ne renvoyez pas automatiquement un message de livraison incertaine sans vérifier l’application client.

Texte fonctionnel, fichier manquant ou rejeté

Sortant : confirmez partage de documents, type compatible et limite Messenger/Instagram de 4,4 Mo. Le sélecteur Instagram propose JPEG/PNG et PDF. Vérifiez le résultat final, car l’envoi de pièces jointes se termine de façon asynchrone.
Entrant : recevoir un lien et stocker un fichier Salesforce sont deux étapes. Le téléchargement est séparé. Examinez l’erreur de réception/fichier si celui-ci n’est pas stocké.
Accès au serveur distant : confirmez les paramètres de site distant pertinents actifs. Lors d’une mise à niveau push, Salesforce livre les nouveaux paramètres inactifs ; l’administrateur abonné doit les activer. Ne désactivez pas ceux du package.
Récupération : après correction, utilisez Rejouer le webhook Meta sur la réception conservée pour retenter les pièces jointes inachevées, puis ouvrez le fichier. Si l’URL source a disparu, obtenez une nouvelle pièce jointe de test convenue.

Un type compatible ne garantit pas l’acceptation de chaque fichier par Meta. Utilisez l’erreur renvoyée et un petit fichier connu comme valide pour distinguer rejet particulier et panne générale de connexion.

Action ou canal absent

Vérifiez version installée, niveau d’autorisations existant et présentation affectée. Ajoutez les actions du package Configurer Messenger et Instagram, Configurer WhatsApp ou de rejeu selon le cas. Après mise à niveau, vérifiez les valeurs de canal et dépendances Type de message/Statut. Utilisez la liste des présentations recommandées pour trouver et ajouter les champs/actions existants.

Informations à fournir au support

Indiquez version, canal, heure/fuseau, actif concerné, résultat attendu et observé, erreur exacte et référence du journal/message. Précisez si le client a reçu la réponse et si un autre canal fonctionne sur le même compte. Cela permet d’examiner l’étape réellement en échec.