Présentation
Un bot de discussion est un type d’intégration personnalisée avec lequel les membres de votre entreprise qui utilisent Workplace peuvent interagir via Workchat. Il permet d’automatiser certaines actions et d’accélérer certains processus. Les possibilités sont infinies, mais les cas d’utilisation les plus courants sont présentés dans ce document.
Dans cette section, vous découvrirez comment créer votre propre bot en deux étapes : configurez un bot sur Workplace et déployez-le sur vos serveurs.
Pour en savoir plus sur les intégrations et les configurations en général, vous pouvez vous reporter à cette section.
Configurer un botConfigurer un bot de discussion sur Workplace
La première étape pour créer un bot de discussion consiste à le configurer sur Workplace. Pour ce faire, vous devez vous connecter à Workplace en tant qu’admin et avoir l’autorisation Modifier les paramètres de l’entreprise et configurer les intégrations. Une fois connecté(e), vous pouvez suivre les étapes ci-dessous :
Une fois le bot créé, vous pouvez passer à la suite de la configuration.
Configuration de base
Dans la section Intégrations du Panneau d’administration, cliquez sur le nom du bot à configurer. Voici les principaux détails auxquels vous devez prêter attention.
Ce token sera envoyé dans les requêtes API que votre bot générera afin que Workplace puisse vérifier qu’elles proviennent bien de votre bot.
Si le bot n’est pas visible, les utilisateurs ne pourront pas interagir avec lui. Vous pouvez l’activer plus tard dans le processus, une fois la configuration terminée, mais n’oubliez pas de faire cette vérification avant de le lancer.
Autorisations
Sur l’écran de configuration de l’intégration, il y a une section intitulée Autorisations où vous pouvez choisir les autorisations auxquelles votre bot devra avoir accès.
Vous pouvez cocher d’autres autorisations nécessaires au fonctionnement de votre bot. Par exemple, si celui-ci doit récupérer le profil des utilisateurs dans Workplace, vous devez cocher l’autorisation Lire le profil professionnel.
Webhooks
Vous devrez également configurer la section des webhooks pour votre bot de discussion. Les webhooks vous permettent de vous abonner à des évènements spécifiques et de recevoir des mises à jour en temps réel. Quand une modification est apportée ou qu’un évènement se produit dans Workplace (par exemple, un utilisateur ou une utilisatrice envoie un message à votre bot), une requête HTTPS POST est envoyée à une URL de rappel pour chaque application d’intégration personnalisée abonnée au sujet de webhook correspondant.
Avant de poursuivre cette configuration, assurez-vous que vous déployez le code du bot sur votre serveur web. Plus d’informations ici.
Ces évènements nous permettront de savoir quand un utilisateur ou une utilisatrice envoie un message à notre bot et quand il ou elle interagit avec l’un des boutons de celui-ci.
Sécurité
La dernière étape de la configuration d’une intégration est celle de la sécurité. Bien que cette configuration ne soit pas strictement nécessaire au fonctionnement de votre bot, nous vous recommandons vivement de la configurer avant la mise en production du bot.
Cela exigera la preuve et l’heure de clé secrète à chaque fois que votre serveur enverra des requêtes API à Workplace pour plus de sécurité.
Déployer un bot de discussion sur votre serveur
La deuxième étape pour créer un bot de discussion consiste à déployer le code du bot dans votre serveur. Pour ce faire, vous devez déployer un code sur un serveur web qui vous est propre.
Nous avons créé quelques exemples de bots qui peuvent être copiés tels quels, en remplaçant simplement vos tokens dans le code. Vous pouvez y accéder en cliquant sur les liens suivants :
- Bot d’assistance : bot permettant d’automatiser les demandes d’assistance informatique des utilisateurs.
- Bot de reconnaissance : bot permettant d’automatiser la reconnaissance entre utilisateurs.
- Bot de questions/réponses sur les RH : bot permettant de fournir aux utilisateurs un accès facile aux questions/réponses relatives aux RH.