Connecter un bot à Facebook

Vous pouvez configurer votre bot pour communiquer avec des personnes sur Facebook Messenger ou Facebook Workplace. Le présent article décrit comment créer une application Facebook à l’aide du site Meta for Developers, connecter votre bot à votre application Facebook dans Azure et tester votre bot sur Facebook.

Le présent article explique comment ajouter le canal Facebook à votre bot sur le portail Azure. Pour en savoir plus sur l’utilisation d’un adaptateur de canal personnalisé, reportez-vous à Informations supplémentaires.

Prérequis

• Un abonnement Azure. Si vous n’en avez pas encore, créez un compte gratuit avant de commencer.
• Le bot publié sur Azure que vous souhaitez vous connecter à Facebook.
• Un compte Facebook for Developers. Si vous n’avez pas de compte, vous pouvez en créer un à l’adresse developers.facebook.com.
• Page Facebook à partir de laquelle les utilisateurs accèderont à votre bot. Si vous n’en avez pas encore, créez une page.
• Pour utiliser Facebook Workplace avec votre bot, vous devez créer un compte Espace de travail et une intégration personnalisée pour connecter le bot.

Créez une application Facebook

Facebook Messenger

Les utilisateurs accèdent à votre bot à partir d’une page Facebook. Pour connecter le bot, vous devez activer Facebook Messenger sur la page Facebook, puis connecter le bot à la page.

Créer votre application

1. Connectez-vous à votre compte Meta for Developers.
2. Reportez-vous à Créer une application Facebook.
3. Dans la page Sélectionner un type d’application, sélectionnez Entreprise, puis Suivant.
4. Dans la page Fournir des informations de base, saisissez un nom pour votre application, puis sélectionnez Créer une application.
   • Si vous y êtes invité, saisissez votre mot de passe et sélectionnez Envoyer pour créer votre application.
   • Une fois votre application créée, le site accède à une page pour votre application.
5. Ouvrez Paramètres et sélectionnez Paramètres de base.
   1. Copiez et enregistrez les valeurs ID d’application et Clé secrète d’application.
6. Dans la rubrique Paramètres, sélectionnez Avancés.
   1. Dans le volet qui s’affiche, faites défiler jusqu’aux paramètres de sécurité et activez Autoriser l’accès API aux paramètres d’application.
   2. Sélectionnez Enregistrer les modifications.

Activer Messenger

1. Sélectionnez Tableau de bord.
2. Dans le volet qui s’affiche, faites défiler jusqu’à la vignette Messenger, puis sélectionnez Configurer.
3. Le site ajoute les paramètres de Messenger à votre application et affiche la page des paramètres.

Ajouter des pages et générer des jetons

1. Dans la rubrique Messenger, sélectionnez Paramètres.

2. Faites défiler jusqu’aux jetons d’accès, puis sélectionnez Ajouter ou supprimer des pages.

   1. Lorsque vous êtes invité à fournir l’identité à associer à Messenger, continuez avec votre compte actuel ou connectez-vous à un autre compte.
   2. Lorsque vous êtes invité à indiquer les pages que vous souhaitez utiliser avec votre application, sélectionnez-les, puis cliquez sur Suivant.
   3. Si vous êtes invité à envoyer la demande de révision de connexion, examinez les informations et sélectionnez Terminé.
   4. Si vous y parvenez, le site affiche une page indiquant que vous êtes bien connecté. Sélectionnez OK pour continuer.

3. La page que vous avez ajoutée apparaît maintenant dans la liste Pages.

   Copiez l’ID de page et enregistrez-la pour l’utiliser ultérieurement.

4. Cliquez sur Générer un jeton pour la page.

   1. Le site affiche des informations de sécurité et vous donne la possibilité de copier le jeton.
   2. Lisez et approuvez l’avertissement.
   3. Copiez le jeton, puis sélectionnez Terminé.

Vous disposez désormais des informations sur votre application et d’un jeton pour l’étape suivante. Laissez les étapes de paramètre Facebook en attente. Vous les actualiserez plus tard.

Configurer votre bot dans Azure

Pour permettre à votre bot d’envoyer des messages et d’autres événements à Facebook Messenger, vous devez activer l’intégration de webhooks.

1. Dans une nouvelle fenêtre du navigateur, reportez-vous au Portail Azure.
2. Ouvrez le panneau de la ressource Azure Bot pour votre bot.
3. Ouvrez canaux et sélectionnez Facebook.
4. Dans Configuration du canal Facebook, saisissez les informations que vous avez copiées précédemment.
   1. Saisissez votre ID d’application Facebook et votre secret d’application Facebook.
   2. Saisissez votre ID de page et votre jeton d’accès.
   3. Copiez l’URL de rappel générée et vérifiez les valeurs des jetons.
   4. Sélectionnez Ajouter.

Conseil

• Si vous ne disposez pas d’une copie des informations obtenues lors des étapes précédentes, vous pouvez les récupérer sur le site de Meta for Developers.
• Le cas échéant, créez un nouveau jeton web pour la page. Pour obtenir des instructions, reportez-vous à Ajouter des pages et générer des jetons.

Activer les webhooks

Revenez aux paramètres Facebook pour terminer le processus de configuration.

1. Sur le site Meta for Developers, revenez à la page des paramètres Messenger de votre application.
2. Dans le volet qui s’affiche, faites défiler jusqu’à la section Webhooks et sélectionnez Ajouter une URL de rappel.
3. Dans la page Modifier l’URL de rappel :
   1. Saisissez l’URL de rappel et les valeurs du jeton de vérification que vous avez copiées depuis le portail Azure.
   2. Sélectionnez Vérifier et enregistrer.
4. La page que vous avez ajoutée apparaît maintenant dans la liste Pages sous Webhooks.
5. Sélectionnez Ajouter des abonnements pour la page.
   1. Dans la page Modifier les abonnements, sélectionnez les champs d’abonnement suivants :
      • messages
      • messaging_postbacks
      • messaging_options
      • message_deliveries
   2. Sélectionnez Enregistrer.
6. Le site affiche les champs d’abonnement ajoutés à côté de la page pour votre bot.

Facebook Workplace

Remarque

Le 16 décembre 2019, Workplace by Facebook a changé son modèle de sécurité relatif aux intégrations personnalisées. Facebook n’accepte pas de nouvelles intégrations d’applications pour Facebook Workplace.

Rendre votre application publique

Une application reste en mode développeur jusqu’à sa publication. Les fonctionnalités de plug-in et d’API fonctionnent uniquement pour les administrateurs, les développeurs et les testeurs.

Seul le créateur (le compte Facebook Dev qui a créé la page et le bot) peut obtenir une réponse de bot. Les utilisateurs Facebook normaux ne peuvent pas voir la page ou le bot. Attribuez des rôles de développeur ou de testeur aux utilisateurs cibles, afin qu’ils puissent également discuter avec le bot.

Les utilisateurs à ajouter aux rôles de testeurs doivent d’abord s’inscrire sur le site de Meta for Developers. Le rôle de testeur n’est pas disponible pour les utilisateurs de Facebook qui n’ont pas de compte Meta for Developers. Pour en savoir plus sur les rôles d’application et les utilisateurs de test, reportez-vous à la documentation meta pour les développeurs.

Envoyer pour évaluation

Facebook requiert une URL de politique de confidentialité et une URL de conditions d’utilisation sur sa page de paramètres d’application de base. La page Code of Conduct (Code de conduite) contient des liens vers les ressources tierces, aidant à créer une politique de confidentialité. La page Terms of Use (Conditions d’utilisation) contient des exemples de conditions aidant à créer un document de conditions d’utilisation approprié.

Une fois le bot terminé, Facebook applique son propre processus de vérification pour les applications publiées sur Messenger. Facebook teste le bot pour vérifier qu’il est conforme aux politiques de la plateforme Facebook.

Rendre l’application publique et publier la page

Une fois la vérification effectuée, dans le tableau de bord de l’application, sous App Review (Vérification de l’application), définissez l’application sur Publique. Assurez-vous que la page Facebook associée à ce bot est publiée. L’état s’affiche dans les paramètres des pages.

Définir la version de l’API

Si vous recevez une notification de Facebook sur la dépréciation d’une certaine version de l’API Graph :

1. Accédez à Meta pour les développeurs.
2. Accédez à l’application que vous avez créée pour votre bot.
3. Dans la rubrique Paramètres, sélectionnez Avancés.
4. Sélectionnez Mettre à niveau la version de l’API, puis basculez Mettre à niveau tous les appels vers la version 4.0.

Testez la connexion en suivant les étapes décrites dans la section Tester votre bot dans Facebook.

Tester votre bot dans Facebook

Vous pouvez maintenant vérifier que votre bot est correctement connecté à Facebook en envoyant un message via la page Facebook que vous avez associée à votre nouvelle application Facebook.

1. Allez sur Facebook et passez au profil de votre page.
2. Sélectionnez plus d’actions (... ), puis ajoutez le bouton d’action.
   1. Dans la boîte de dialogue Personnaliser votre bouton d’action, sélectionnez Essayer et suivez les instructions.
   2. Dans la page bouton d’action, sous Permettre à des personnes de vous contacter, sélectionnez Envoyer un message.
   3. Sélectionnez Suivant, terminez la boîte de dialogue et enregistrez vos modifications.
3. Revenez à votre profil personnel.
4. Accédez à votre page, puis sélectionnez Message pour tester la connexion à votre bot.

Vous pouvez également tester cette fonctionnalité à l’aide de l’exemple de bot relatif à l’adaptateur Facebook en renseignant le fichier appsettings.json avec les mêmes valeurs que celles décrites dans les étapes précédentes.

Informations supplémentaires

Reportez-vous à l’exemple d’événements Facebook C# Bot Framework pour avoir un exemple de bot qui prend en charge la communication Facebook Messenger.

Pour accéder à la documentation de Facebook Messenger, reportez-vous à :

• Documentation de la plateforme Messenger.
• Recommandations en matière de pré-lancement
• Démarrage rapide
• Guide d'installation

Pour accéder à la documentation Facebook Workplace, reportez-vous à :

• Centre d’aide Workplace
• Documentation pour les développeurs Workplace