ChatBotKit offers powerful integration with Slack, a popular collaboration and messaging platform for teams. This integration allows users to deploy chatbots on Slack, enabling them to interact with their chatbot directly from within the Slack platform.
Guide d'installation étape par étape
Here is how to integrate ChatBotKit into Slack.
- Allez dans Intégrations et cliquez sur le bouton Slack Bot.
- Fill in the Name and provide your chatbot Backstory
- Vous pouvez également sélectionner le modèle bot, le jeu de données et le jeu de compétences.
- Enregistrez l'intégration en cliquant sur le bouton "Créer".
Jetez un coup d'œil à l'instruction vidéo suivante pour compléter la première phase du processus d'installation :
Once the Slack Integration is created you can install it by pressing the "Install" button. This button will automatically create the Slack Bot for you and set up all developer information. Make sure that you select the workspace where you want to install your chatbot.
La dernière étape consiste à fournir le secret de signature et le jeton du bot Slack.
- Naviguez vers votre Slack Bot (vous l'avez déjà dans un onglet ouvert si vous avez suivi jusqu'ici).
- Allez à "Informations de base".
- Copiez la valeur "Signing Secret" et collez-la dans le champ "Signing Secret".
- Allez dans "OAuth & Permissions".
- Copiez le "Bot User OAuth Token" et collez-le dans le champ "Bot Token". Si vous ne voyez pas le bot token, cliquez d'abord sur le bouton "Install to Workspace".
Voici un tutoriel vidéo sur la façon de compléter la deuxième phase du processus d'installation :
Comment interagir avec votre ChatBotKit Slack Bot
You can invite the chatbot to any channel. To start a new conversation, simply prefix your message with the chatbot's name. For example:
@MyChatBot How is it going?
Peu après, vous verrez une réponse à votre message. La conversation se poursuivra dans le fil de discussion. N'oubliez pas qu'un fil de discussion est une seule conversation. Plusieurs utilisateurs peuvent converser sur le même fil.
Les utilisateurs peuvent également interagir avec le ChatBotKit Slack bot par le biais de messages directs. Il suffit d'ouvrir un message direct avec le bot et de commencer à échanger des messages comme vous le feriez avec n'importe quel autre utilisateur. Le bot répondra en temps réel, comme dans une conversation sur un canal.
Détails de la configuration avancée
La section suivante contient des instructions avancées sur la manière de configurer votre Slack Bot.
Secret de signature du bot Slack
Le Slack Bot Signing Secret est une clé unique utilisée pour vérifier que les demandes entrantes dans votre application proviennent bien de Slack. Il est généré lorsque vous créez votre application Slack et est nécessaire au bon fonctionnement de votre application.
Vous pouvez localiser le secret de signature de Slack Bot en allant dans votre Slack App Dashboard, en sélectionnant votre application, puis en naviguant vers "App Credentials". Le secret de signature se trouve sous "Signing Secret". Vous devrez copier ce secret et le coller dans le champ "Signing Secret" lorsque vous configurerez votre intégration ChatBotKit Slack.
Jeton Bot
Le Bot Token est nécessaire pour authentifier votre chatbot avec Slack. Il est généré lorsque vous installez votre intégration et permet à votre chatbot d'envoyer et de recevoir des messages au sein de la plateforme Slack.
Vous pouvez localiser le bot token en allant dans votre Slack App Dashboard, en sélectionnant votre application, puis en naviguant vers "OAuth & Permissions". Le jeton de robot se trouve sous "OAuth Tokens for Your Workspace" (Jetons OAuth pour votre espace de travail). Vous devrez copier ce jeton et le coller dans le champ "Bot Token" lors de la configuration de votre intégration ChatBotKit Slack.
Abonnements aux événements
Les abonnements aux événements permettent à votre bot Slack ChatBotKit d'écouter certains événements qui se produisent au sein de la plateforme Slack, tels que les événements de message, les événements de mention d'application et les événements de réaction. Pour configurer les abonnements à des événements, allez dans le tableau de bord de votre application Slack, sélectionnez votre application, puis naviguez vers "Abonnements aux événements". Activez les événements, puis ajoutez l'URL suivante à la page "URL de la demande" domaine : https://api.chatbotkit.com/v1/integration/slack/[slackIntegrationId]/événement. Veillez à remplacer le [slackIntegrationId] avec l'identifiant de votre intégration Slack que vous pouvez trouver dans l'URL de votre intégration Slack ChatBotKit.
Abonnement aux événements Événements
Abonnements aux événements Les événements vous permettent de spécifier les événements spécifiques que votre robot ChatBotKit Slack doit écouter. Parmi les exemples d'événements, on peut citer les événements de message, les événements de mention d'application et les événements de réaction. Pour configurer les événements d'abonnement aux événements, allez dans votre Slack App Dashboard, sélectionnez votre application, puis naviguez vers "Abonnements aux événements". Faites défiler vers le bas jusqu'à la rubrique "S'abonner aux événements du Bot" et sélectionnez les événements que vous souhaitez que votre robot écoute. Enregistrez vos modifications et votre robot écoutera désormais les événements spécifiés au sein de la plateforme Slack. Les événements suivants sont nécessaires : app_mention, message.channels, message.groups, message.im, message.npim.
Permissions du robot
Pour vous assurer que votre bot ChatBotKit Slack a les permissions nécessaires pour fonctionner correctement, vous devrez lui accorder les Bot Token Scopes suivants : app_mentions:read, chaîne:histoire, chat:écrire, groupe:histoire, im:histoireet npim:histoire. Vous pouvez attribuer ces champs d'application en allant dans votre Slack App Dashboard, en sélectionnant votre application, puis en naviguant vers "OAuth & Permissions". Faites défiler vers le bas jusqu'à la rubrique "Champ d'application des tokens de bot" et ajoutez les champs d'application nécessaires. Veillez à enregistrer vos modifications une fois que vous avez ajouté les champs d'application.
Accueil de l'application
La fonction App Home de Slack permet aux utilisateurs d'interagir avec votre ChatBotKit Slack bot dans un espace dédié au sein de Slack. Cet espace peut être personnalisé pour afficher des informations et des actions pertinentes pour l'utilisateur, telles que les conversations récentes. Pour configurer l'App Home, allez dans votre Slack App Dashboard, sélectionnez votre application, puis naviguez jusqu'à "App Home". À partir de là, vous pouvez personnaliser la présentation et le contenu de l'App Home de votre bot. Veillez à sélectionner l'option "Autoriser les utilisateurs à envoyer des commandes et des messages Slash à partir de l'onglet Messages" pour permettre aux utilisateurs de discuter directement avec le bot dans leur propre canal privé.
Messages visibles
VisibleMessages offre des capacités de conversation améliorées dans les canaux Slack en considérant un nombre défini de messages précédents dans le canal comme contexte pour les nouvelles interactions utilisateur-bot.
Par défaut, le messages visibles est fixé à 0, ce qui signifie que chaque nouvelle interaction avec le robot démarre une nouvelle conversation sans aucune référence aux messages précédents dans le canal. Cependant, avec cette nouvelle fonctionnalité, les utilisateurs peuvent définir l'indicateur messages visibles à n'importe quel nombre, ce qui permet au robot de prendre en compte les messages les plus récents lorsqu'il entame une conversation.
Par exemple, si messages visibles est fixé à 10le robot considère les dix derniers messages du canal comme faisant partie du contexte de la nouvelle conversation. Cela signifie que si un utilisateur partage un "mot secret" comme "avocat" dans l'un des dix derniers messages, et qu'il interroge ensuite le robot sur ce "mot secret", le robot en déduira correctement que le mot secret est "avocat".
This enhanced contextual understanding is particularly beneficial in support channels where error messages are shared via Slack webhooks. With the new feature enabled, users can ask the ChatBotKit AI bot to interpret and explain these error messages. The bot will be able to understand the messages by considering them as part of the context, offering valuable assistance and insight in real-time.
Formatage
Le bot ChatBotKit Slack prend en charge toutes les options de formatage avancées, y compris . Cela inclut italique, audacieux, barréet code. Des liens hypertextes peuvent également être inclus dans les messages. Les images sont prises en charge et le robot peut également reconnaître les codes emoji intégrés à Slack. Par exemple, il suffit de taper :smile : s'affichera sous la forme d'un emoji souriant dans Slack. Cela permet une expérience conversationnelle riche et engageante.
Dépannage
Mon robot ne répond pas aux messages du fil de discussion
Ce problème peut être dû à un manque de permissions. Assurez-vous que votre bot dispose des champs d'application nécessaires pour les jetons de bot, tels que app_mentions:read, chaîne:histoire, chat:écrire, groupe:histoire, im:histoireet npim:histoire. Vous pouvez attribuer ces champs d'application en allant dans votre Slack App Dashboard, en sélectionnant votre application, puis en naviguant vers "OAuth & Permissions". Faites défiler vers le bas jusqu'à la rubrique "Champ d'application des tokens de bot" et ajoutez les champs d'application nécessaires. Veillez à enregistrer vos modifications une fois que vous avez ajouté les champs d'application.
Je ne peux pas envoyer de message à mon chatbot directement via l'écran d'accueil de l'application
Pour résoudre ce problème, veuillez vérifier la section App Home dans votre tableau de bord Slack App et assurez-vous que l'option "Allow users to send Slash commands and messages from the messages tab" (Autoriser les utilisateurs à envoyer des commandes et des messages Slash à partir de l'onglet des messages ) est sélectionnée. Cela permettra aux utilisateurs de discuter directement avec le robot dans leur propre canal privé.