Messenger
Rendre votre bot disponible sur Messenger
Prérequis
Pour créer un bot sur Messenger qui sera connecté à votre bot dydu, vous aurez besoin de :
Une adresse e-mail
Un compte Facebook avec cet e-mail
Une page Facebook liée à ce compte Facebook
Un compte Meta pour les développeurs avec ce compte Facebook
Une application Meta
Il y a 3 étapes à suivre :
Ajoutez et configurez les produits nécessaires à partir de votre portail « Meta for Developers ».
Créez et configurez une intégration de type Meta à partir du menu « Canaux » du BMS dydu .
Demandez un accès avancé pour les autorisations et les fonctionnalités nécessaires.
Étape 1 : Ajouter des produits nécessaires pour Messenger
Pour que votre application fonctionne sous Messenger, ajoutez et configurez les produits suivants :
Facebook Login for Business,
Messenger.
Pour faire ceci :
Cliquez sur « Ajouter un produit ».
Recherchez le produit "Facebook login for Business" et cliquez sur "Configurer".
La page « Paramètres » du produit « Facebook login for Business » s’ouvrira et une nouvelle section « Facebook login for Business » s’affichera dans le menu de gauche.
Retournez à la page des produits en cliquant sur « Ajouter un produit ».
Recherchez « Messenger » et cliquez sur « Configurer ».
La page “Paramètres” du produit “Messenger” s’ouvre et une nouvelle section “Messenger” s’affiche dans le menu de gauche.
Vos produits ont été ajoutés avec succès ! Nous allons maintenant procéder à leur configuration, en commençant par le produit Facebook Login for Business.
Configurer le produit Facebook Login
Cliquez sur Facebook Login for Business > Paramètres.
Activez l'option « Se connecter avec le SDK JavaScript ». Cela vous permettra de vous connecter à votre compte Facebook à partir de votre intégration dans le menu Canaux de dydu.
Remplissez les domaines autorisés pour le SDK JavaScript : entrez l'URL principale du menu « Canaux ».
Par exemple, si vous vous connectez au menu Canaux du BMS dydu et que l'URL complète est https://sso.channels.dydu. i/?ticket=ST-1475-7riKAzdDpiYrbRGbmhLImJ-cDd8-cas-prod-sso#/configurations, entrez seulement https://sso.channels.dydu.ai/ dans le champ "Domaines autorisés pour le SDK JavaScript".
Cliquez sur le bouton « Enregistrer les modifications ».
Configurer le produit Messenger
Cliquez sur Messenger > Paramètres dans le menu de gauche.
Sur la page principale, recherchez le « Token d'accès ».
Cliquez sur le bouton « Ajouter ou supprimer des pages » : vous allez lier votre page Facebook à votre application Meta.
Un nouvel onglet vous demandera de continuer en tant que "votre compte". Cliquez sur «votre compte».
Sélectionnez la page Facebook que vous souhaitez lier à votre application Meta. Cette page sera celle depuis laquelle votre bot sera joignable.
Activer les autorisations listées. Cliquez sur « Terminé ».
Un message confirmant l'association de votre page Facebook à votre application Meta s'affiche : cliquez sur le bouton "OK".
Votre page Facebook est maintenant listée dans la section « Token d'accès » !
Les produits nécessaires au bon fonctionnement de votre application sur Messenger ont été configurés ! Maintenant, passons à l'étape suivante : créer et configurer une intégration Meta à partir du menu "Canaux" du BMS Dydu.
Étape 2 : Créer et configurer une intégration Meta à partir du menu « Canaux » du BMS Dydu
Pour créer une intégration Meta dans le BMS Dydu, suivez ces étapes :
Obtenez l'identifiant de votre application Meta et sa clé correspondante.
Obtenir l'identifiant de la page associée à votre application Meta et son token d'accès.
Ces informations sont spécifiques à votre application Meta et sont disponibles sur le portail Meta for Developers.
Où trouver l'identifiant de votre application META et sa clé correspondante ?
Dans le portail Meta for Developers, allez dans votre application et cliquez sur Paramètres > Général dans le menu de gauche.
Copiez et conservez votre ID d'application.
Cliquez sur le bouton "Afficher" pour afficher la clé de votre application. Vous serez invité à entrer votre mot de passe pour afficher la clé.
Copiez et conservez la clé de votre application.
Où trouver l'identifiant de page associé à votre application META et le token correspondant ?
Dans le portail Meta for developers, sur votre application, cliquez sur Messenger > Settings dans le menu de gauche.
Sur la page principale, recherchez le « token d'accès ».
Copiez et conservez l'identifiant de la page (il est affiché sous le nom de votre page).
Cliquez sur le bouton « Générer un token » pour votre page.
Une modale s'ouvre, cochez la case « Je comprends ».
Le token s'affiche en clair, vous devez ensuite le copier et le garder.
Avec ces informations, connectez-vous à votre BMS Dydu et ouvrez le menu « Canaux » de votre bot.
Cliquez sur « Créer » pour créer une nouvelle intégration.
Sélectionnez la plateforme Meta.
Donnez un nom à cette intégration et cliquez sur "Créer".`
Vous arrivez sur la page « Information » qui vous permet de choisir la langue et l'espace qui seront interrogés pour votre bot sur Messenger.
Cliquez sur le bouton « Suivant ».
Une modale s'ouvre : entrez l'identifiant de votre application ainsi que la clé secrète de l'application Meta.
Ces informations ont été précédemment récupérées à partir de votre portail Meta for Developers. Si vous avez ignoré cette étape et ne savez pas comment récupérer l'identifiant de l'application et la clé secrète, on vous l'explique ici
Une fois les informations fournies, cliquez sur « Enregistrer ».
Vous arrivez sur la page « Connexion », seconde et dernière étape de configuration de votre intégration Meta.
Sur la gauche, vous trouverez les connexions disponibles. Cliquez sur Créer à côté de Messenger, pour connecter votre bot dydu à votre page Messenger.
Un nouvel onglet vous demandera de continuer en tant que "votre compte". Cliquez sur «votre compte».
Sélectionnez la page Facebook à laquelle vous voulez connecter votre bot dydu: c'est la page à partir de laquelle votre bot sera joignable!
Activez les autorisations listées et cliquez sur « Terminé ».
Un message confirmant l'association de votre page Facebook à votre application Meta s'affiche : cliquez sur le bouton "OK".
Vous êtes ensuite redirigé vers la configuration de votre intégration à partir du menu Canaux. Une modale « Page » est ouverte.
Entrez l'identifiant de la page et le token. Ces informations ont été précédemment récupérées à partir de votre portail Meta for Developers. Si vous avez ignoré cette étape et ne savez pas comment récupérer l'identifiant de la page et le jeton d'accès, on vous l'explique ici !
Cliquez sur « Mettre à jour ».
Votre connexion Messenger est en place !
Cliquez sur « Terminer ».
Votre bot est maintenant disponible sur Messenger. Vous pouvez le tester en vous rendant sur votre page et en cliquant sur le bouton « Message»
Posez-lui vos questions!
Votre bot est fonctionnel mais n'est disponible que pour :
les administrateurs de l'application Meta,
les comptes facebook ajoutés en tant que testeurs de l'application Meta.
Pour le rendre disponible à tous les utilisateurs de Messenger, vous devez demander un accès avancé à certaines autorisations et fonctionnalités puis passer le contrôle de l’application exigé par Meta.
Étape 3 : demander un accès avancé pour les autorisations et les fonctionnalités nécessaires
Accéder à votre portail Meta for Developers
Cliquez sur Contrôle app > Autorisations & Fonctionnalités dans le menu de gauche
L’ensemble des autorisations et fonctionnalités est listée sur cette page. Demandez un accès avancé pour les autorisations suivantes :
pages_messaging
Une barre de recherche est disponible sur cette page. Vous pouvez l'utiliser pour rechercher des autorisations à ajouter. Pour chaque autorisation, cliquez sur « Obtenir l'accès avancé »
Certaines autorisations exigent un test réussi d’appel aux APIS Meta et de passer le contrôle de l’application mis en place par Meta Nous vous invitons à suivre les instructions et la documentation fournies par Meta pour ce faire.
Une fois ces autorisations accordées, vous pouvez passer votre application en mode "Live".
Dernière mise à jour
