Facebook Messenger

Le canal Facebook relie Anyy à une Page Facebook. Les événements Messenger arrivent par un webhook signé et les réponses utilisent le jeton d’accès de la Page.

Prérequis

• une application Meta avec Messenger activé ;
• une Page Facebook gérée par cette application ;
• le Page ID et l’App ID ;
• un jeton d’accès de Page ;
• un jeton de vérification du webhook choisi par le propriétaire ;
• le secret de l’application Meta ;
• une route HTTPS publique vers le Gateway Anyy.

Consultez le guide de démarrage actuel de Messenger Platform de Meta pour les exigences de validation de l’application, d’abonnement de la Page et d’autorisations.

Connexion dans Dashboard

1. Ouvrez Dashboard → Channel → Add.
2. Choisissez Facebook ; l’entrée par défaut utilise Messenger webhook.
3. Saisissez le Page ID et l’App ID.
4. Ajoutez le jeton d’accès de Page, le jeton de vérification du webhook et le secret de l’application.
5. Enregistrez le compte ; modifiez au besoin la règle des messages privés dans l’assistant CLI.
6. Abonnez la Page aux événements de message et accordez les autorisations indiquées par setup/doctor.

Activez l’écoute partagée et le proxy HTTPS décrits dans Plateformes à webhook avant d’enregistrer le rappel. Son chemin est :

/channels/facebook/ACCOUNT_ID/webhook

L’identifiant de compte par défaut est page. Utilisez le même jeton de vérification dans Meta et Anyy.

Accès aux messages privés

Facebook Messenger utilise les règles de messages privés pairing, open, allowlist ou disabled. Le profil Anyy ne propose pas les conversations de groupe Facebook.

anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID

Choisissez Facebook dans l’assistant interactif anyy setup channel pour modifier la règle. Dashboard ne propose ni règle ni liste d’approbation des associations, et les actions actuelles ne modifient pas les listes d’autorisation Facebook. L’association autorise cet expéditeur à joindre l’assistant : vérifiez la Page et l’identité de l’expéditeur, approuvez via la CLI, puis demandez un nouveau message.

Vérifier la connexion

anyy channel doctor facebook
anyy channel reload

Écrivez à la Page depuis un compte autorisé. Vérifiez séparément l’événement entrant, l’association et la réponse.

Tester d’abord avec un rôle sur la plateforme

Avant validation de l’application ou diffusion plus large, utilisez un compte Meta doté d’un rôle approprié sur l’application/la Page. Vous distinguerez ainsi les problèmes de configuration Anyy des restrictions d’accès de la plateforme.

Dépannage

Problème	Points à vérifier
Meta ne peut pas vérifier le rappel	Accessibilité HTTPS et jeton de vérification du webhook
Événement signé rejeté	Secret de l’application et préservation des en-têtes/du corps par le proxy inverse
La Page reçoit mais ne peut pas répondre	Jeton d’accès de Page et autorisations de messagerie
L’expéditeur ne reçoit rien	Règle des messages privés, association/liste d’autorisation, état du Gateway
Fonctionne uniquement pour les administrateurs	Mode de l’application Meta, validation de l’application et abonnement de la Page