Intégration à Slack

IBM Cloud

Slack est une application de messagerie cloud qui aide les utilisateurs à collaborer les uns avec les autres.

Après avoir créé une action, vous pouvez intégrer votre assistant avec Slack.

Une fois l'assistant intégré, en fonction des événements pour lesquels vous configurez la prise en charge par l'assistant, votre assistant peut répondre aux questions qui sont posées dans des messages directs ou dans des canaux où l'assistant est directement mentionné.

Un exemple et des instructions sur la création d'un Slackbot à l'aide de watsonx Assistant, de Slack et de Db2 sont fournis dans le tutoriel de solution, Build a database-driven Slackbot.

Avant de commencer

Pour intégrer Slack à votre assistant, vous devez disposer d'une application Slack et des rôles et autorisations nécessaires :

Rôles	Droits
Propriétaire de l'espace de travail ou de l'organisation	Afficher les informations Informations sur l'envoi Effectuer des actions

Pour créer une application Slack, voir Démarrage rapide : Démarrer un flux de travail.

Pour plus d'informations sur les rôles et les autorisations, voir Slack-Getting started.

Ajout de l'intégration Slack

Accédez à la page Intégrations en cliquant sur l'icône des intégrations () dans le menu de gauche.
Cliquez sur Ajouter dans la vignette Slack.
Cliquez ensuite à nouveau sur Ajouter.

Premiers pas

La configuration de Slack se fait en quatre étapes :

Configurez votre robot Slack
Connecter watsonx Assistant à Slack
Configurez votre bot Slack
Connectez votre assistant

Configurez votre robot Slack

Rendez-vous sur la page Vos applications sur le site web de Slack, puis cliquez sur l'application que vous souhaitez utiliser ou créez-en une nouvelle.

Connecter watsonx Assistant à Slack

Sur la page des paramètres de l'application Slack, allez dans l'onglet Informations de base et descendez jusqu'à la section Informations d'identification de l'application.
Copiez votre jeton de vérification et collez-le dans la page Configuration de l'assistant.
Sur la page Paramètres de l'application Slack, allez dans Features > OAuth & Permissions et descendez jusqu'à la section Bot Token Scopes.
Cliquez sur Add an OAuth Scope (Ajouter une portée OAuth ) et sélectionnez les portées suivantes :
- app_mentions:read
- chat:write
- im:history
- im:read
- im:write
Faites défiler la page jusqu'à la section Tokens d'accès à votre espace de travail et cliquez sur Installer l'application dans l'espace de travail, puis sur Autoriser.

Vous devriez être redirigé vers la page OAuth & Permissions.
Copiez et collez votre jeton d'accès OAuth de l'utilisateur de Bot dans la page Configuration de l'assistant.
Cliquez sur Next pour continuer.

Configurez votre bot Slack

Copier le site Demande générée URL.
Sur la page Paramètres de l'application Slack, allez dans Features > Abonnements aux événements et activez la bascule Activer les événements on.
Collez le lien URL sous Request URL.

Attendez de voir Verified avec une coche verte à côté de Request URL.
Faites défiler vers le bas et cliquez sur Subscribe to bot events.
Sélectionnez les types d'événements auxquels vous souhaitez vous abonner. Vous devez sélectionner au moins l'un des types suivants :
- message.im : Ecoute les événements de message publiés dans un canal de message direct.
- app_mention : Ecoute uniquement les événements de message qui mentionnent votre application ou votre bot.
  
  Choisissez l'entrée app_mention dans la police normale, pas l'entrée app_mention qui est en gras.
Cliquez sur Enregistrer les modifications.
Sur la page Configuration de l'assistant, cliquez sur Suivant.

Connectez votre assistant

Sur la page Paramètres de l'application Slack, allez dans Features > AppHome et cliquez sur Editer à côté de Nom d'affichage de l'application.
Cliquez sur Sauvegarder une fois les modifications effectuées.
Mettez la bascule Toujours montrer mon bot comme étant en ligne sur on.
Allez dans la section Afficher les onglets et basculez l'onglet Messages sur on.
Cochez la case Autoriser les utilisateurs à envoyer des commandes et des messages Slash à partir de l'onglet messages.
Si vous souhaitez ajouter la prise en charge de l'affichage des boutons, des menus et des options de désambiguïsation dans l'application Slack, procédez comme suit :
1. Allez dans l'onglet Interactivité & Raccourcis et activez la fonctionnalité
2. Collez l' URL votre demande dans le champ de saisie prévu à cet effet.
3. Cliquez sur Enregistrer les modifications.
Sur la page Configuration de l'assistant, cliquez sur Finaliser.

Si une zone token requise pour l'authentification est modifiée, toutes les entrées des zones associées doivent être renseignées et validées à nouveau.

Considérations relatives à l'action

Les réponses enrichies que vous ajoutez à une action sont affichées dans un canal Slack, à l'exception des cas suivants :

Se connecter à un agent en direct: Ce type de réponse est ignoré.
Option : ce type de réponse affiche une liste d'options parmi lesquelles l'utilisateur peut choisir.
- Lorsque l'utilisateur clique sur l'une des options, les sélections existantes disparaissent et sont remplacées par les données générées par la sélection de l'utilisateur. Si vous incluez plusieurs types de réponses dans une même réponse, vous devez placer le type de réponse optionnel à la fin afin d'éviter toute confusion due au mélange des réponses et des entrées de l'utilisateur.
- Si les options sont affichées dans une liste déroulante, chaque valeur d'option peut comporter jusqu'à 75 caractères. Lorsqu'une liste comprend 5 options ou plus, elle est affichée dans une liste déroulante.

Discussion avec l'assistant

Pour démarrer une discussion avec l'assistant, procédez comme suit :

Ouvrez Slack et accédez à l'espace de travail associé à votre application.
Cliquez sur l'application que vous avez créée dans la section Applications.
Discutez avec l’assistant.

L'action de bienvenue n'est pas traitée par l'intégration Slack. Le message de bienvenue n'est pas affiché dans le canal Slack comme dans l'aperçu de l'assistant. Il n'est pas déclenché à partir d'ici car les nœuds associés à la condition spéciale welcome sont ignorés dans les flux d'action démarrés par les utilisateurs. Slack attend que l'utilisateur débute la conversation.

Le flux d'action pour la session en cours est redémarré après 60 minutes d'inactivité (5 minutes pour les plans Lite et Standard). Cela signifie que si un utilisateur cesse d'interagir avec l'assistant, au bout de 60 (ou 5) minutes, toutes les valeurs de variable contextuelles définies lors de la conversation précédente sont définies sur null ou sur leurs valeurs par défaut.