Comment construire un bot Slack

Slack a fondamentalement changé la façon dont les employés au sein des équipes, des bureaux et des organisations entières communiquent et collaborent les uns avec les autres. Il existe une myriade de façons de personnaliser Slack de votre entreprise mais, au-delà de l'utilisation des canaux, des fichiers GIF, des intégrations d'applications et des emojis de réaction, le moyen le plus dynamique d'améliorer votre expérience Slack consiste à utiliser des bots.

À la fois interface de chatbot et moteur d'action automatisé, les bots Slack ont ​​une tonne d'utilisations potentielles. Au sein d'un canal spécifique, les plus de 100 bots actuellement disponibles dans le répertoire des bots de Slack peuvent évoquer n'importe quoi, d'un sondage, d'une enquête ou d'un formulaire de suivi du temps à l'analyse des messages, aux commandes de déjeuner et aux recommandations de restaurants, le tout avec un message direct rapide (DM) ou la commande slash.

De nombreux fournisseurs de logiciels d'entreprise, dont SurveyMonkey et Zenefits (Visit Site at Zenefits) ont déjà créé des bots que vous pouvez activer dans Slack. Mais vous n'avez pas besoin d'attendre que quelqu'un d'autre crée le bot Slack dont votre organisation a besoin. En utilisant les ressources, la documentation et les didacticiels pour développeurs de Slack, vous pouvez laisser l'entreprise vous guider dans la création de votre propre bot Slack.

PCMag s'est entretenu avec Amir Shevat, responsable des relations avec les développeurs chez Slack, et John Agan, responsable principal des relations avec les développeurs chez Slack (visitez le site chez Zenefits), sur la façon de créer un bot Slack à partir de zéro. Le processus nécessite un savoir-faire considérable des développeurs par endroits, mais Shevat et Agan nous ont guidés à travers deux scénarios de création de bot simples auxquels toutes les entreprises peuvent s'identifier : créer un bot de support de base et activer les notifications dans le canal. Lisez la suite pour obtenir des instructions étape par étape sur la façon de créer votre propre bot Slack.

1. 1. Créer une nouvelle application Slack

Pour commencer, ouvrez le menu de navigation de gauche de votre client Slack et cliquez sur "Applications et intégrations". En haut à droite de l'App Directory, cliquez sur "Build". Cela vous amène à l'interface de programmation d'application (API) Slack où vous cliquez sur "Démarrer la construction" au centre de la page. Donnez un nom à votre application (dans ce cas, Helpdesk), choisissez l'équipe dans laquelle vous souhaitez déployer l'application, puis cliquez sur "Créer une application".

Cela vous amène à la page Informations de base de votre application. Pour une personnalisation supplémentaire, faites défiler jusqu'à la zone Afficher les informations dans laquelle vous pouvez ajouter une description, modifier la couleur d'arrière-plan et ajouter une icône pour votre futur bot. Pour le bot Helpdesk, par exemple, Agan a donné au bot l'emoji du robot comme icône.

2. 2. Rédigez les messages de votre bot

Maintenant que vous avez créé votre application, l'API Slack vous offre un certain nombre d'options pour commencer à personnaliser ce qu'elle peut faire. Pour notre application Helpdesk, nous construisons un bot qui facilite le dépôt d'un ticket d'assistance en votre nom. Tout d'abord, Slack's Agan a déclaré que vous deviez écrire les messages qui apparaîtront lorsqu'un utilisateur saisira une commande slash.

Dans la section Messages du menu API Slack, choisissez l'outil Message Builder. Cela vous donne du code JSON préformaté, avec un espace pour écrire et ensuite prévisualiser votre texte. Pour ce bot, Agan a saisi : "Voulez-vous enregistrer ce ticket d'assistance ?"

Lorsqu'un utilisateur clique sur "Créer" pour déposer son ticket d'assistance, c'est le message de confirmation qui s'affiche. Ainsi, à côté du texte, Agan a ajouté la commande pour :white_check_mark : pour donner à l'utilisateur de Slack une coche verte emoji confirmant la soumission de son ticket. Juste comme ça, vous avez écrit le code de message automatisé de votre bot. Gardez-le à portée de main car vous en aurez besoin dans quelques instants.

3. 3. Ajouter des notifications

Agan et Shevat ont donné des démos séparées, mais Shevat a expliqué que l'une des intégrations de bot les plus courantes que Slack a vues depuis l'ouverture de la capacité est un bot qui récupère les notifications de services tiers. Il peut s'agir d'un rapport de ventes hebdomadaire de Salesforce (visitez le site sur Salesforce.com) ou, dans ce cas, de la plate-forme d'assistance pour laquelle votre bot crée des tickets.

4. 4. Activer les Webhooks entrants

Pour ajouter des notifications dans votre bot Helpdesk (Shevat a démontré ces étapes avec un exemple distinct qu'il a nommé "ReportBot"), vous devez d'abord activer les Webhooks entrants. Un Webhook est un simple rappel HTTP qui publie un message sur une URL lorsqu'une action spécifique est déclenchée.

Pour ce faire, retournez à la page Informations de base de votre API Slack. La première case indique "Ajouter des fonctionnalités et des fonctionnalités". Choisissez l'option "Webhooks entrants". En haut à droite de la page Activer les webhooks entrants se trouve un bouton de curseur. Cliquez dessus pour faire passer le bouton de Off à On.

5. 5. Autoriser les notifications de canal

Une fois les Webhooks activés, faites défiler vers le bas et cliquez sur "Ajouter un nouveau Webhook à l'équipe". Vous serez invité à choisir le canal sur lequel vous souhaitez que votre bot publie des notifications automatisées. Dans cet exemple, Shevat a choisi #général, mais dans ce cas, vous souhaiterez peut-être publier cette notification sur votre équipe d'assistance ou sur le canal du service informatique. Ainsi, non seulement un nouveau ticket sera créé dans votre plateforme d'assistance, mais une notification automatique sera envoyée au canal Slack du service informatique pour les informer du ticket. Une fois que vous avez choisi votre chaîne, cliquez sur "Autoriser".

6. 6. Personnalisez votre Webhook

Une fois autorisé, vous verrez une URL Webhook de base sur la page et un bouton pour la copier. Au-dessus se trouve votre exemple de requête curl, que vous pouvez copier dans un éditeur de texte pour dire ce que vous voulez. Dans ce scénario, au lieu de "Hello, World", vous pouvez écrire "New Helpdesk Ticket Submitted" ou tout ce qui décrit avec précision les notifications que vous souhaitez que votre bot envoie. À partir de là, vous pouvez prendre votre code de requête curl et l'URL Webhooks et l'exécuter dans n'importe quel script. Vous aurez également besoin de ce code à l'étape suivante.

7. 7. Créez votre robot

Maintenant que vous avez écrit votre code de message et votre URL Webhooks à portée de main, vous êtes prêt à créer votre bot. La plupart des intégrations Slack nécessitent un serveur pour répondre et initier les requêtes, en particulier lorsque la logique de bot automatisée et les commandes slash sont impliquées. Slack prend en charge un certain nombre de fournisseurs, mais Agan a créé le bot du helpdesk en utilisant un service appelé Glitch.

Cette étape nécessite une certaine expertise en codage. Agan a créé un nouveau projet Glitch, puis a commencé à ajouter du code JavaScript open source. Si vous ne voulez pas écrire tout le code vous-même (ou réinventer la roue), vous pouvez choisir parmi d'innombrables frameworks et bibliothèques de bot pour importer votre logique de bot de base.

Agan a nommé son projet "Index.js", a ajouté un package qu'il a lui-même construit appelé TinySpeck, puis a collé le code Message Builder que nous avons écrit plus tôt. Avec le code principal du bot maintenant en place, il a simplement ajouté une commande de rappel pour déclencher un nouveau ticket et le message de confirmation "Un ticket helpdesk a été créé". C'est ça. Si vous souhaitez ajouter votre code Webhooks pour déclencher une notification dans le canal que vous avez désigné, vous pouvez également le coller ici. Glitch crée une URL unique pour votre serveur de bot, alors copiez cette URL une fois que vous avez ajouté tout votre code et nous passons à l'étape suivante.

8. 8. Activer les messages interactifs

Vous avez déjà créé votre bot Helpdesk, il ne vous reste plus qu'à retourner dans l'API. Au lieu de choisir "Créer une nouvelle application", cliquez simplement sur "Gérer les applications" et choisissez l'application Helpdesk. Sous la page Informations de base, choisissez "Messages interactifs" dans la case Ajouter des fonctionnalités et des fonctionnalités. Une fois sur cette page, cliquez sur "Activer les messages interactifs", collez l'URL de votre serveur à l'étape précédente et enregistrez les modifications.

9. 9. Créer une commande Slash

Une fois cela fait, revenez à la case Ajouter des fonctionnalités et des fonctionnalités et accédez aux commandes Slash. Cliquez sur « Créer une nouvelle commande ». Cela vous amène à une page de formulaire avec quelques champs.

Dans la zone Commande, entrez votre commande barre oblique. Dans ce cas, Agan a tapé "/helpdesk". Dans le champ URL de la demande, il a collé la même URL de serveur de Glitch. Ensuite, tout ce que vous avez à faire est d'entrer une courte description pour la commande ("Créer un ticket d'assistance"), un conseil d'utilisation sur la façon dont l'utilisateur doit saisir sa demande, vérifiez l'aperçu en dessous pour vous assurer que tout semble correct, puis cliquez sur Enregistrer .

10. 10. Installez votre application

Le bot Helpdesk est maintenant prêt à fonctionner. De retour sur la page API principale de votre application, accédez à la page Installer l'application qui se trouve dans le menu Paramètres de gauche. Cliquez sur "Installer l'application dans votre équipe". Cela vous demandera d'autoriser l'application. Une fois que vous le faites, votre bot est en ligne. Vous verrez un vert "Succès !" ruban de notification au sommet de votre écran qui confirme que votre bot est installé.

11. 11. Faites tourner votre bot

De retour dans le client Slack de votre équipe, dirigez-vous vers le canal dans lequel vous avez désigné pour mettre votre nouveau bot au travail. Entrez la commande slash avec une requête, par exemple : "/helpdesk mon Wi-Fi est cassé." Vous serez alors invité avec un bouton pour créer un ticket d'assistance. Toutes nos félicitations; vous venez de créer un bot Slack qui fonctionne !