Messenger

Préparer l'application Meta et la Page#

Suivez le guide de démarrage officiel de la plateforme Messenger de Meta. Ajoutez Messenger à une application Meta, connectez la Page Facebook qui doit recevoir les messages et assurez-vous que votre compte peut administrer ces deux éléments.

Récupérez les valeurs depuis la même application et la même Page :

N'utilisez pas de jeton d'accès utilisateur ni de jeton appartenant à une autre Page. Le mode de développement et l'état de la validation (review) de l'application Meta déterminent quelles personnes peuvent utiliser l'intégration.

Enregistrer et valider les identifiants#

Ouvrez la page Canaux de l'agent, sélectionnez Messenger, saisissez le jeton d'accès de la Page et le secret de l'application, puis sélectionnez Connecter.

Make Agent Fast appelle la Graph API avec appsecret_proof, récupère l'ID et le nom de la Page, puis lie les événements entrants à cette Page précise. La carte du connecteur affiche ensuite son URL du webhook et son Jeton de vérification.

Configurer le webhook de la Page#

Dans la même application Meta :

1. Ouvrez les paramètres du webhook Messenger.
2. Collez l'URL du webhook et le Jeton de vérification du connecteur.
3. Terminez le défi de vérification.
4. Sélectionnez l'abonnement aux événements de message requis par votre workflow Messenger.
5. Abonnez la Page Facebook visée à l'application.
6. Vérifiez que l'abonnement de la Page et le mode de l'application autorisent votre utilisateur de test.

Le jeton de vérification ne sert que pour le défi initial. Les événements en production doivent porter une signature correspondant au secret de l'application. Make Agent Fast rejette également les événements adressés à une autre Page, même s'ils proviennent de la même application Meta.

Tester les fonctionnalités#

Envoyez un message normal à la Page depuis un compte de test autorisé et non administrateur, puis vérifiez la réponse ainsi que le fil dans Conversations. Testez ensuite une pièce jointe audio si les messages vocaux entrants comptent pour votre workflow.

Le texte et les fichiers audio entrants pris en charge sont traités. Dans le connecteur Messenger actuel, les réponses sont uniquement textuelles, même lorsque le message d'origine était vocal. Les accusés de livraison et de lecture, les échos des propres messages de la Page, les images et les autres pièces jointes non prises en charge sont ignorés.

Prêt pour la production#

Réalisez les étapes exigées par Meta pour votre audience : autorisations, validation de l'application (app review), vérification de l'entreprise, URL de politique de confidentialité et publication de la Page. Un test réussi en mode développement avec un compte ayant un rôle sur l'application ne prouve pas que le public peut écrire à l'intégration de la Page.

Documentez l'application Meta propriétaire et l'ID de la Page pour les opérateurs. Un jeton de Page peut cesser de fonctionner lorsque son propriétaire, ses autorisations, son association à une entreprise ou la politique du fournisseur changent.

Effectuer une rotation ou déconnecter#

Générez le nouveau jeton de Page, mettez à jour le connecteur, testez avec un utilisateur autorisé, puis invalidez l'ancien jeton. Mettez à jour Make Agent Fast immédiatement après la rotation du secret de l'application.

Désactiver ou supprimer le connecteur ne désabonne pas la Page dans Meta. Lorsque vous mettez définitivement l'intégration hors service, supprimez l'abonnement de la Page ainsi que les identifiants du fournisseur devenus inutiles.

Dépannage#

Les identifiants du fournisseur doivent uniquement être saisis dans le formulaire du connecteur authentifié ou transmis via un appel d'API côté serveur de confiance.