Connecter un bot à Facebook

Vous pouvez configurer votre bot pour communiquer avec des personnes via Facebook Messenger ou Facebook Workplace. Cet article explique 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.

Cet article montre comment ajouter le canal Facebook à votre bot via le portail Azure. Pour plus d’informations sur l’utilisation d’une carte de canal personnalisée, consultez Informations supplémentaires.

Prérequis

• Un abonnement Azure. Si vous n’en avez pas encore, créez un compte gratuit avant de commencer.
• Un 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 à developers.facebook.com.
• Pour utiliser Facebook Workplace avec votre bot, vous devez créer un compte Workplace et une intégration personnalisée pour connecter le bot.

Créer une application Facebook

Facebook Messenger

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

Obtenir l’ID de page

1. Connectez-vous à votre compte Meta for Developers .
2. Accédez à la page sur laquelle les utilisateurs accèderont à votre bot. Si vous n’en avez pas encore, accédez à Pages et sélectionnez Créer une page.
3. Ouvrez la page À propos de la page, puis copiez et enregistrez l’ID de page.

Créer votre application

1. Accédez à Créer une application Facebook.
2. Dans la page Sélectionner un type d’application , sélectionnez Business , puis Suivant.
3. Dans la page Fournir des informations de base , entrez un nom pour votre application et sélectionnez Créer une application.
   • Si vous y êtes invité, entrez 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 de votre application.
4. Développez Paramètres et sélectionnez De base.
   1. Copiez et enregistrez l’ID d’application et le secret d’application.
5. Maintenant, sous Paramètres, sélectionnez Avancé.
   1. Dans le volet résultant, faites défiler jusqu’aux paramètres de sécurité et activez l’accès à l’API aux paramètres d’application.
   2. Sélectionnez Enregistrer les modifications.

Activer Messenger

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

Ajouter des pages et générer des jetons

1. Faites défiler jusqu’à la section Jetons d’accès , puis sélectionnez Ajouter ou supprimer des pages.
   1. Lorsque vous êtes invité à associer l’identité à Messenger, continuez avec votre compte actuel ou connectez-vous à un autre.
   2. Lorsque vous êtes invité à utiliser les pages que vous souhaitez utiliser avec votre application, sélectionnez les pages, puis sélectionnez Suivant.
   3. Si vous êtes invité à envoyer la demande de révision de connexion, passez en revue les informations et sélectionnez Terminé.
   4. En cas de réussite, le site affiche une page de réussite. Sélectionnez OK pour continuer.
2. La page que vous avez ajoutée s’affiche maintenant dans la liste Pages .
3. Sélectionnez 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 reconnaissez l’avertissement.
   3. Copiez le jeton et sélectionnez Terminé.

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

Configurer votre bot dans Azure

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

1. Dans une nouvelle fenêtre de navigateur, accédez au portail Azure.
2. Ouvrez le panneau de ressources Azure Bot pour votre bot.
3. Ouvrez canaux et sélectionnez Facebook.
4. Dans Configurer Facebook Channel, entrez les informations Facebook que vous avez copiées dans les étapes précédentes.
   1. Entrez votre ID d’application Facebook et votre secret d’application Facebook.
   2. Entrez 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 de jeton.
   4. Sélectionnez Ajouter.

Conseil

• Si vous n’avez pas de copie de vos informations à partir des étapes précédentes, vous pouvez la récupérer pour le site Meta for Developers.
• Si vous avez besoin, créez un jeton web pour la page. Pour obtenir des instructions, consultez 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 paramètres de Messenger pour votre application.
2. Dans le volet résultant, faites défiler jusqu’à la section Webhooks , puis sélectionnez Ajouter une URL de rappel.
3. Dans la page Modifier l’URL du rappel :
   1. Entrez l’URL de rappel et vérifiez les valeurs de jeton que vous avez copiées à partir du portail Azure.
   2. Sélectionnez Vérifier et enregistrer.
4. La page que vous avez ajoutée s’affiche maintenant dans la liste Pages sous Webhooks.
5. Sélectionnez Ajouter des abonnements pour la page.
   1. Dans la page Modifier les abonnements de page , 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 en regard de la page de votre bot.

Facebook Workplace

Notes

Le 16 décembre 2019, Workplace by Facebook a changé son modèle de sécurité relatif aux intégrations personnalisées. Les intégrations antérieures réalisées à l'aide de Microsoft Bot Framework v4 doivent être mises à jour pour utiliser les adaptateurs Facebook de Bot Framework conformément aux instructions ci-dessous avant le 28 février 2020.

Facebook prendra uniquement en compte les intégrations disposant d’un accès limité aux données de l’espace de travail (autorisations à faible sensibilité) et éligibles à une utilisation continue jusqu’au 31 décembre 2020 si ces intégrations ont passé et réussi les tests de sécurité RFI et si le développeur prend contact avec le Support direct avant le 15 janvier 2020 pour solliciter une utilisation continue de l’application.

Les adaptateurs de canal personnalisés sont disponibles pour Facebook en JavaScript/Node.js et C#/.NET.

Facebook Workplace est une version orientée entreprise de Facebook, qui permet aux employés de se connecter et de collaborer facilement.

Les instructions suivantes décrivent comment créer une intégration De l’espace de travail Facebook personnalisée. Vous devez également modifier votre bot pour utiliser une carte de canal personnalisée pour Facebook Workplace.

Créer un compte Workplace Premium

Si vous n’avez pas encore de compte, créez-en un.

1. Soumettez une demande à Workplace pour le compte de votre entreprise.
2. Une fois votre demande approuvée, vous recevrez un e-mail vous invitant à participer. La réponse peut prendre un certain temps.
3. Dans l’invitation par e-mail, sélectionnez Prise en main.
4. Entrez vos informations de profil.

   Conseil

   Définissez-vous comme administrateur système. Gardez à l’esprit que seuls les administrateurs système peuvent créer des intégrations personnalisées.

5. Sélectionnez Profil d’aperçu et vérifiez que les informations sont correctes.
6. Accédez à la version d’évaluation gratuite.
7. Créez un mot de passe.
8. Sélectionnez Inviter des collègues à inviter des employés à se connecter. Les employés que vous avez invités deviennent membres dès qu’ils se connectent. Ils passent par un processus de connexion similaire à celui décrit dans la présente procédure.

Créer une intégration personnalisée

Créez une intégration personnalisée pour votre espace de travail. Une fois terminé, le site crée une application avec des autorisations définies et une page de type Bot (visible uniquement dans votre communauté Workplace).

1. Dans le panneau d’administration (Admin Panel), ouvrez l’onglet Integrations (Integrations).

2. Sélectionnez Créer votre propre application personnalisée.

   

3. Choisissez un nom d’affichage et une image de profil pour l’application. Ces informations seront partagées avec la page de type Bot.

4. Positionnez le curseur Allow API Access to App Settings (Autoriser l’accès de l’API aux paramètres d’application) sur « Yes » (Oui).

5. Copiez et stockez en toute sécurité les valeurs App ID (ID d’application), App Secret (Clé secrète d’application) et App Token (Jeton d’application) qui s’affichent.

   

6. Vous avez créé une intégration personnalisée. Vous trouverez la page de type Bot dans votre communauté Workplace, comme indiqué ci-dessous.

   

Ajouter l’adaptateur Facebook à votre projet de bot

1. Modifiez votre projet de bot pour utiliser un adaptateur de canal personnalisé pour Facebook. L’adaptateur de canal personnalisé pour Facebook et les informations sur la façon de l’ajouter à votre bot est disponible pour JavaScript/Node.js ou C#/.NET.
2. Dans le fichier de configuration de votre bot, ajoutez l’ID d’application Facebook, le secret d’application Facebook et les valeurs du jeton d’accès à la page que vous avez copiées à partir de Facebook Workplace précédemment. Au lieu d’un ID de page traditionnel, utilisez les numéros qui suivent le nom des intégrations dans sa page À propos .

Rendre votre application publique

Envoyer pour vérification

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. Le bot sera testé pour s’assurer qu’il est conforme aux stratégies de plateforme de Facebook.

Rendre l’application publique et publier la page

Conseil

Tant qu’une application n’est pas publiée, elle est en mode développement. Les fonctionnalités de plug-in et d’API fonctionnent uniquement pour les administrateurs, les développeurs et les testeurs.

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 concernant 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. Sous Paramètres, sélectionnez Avancé.
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. Accédez à votre page Facebook.
2. Sélectionnez Ajouter un bouton.
3. Dans la page du bouton Modifier l’action , sélectionnez Envoyer un message.
   1. Dans la page Forum aux questions , passez en revue la question par défaut et la réponse, puis sélectionnez Enregistrer.
   2. Le site remplace le bouton d’action Modifier précédent par un nouveau bouton Modifier le message d’envoi .
4. Sélectionnez Modifier le message d’envoi , puis sélectionnez le bouton Tester.
   1. Le site affiche votre page avec l’exemple de question sous la forme d’une action suggérée.
   2. Entrez un message que vous souhaitez tester la connexion à votre bot.

Vous pouvez également tester cette fonctionnalité à l’aide de l’exemple de bot pour l’adaptateur Facebook en remplissant le fichier appsettings.json avec les mêmes valeurs décrites dans les étapes ci-dessus.

Informations supplémentaires

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

Pour obtenir la documentation de Facebook Messenger, consultez :

• Documentation de la plateforme Messenger.
• Instructions de pré-lancement
• Démarrage rapide
• Guide d'installation

Pour la documentation Facebook Workplace, consultez :

• Centre d’aide sur l’espace de travail
• Documentation pour les développeurs workplace

Connecter un bot à Facebook à l'aide de l'adaptateur Facebook

L’adaptateur de canal personnalisé pour Facebook est disponible pour JavaScript/Node.js ou C#/.NET. Lisez-moi comment l’ajouter à votre bot.

• Pour vous connecter à Facebook Workplace, votre bot doit utiliser l’adaptateur de canal personnalisé.
• Pour vous connecter à Facebook Messenger, votre bot peut utiliser le canal Azure ou l’adaptateur de canal personnalisé.

Pour terminer la configuration de votre application Facebook pour un bot qui utilise l’adaptateur de canal personnalisé :

1. Dans le tableau de bord de votre application, sélectionnez Messenger , puis paramètres.

2. Dans la section Webhooks , sélectionnez Ajouter une URL de rappel.

3. Dans la zone de texte URL de rappel , entrez le point de terminaison Facebook de votre bot. Par exemple : https://yourboturl.com/api/facebook.

4. Dans la zone de texte Vérifier le jeton de vérification que vous avez créé précédemment et utilisé dans le fichier appsettings.json de votre application bot.

5. Vérifiez que votre bot est en cours d’exécution, puis sélectionnez Vérifier et enregistrer pour vérifier votre URL de rappel.

6. Une fois que votre URL de rappel a été vérifiée, sélectionnez Ajouter des abonnements qui s’affichent maintenant. Dans la fenêtre contextuelle, choisissez les abonnements suivants, puis sélectionnez Enregistrer.

   • messages
   • messaging_postbacks
   • messaging_optins
   • messaging_deliveries