Messenger

Deux façons d'entrer

Ouvrez Configurations → Canaux dans la barre latérale du tableau de bord, puis sur la carte Messenger, choisissez Autoriser. Le dialogue propose deux parcours :

• Connectez votre page Facebook, avec un bouton Connecter la page, dans une seule fenêtre : vous choisissez votre page, autorisez l'accès, et c'est fait. Rien à copier, rien à configurer côté Facebook.
• Avancé, apportez votre propre application Meta en dessous, le parcours manuel, pour ceux qui gèrent déjà leur propre application sur le site développeurs de Facebook.

Le bouton Connecter la page affiche actuellement Bientôt disponible : l'application Facebook de ProxyAI est encore en cours de vérification d'entreprise et d'examen par Meta. C'est la décision et le calendrier de Meta. D'ici là, le parcours avancé ci-dessous fonctionne intégralement.

Le parcours manuel

Ce parcours est vraiment technique : il passe par le site développeurs de Facebook, et non par les réglages habituels d'une page. Si ce n'est pas votre domaine, transmettez cette section à la personne qui s'occupe de votre site web, ou attendez la connexion en un clic.

Messenger délivre les messages via une page Facebook, jamais un profil personnel. Il vous faut :

• Une page Facebook dont vous êtes administrateur.
• Une application sur le site développeurs Meta avec le produit Messenger ajouté.

Deux valeurs sont à saisir dans ProxyAI :

• Jeton d'accès à la page, sur le site développeurs Meta : votre application → Messenger → Paramètres → Jetons d'accès, ajoutez votre page et générez un jeton.
• Secret de l'application, dans Paramètres de l'application → Base → Secret de l'application. ProxyAI l'utilise pour confirmer que les messages entrants viennent bien de Facebook, afin que personne ne puisse envoyer de faux messages à votre bot.

Traitez les deux comme des mots de passe. Si l'un d'eux est divulgué, réinitialisez-le côté Meta et enregistrez le remplaçant ici.

Collez les deux, puis choisissez Enregistrer. ProxyAI vérifie les valeurs auprès de Facebook et connecte votre page.

Indiquez à Facebook où se trouve ProxyAI

Facebook conserve ce réglage au niveau de l'application et non de la page, donc ProxyAI ne peut pas le renseigner à votre place. Le dialogue affiche les deux valeurs nécessaires, chacune avec un bouton de copie : URL de rappel du webhook et Jeton de vérification.

Ensuite, une fois par application :

1. Site développeurs Meta → votre application → Messenger → Paramètres → Webhooks.
2. Choisissez Ajouter une URL de rappel.
3. Collez l'URL de rappel et le jeton de vérification issus du dialogue ProxyAI.
4. Choisissez Vérifier et enregistrer. Facebook contrôle l'adresse immédiatement, donc enregistrez d'abord dans ProxyAI.
5. Abonnez-vous à `messages`, et ajoutez `messaging_postbacks` si votre bot utilise des boutons.

Accueillir de vrais clients

Une nouvelle application démarre en mode Développement, où seules les personnes listées sur l'application (vous et ceux que vous avez ajoutés) reçoivent une réponse. Pour servir de vrais clients, réussissez l'examen de l'application de Meta pour pages_messaging, puis passez l'application en mode Actif.

Testez

Ouvrez votre page dans Messenger et envoyez un message. Le bot répond en quelques secondes.

• Aucune réponse du tout : l'abonnement à messages manque, ou l'application est encore en mode Développement et vous écrivez depuis un compte qui n'y figure pas.
• Facebook rejette la vérification : le jeton de vérification doit correspondre exactement à celui du dialogue ProxyAI, et vous devez avoir enregistré dans ProxyAI avant de cliquer sur Vérifier et enregistrer.
• L'enregistrement échoue avec une erreur de jeton invalide : le jeton appartient à une autre page ou a expiré. Générez-en un nouveau.

La règle des 24 heures

Facebook n'autorise une page à répondre que dans les 24 heures suivant le dernier message du client. Les réponses du bot partent immédiatement, elles sont donc presque jamais concernées. Les réponses humaines le sont : si vous prenez une conversation dans la boîte de réception d'agent et répondez un jour plus tard, Facebook refuse. La boîte de réception vous indique que la fenêtre est expirée, et le client doit réécrire. C'est une règle de Meta, et rien côté ProxyAI ne peut la lever.