Installer un chatbot Vizir sur Facebook Workplace
Introduction
Installer un chatbot sur Facebook Workplace est assez simple. Il suffit de créer une nouvelle intégration personnalisée, remplir quelques champs de façon bien avisée, et de copier / coller les app ID et app secret dans Vizir.
C’est parti pour voir le détail de tout cela.
Pré-requis
Avoir un chatbot
Être administrateur de votre Facebook Workplace
Créer une intégration personnalisée dans Facebook Workplace
La première étape consiste à créer la une intégration personnalisée dans Facebook Workplace.
Pour ce faire, suivez le screenshot ci-dessous 👇👇
Remplissez alors le Nom et la Description pour votre chatbot.
Connectez l'intégration Facebook Workplace à votre chatbot Vizir
Générez un token d’accès, copiez le et collez-le dans Vizir dans le champ Partage > Facebook Messenger > APP SECRET.
⚠️ Quant à l’APP ID que l’interface Vizir vous demande, il ne s’agit pas de l’appID que vous trouverez sur la page des détails de l’intégration Workplace. Vous la trouverez en vous rendant sur la page de conversation de votre intégration (pour rechercher votre intégration sur la page Conversation de Workplace, vous devez taper son nom en entier 🤭). En effet, une fois sur cette page, concentrez-vous sur l’url dans la barre d’adresse de votre navigateur et récupérez la série de chiffres qui se trouve après le dernier « / » ; c’est ça le véritable appID de votre bot Workplace 😓
Définissez les autorisations d'intégrations dans Facebook Workplace
Retournez dans votre administration Workplace, sur la page de paramétrage de votre intégration.
A la rubrique Autorisations d’intégrations, cochez a minima les cases suivantes :
- « Lire l’adresse e-mail de l’utilisateur »
- « Contacter tous les membres »
- « Consulter le profil professionnel »
- « Consulter l’organigramme »
Vous pouvez laisser les options suivantes comme paramétrées par défaut.
Configurez les webhooks pour activer les échanges de message
Vous devez maintenant faire en sorte que votre intégration Workplace puisse envoyer et recevoir des messages à la plateforme Vizir. Il suffit pour cela de configurer les webhooks comme suit :
- URL de rappel : https://developers.vizir.co/fbmessenger/messages
- Vérifier le token : test_token
- Cocher les autorisations suivantes :
Laissez le TALN intégré configuré par défaut. Il doit être désactivé.
Vous pouvez ensuite éditer les paramètres de sécurité en fonction de votre politique interne.
Retournez ensuite dans votre page principale Workplace, à l’onglet conversations.
Recherchez le nom du bot, cliquez sur celui ci et copiez l’id qui s’affiche dans l’url (après le /t/) et collez le dans Vizir à la rubrique Partage > Facebook Messenger > APPID
🙏 Pré-Requis
- Avoir un chatbot
- Être administrateur de votre Facebook Workplace
