Intégrer le chatbot EKB à Slack

​

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. 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 :
   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.

​

Configurer un canal pour l’application 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.