> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Intégrer le chatbot EKB à Slack
> Apporter EKB à Slack
L'intégration d'EKB avec Slack apporte un chat intelligent et contextuel directement dans votre espace de travail, permettant aux équipes d'interagir avec votre agent IA sans quitter Slack. Ce guide vous guide dans l'installation de l'application EKB dans Slack, la configuration des autorisations et la mise en place d'un canal pour une communication transparente avec votre agent IA.
Chaque projet EKB ne peut être lié qu'à une seule application Slack. Vous devrez créer une nouvelle application Slack pour chaque projet EKB supplémentaire que vous souhaitez connecter.
## Conditions préalables
* Vous disposez de :
* l'identifiant de votre projet (`project id`)
* un ensemble de **clé API + secret** pour configurer l'application EKB dans Slack
## Installer et configurer l'application EKB dans Slack
1. Allez à [Slack API Apps](https://api.slack.com/apps). Vous devrez peut-être vous connecter à votre espace de travail Slack.
2. Cliquez sur **Create an App**.
3. Sélectionnez **From scratch**.
4. Entrez le **nom de l'application** (par exemple, « EKB Chatbot »).
5. Sélectionnez l'**espace de travail Slack de développement** où vous souhaitez installer l'application.
6. Cliquez sur **Create App**.
7. Dans la section **Basic Information**, notez les valeurs suivantes : `App ID`, `Client ID`, `Client Secret`, `Signing Secret` et `Verification Token`. Vous en aurez besoin à l'étape 11 ci-dessous.
8. Dans la barre latérale gauche, cliquez sur **OAuth & Permissions** :\
a. Cliquez sur **Add Redirect URL** et entrez l'URL suivante :
```text theme={null}
https://ai-api.automationanywhere.com/slack/oauth
```
b. Cliquez sur **Add** puis **Save URLs**. c. Sous **Scopes**, ajoutez les **Bot Token Scopes** suivants :
* `app_mentions:read` – pour permettre au bot de lire les messages où il est mentionné dans les conversations auxquelles l'application participe.
* `channels:history` – pour permettre au bot de voir les messages et autre contenu dans les canaux publics dont l'application est membre.
* `channels:manage` – pour permettre au bot de gérer les canaux, y compris créer, archiver et renommer les canaux.
* `channels:read` – pour permettre au bot de voir les informations de base sur les canaux publics dans un espace de travail.
* `chat:write` – pour permettre au bot d'envoyer des messages en tant que l'application.
* `commands` – pour permettre au bot d'ajouter des commandes slash que les utilisateurs peuvent invoquer.
* `groups:read` – pour permettre au bot de voir les informations de base sur les canaux privés dont l'application est membre.
* `im:history` – pour permettre au bot de voir les messages et autre contenu dans les messages directs dont l'application est membre.
* `im:write` – pour permettre au bot d'envoyer des messages directs en tant que l'application.
* `users.profile:read` – pour permettre au bot de voir les profils des utilisateurs.
* `users:read` – pour permettre au bot de voir les personnes dans un espace de travail.
* `users:read.email` – pour permettre au bot de voir les e-mails des utilisateurs.
9. Cliquez sur **App Home** dans la barre latérale gauche. Sous **Show Tabs**, assurez-vous que **Messages Tab** est activé, ainsi que la case à cocher ci-dessous.
10. Dans la barre latérale gauche, cliquez sur **Slash Commands** :\
a. Cliquez sur **Create New Command**. b. Dans le champ **Command**, entrez `/setup`.\
c. Dans le champ **Request URL**, entrez :
```
https://ai-api.automationanywhere.com/slack/events
```
d. Dans le champ **Short Description**, entrez quelque chose comme « Channel Setup ».\
e. Optionnellement, vous pouvez ajouter une description plus longue dans le champ **Usage Hint**.\
f. Cliquez sur **Save**.
11. Complétez l'URL du point de terminaison API suivante avec les valeurs rassemblées à l'étape 7 :
```
https://ai-api.automationanywhere.com/slack/custom_install/{client_id}/{client_secret}/{signing_secret}/{verification_token}
```
Remplacez `{client_id}`, `{client_secret}`, `{signing_secret}` et `{verification_token}` par les valeurs de votre application Slack trouvées dans la section **Basic Information**.
12. Ouvrez l'URL complétée dans un nouveau navigateur. Cela vous redirigera vers une page avec un bouton **Add to Slack**. Cliquez sur ce bouton pour installer l'application dans votre espace de travail.
13. Vous serez redirigé vers une page demandant l'autorisation d'accéder à votre espace de travail. Cliquez sur **Allow** pour accorder les autorisations nécessaires.
14. Vous devriez voir un message de confirmation indiquant que l'installation a réussi, et vous serez redirigé vers votre espace de travail Slack.
15. Accédez aux **Event Permissions** depuis la barre latérale et procédez comme suit :\
a. Activez **Enable Events**.\
b. Dans le champ **Request URL**, entrez :
```
https://ai-api.automationanywhere.com/slack/events
```
d. Ensuite, allez à **Subscribe to Bot Events** ci-dessous.\
e. Cliquez sur **Add Bot User Event** et ajoutez ces deux événements : `app_mention` et `message.im`.\
f. Cliquez sur **Save Changes**.
16. Accédez à **Interactivity & Shortcuts** depuis la barre latérale et procédez comme suit :\
a. Activez **Interactivity**.\
b. Dans le champ **Request URL**, entrez :
```
https://ai-api.automationanywhere.com/slack/events
```
c. Cliquez sur **Save Changes**.
17. Allez dans votre espace de travail Slack, et vous devriez voir l'application EKB dans la liste des applications de la barre latérale gauche.
L'application est correctement installée dans votre espace de travail Slack ! L'étape suivante consiste à exécuter la commande de configuration pour configurer un canal pour EKB.
## Configurer un canal pour l'application EKB
Pour configurer un canal pour EKB, vous devez exécuter la commande `/setup` dans le canal souhaité. Cette commande configurera le canal pour fonctionner avec EKB.
1. Ouvrez votre espace de travail Slack et accédez au canal où vous souhaitez configurer EKB.
2. Dans la zone de saisie des messages, tapez `/setup` et appuyez sur **Entrée**.
3. Une fenêtre contextuelle apparaîtra, vous invitant à entrer les informations suivantes :
* **Channel** – Sélectionnez le canal que vous souhaitez configurer pour EKB.\\
Si vous souhaitez utiliser l'application dans les messages directs, sélectionnez votre propre nom d'utilisateur.
* **Project ID** : Entrez votre identifiant de projet EKB.
* **API Key** : Entrez votre clé API EKB.
* **API Secret** : Entrez votre secret API EKB.
4. Cliquez sur **Submit** pour terminer le processus de configuration. L'application validera les informations et configurera le canal.
5. Si la configuration réussit, vous verrez un message de confirmation dans le canal indiquant qu'EKB a été configuré avec succès.
EKB est maintenant configuré dans votre canal sélectionné ! Vous pouvez commencer à interagir avec le bot en le mentionnant dans les messages ou en utilisant les commandes slash.