--- parser: v2 auto_validation: true time: 30 tags: [ tutorial>beginner, products>sap-conversational-ai, products>sap-business-technology-platform] primary_tag: products>sap-conversational-ai slug: conversational-ai-deploy-slack canonical_url: https://developers.sap.com/tutorials/conversational-ai-deploy-slack --- # Deploy an SAP Conversational AI Chatbot on Slack Deploy an SAP Conversational AI chatbot on Slack and add it to a Slack channel to respond to user messages. ## Prerequisites - You have created a chatbot to deploy. This tutorial uses the bot created in the tutorial [Consume API Services and Call Webhooks from Your Chatbot](conversational-ai-webhook-api-call). ## You will learn - How to deploy a chatbot to Slack - How to add app to channel - How to talk directly with the app without a channel --- ### Connect with Slack 1. Go to the **Connect** tab. ![Connect tab ](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/connect-slack-open.png) 2. Under **Third party integrations**, click **Slack**. ![Open Slack](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/connect-slack.png) This will open a set of instructions for integrating with Slack, and a place to store tokens for connecting to Slack. But you can follow the instructions in this tutorial instead. ### Create a Slack app 1. Go to . 2. Click **Create App**. ![Create app](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/create-app.png) 3. Enter the following: | Field Name | Value | :------------- | :------------- | App Name | **`Animal Facts`** | Development Slack Workspace | Select your workspace 4. Click **Create App**. Your app is created. ![New app](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/create-app-new-app.png) ### Get credentials 1. In the Slack app page, in the **Basic Information** tab, scroll down to the **App Credentials** section. ![Link text e.g., Destination screen](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/credentials-slack.png) 2. Copy the **Client ID** and **Client Secret** from the Slack app page to the Slack panel in the **Connect** tab in SAP Conversational AI: ![Link text e.g., Destination screen](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/credentials-cai.png) 3. Click **Get Tokens**. This will create OAuth and Event URLs. ![Credentials results](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/credentials-result.png) Hold onto to these URLs because you will need to enter them within your app on Slack. ### Set the OAuth redirect URL 1. In the Slack app page, go to **OAuth & Permissions**. 2. Click **Add New Redirect URL**. ![OAuth](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/oauth-add-url.png) Enter the OAuth URL from SAP Conversational AI, click **Add**, then click **Save URLs**. ### Enable interactivity 1. In the Slack app page, go to **Interactivity & Shortcuts**. ![Interactivity](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/interactive-enable.png) 2. Turn interactivity **On**. 3. Enter the events URL from SAP Conversational AI into the **Request URL**. ![Add request URL](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/interactive-save.png) Click **Save Changes**. ### Add scopes 1. In the Slack app page, go to **OAuth & Permissions**, and scroll down to **Scopes**. ![Scopes](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/scopes.png) 2. Click **Add an OAuth Scope** and add the following scopes: | Scope | | :------------- | | `app_mentions:read` | | `channels:history` | | `chat:write` | | `im:history` | | `users:read` | These give the app permission, for example, to read mentions entered into Slack or to post messages. 3. Scroll to the top and click **Install App to Workspace**, and then click **Allow** to give your app the needed permissions. ### Subscribe to events 1. In the Slack app page, go to **Event Subscriptions**. ![Events](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/events.png) 2. Turn events **On**. 3. Enter the events URL from SAP Conversational AI into **Request URL**. 4. Under **Subscribe to bot events**, and subscribe to events. Click **Add Bot User Event** and add the following events: | Event | | :------------- | | `app_mention` | | `message.im` | | `message.channels` | 5. Click **Save Changes**. ### Add bot to workspace In the Slack panel in the **Connect** tab in SAP Conversational AI, go to step 8 (Add my bot to a slack channel). ![Authorize](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/authorize.png) Click the link. ![Allow](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/authorize-allow.png) Allow the permissions for the app by clicking **Allow**. You should get a success message. ![Allow OK](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/authorize-OK.png) ### Talk to the app directly 1. In Slack, scroll down to **Apps**, click **+** and add the app to your Slack. ![Add app](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/app-add.png) 2. Search for `Animal Facts` and select the app. ![Find app](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/app-find.png) After selecting, the Animal Facts is added to your apps in the Slack navigation panel. It's message screen is also displayed. ![App added](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/app-added.png) 3. Enter the word `cat`, and the bot responds by making an API call to get a fact about cats, and displays in the **Messages** panel. ![App test](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/app-test.png) >Cats can't produce fat!? ### Talk to bot in channel You can also add the app to a channel, so when someone specifically sends a message to the app, the bot processes the message and returns the appropriate response. 1. Go to the channel and open the **Details** panel on the right. >I created a private channel called **Test**. 2. Click **More > Add Apps**, find your app, and to the right click **Add**. ![Add to channel](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/app-add-channel.png) 3. Now you can speak to the bot via direct message. ![Test app in channel](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-slack/app-add-channel-test.png) >Did you know snails are closely related to oysters and clams? ### Test yourself