Connecteur Messenger
Le connecteur Messenger connecte un bot à une page Facebook, pour dialoguer avec les utilisateurs sur Facebook Messenger.
- Type de connecteur :
messenger - Sources et README : connector-messenger
Ce que vous allez créer
-
Une configuration (dans Facebook et dans Tock) pour recevoir et envoyer des messages via Messenger
-
Un bot qui parle sur une page Facebook ou dans Messenger
Pré-requis
-
Environ 20 minutes
-
Un bot Tock fonctionnel (par exemple suite au guide premier bot Tock)
-
Un compte Facebook Developer
Créer une page Facebook
- Créez une page Facebook


- Donnez-lui un nom (par exemple My Tock Bot)

Recommandation : ne publiez pas la page pour limiter son accès des utilisateurs Messenger : Paramètres > Général > Visibilité de la page > Non publiée
Créer une application Facebook
-
Allez sur la page Facebook for developers > Voir toutes les applications
-
Ajouter une app

- Créer une app > Gérer les intégrations professionnelles

- Entrez un nom pour l'application

- Ajoutez un produit : Messenger


Créer un connecteur Messenger
- Dans Tock Studio allez dans Settings > Configurations :

- Créez un connecteur de type Messenger et ouvrez la section Connector Custom Configuration

- Compléter les champs (voir ci-dessous champ par champ) :

- Application Id : il se trouve sur la page de votre application sur https://developers.facebook.com

- Page Id : il se trouve sur la page liée à votre application sur https://facebook.com


-
Call Token : le jeton se trouve sur la page de votre application sur https://developers.facebook.com
-
Webhook Token : choisissez un jeton quelconque (même
tokensi vous le souhaitez) et notez-le pour plus tard - chaque appel de Facebook vers Tock passera ce jeton -
Secret : à copier depuis la page de l'application sur https://developers.facebook.com
-
Persona Id : vous pouvez laisser ce champ vide
-
Vérifiez que la configuration du connecteur est bien enregistrée
Configurer l'URL de rappel
-
Retournez sur la page de configuration de votre application sur https://developers.facebook.com : Produits > Messenger > Paramètres > Webhooks
-
Cliquez sur Ajouter l'URL de rappel (ou Modifier l'URL de rappel si vous aviez précédemment une autre URL)
-
Entrez l'URL à laquelle votre connecteur Tock est actuellement déployé, et le jeton de webhook que vous avez choisi lors de la configuration du connecteur
Pour retrouver l'URL de votre connecteur, allez sur la page de configuration Tock Studio > Settings > Configurations, déroulez la configuration de votre connecteur Messenger, et concaténez le contenu du champ Application base url et celui du champ Relative REST path.
-
Cliquez sur Vérifier et enregistrer
-
Testez votre bot sur Messenger !
Aller plus loin
Le modèle conversationnel, les fonctionnalités et la personnalité de votre assistant restent indépendants des canaux sur lesquels le bot est présent. Vous pouvez néanmoins créer des réponses spécifiques à un canal : dans l'écran Answers, avec des règles de stories pour une configuration, ou avec les composants Messenger des DSLs et de la Bot API.
Pour en savoir plus sur le connecteur Messenger fourni avec Tock, rendez-vous dans le dossier connector-messenger sur GitHub, où vous retrouverez les sources et le README du connecteur.