diff --git a/articles/channel-connect-slack.md b/articles/channel-connect-slack.md index ca86355cb..455afd147 100644 --- a/articles/channel-connect-slack.md +++ b/articles/channel-connect-slack.md @@ -21,43 +21,41 @@ Log into Slack and [create a Slack application](https://api.slack.com/applicatio ![Set up bot](~/media/channels/slack-NewApp.png) -## Create application and set redirect URI +## Create application and assign a Development Slack team -![Create app](~/media/channels/slack-CreateApp.png) - -## Create a Slack Bot +Enter an App Name and select a Development Slack Team. If you are not already a member of a Development Slack Team, [create or join a team](https://slack.com/). -![Create bot](~/media/channels/slack-CreateBot.png) - -## Add Interactive Messages (optional) +![Create app](~/media/channels/slack-CreateApp.png) -If your bot will use buttons, select the **Interactive Messages** tab and enable interactive messages. +Completing this process creates your app and generates a Client ID and a Client Secret. -![Enable messages](~/media/channels/slack-EnableMessages.png) +## Add a new Redirect URL -## Configure Interactive Messages (optional) +1. Select the **OAuth & Permissions** tab. +2. Select **Add a new Redirect URL**. +3. Enter https://slack.botframework.com, then click **Add** +4. Click **Save URLs**. -Set the Request URL for Interactive Messages. +![Add Redirect URL](~/media/channels/slack-RedirectURL.png) -![Enable messages](~/media/channels/slack-MessageURL.png) +## Create a Slack Bot User -## Gather credentials -1. Select the **Add Credentials** tab -2. Copy the **Client Id** and **Client Secret**. -3. If you enabled buttons, also copy the **Verification Token for Buttons**. +Click the **Bot Users** tab and then click **Add a Bot User**. -![Gather credentials](~/media/channels/slack-StepAuth.png) +![Create bot](~/media/channels/slack-CreateBot.png) -## Submit credentials +Adding a Bot User allows you to assign a user name for your bot and choose whether it is always shown as online. Click **Add Bot User** to validate your settings, and then click **Save Changes**. -Paste the credentials you copied previously into the appropriate field. -The **Landing Page URL** is optional. You may remove or change it. +![Create bot](~/media/channels/slack-CreateBot-AddBotUser.png) -Click **Submit Slack Credentials**. +## Add and Configure Interactive Messages (optional) -## Enable the bot -Check **Enable this bot on Slack**. Then click **I'm done configuring Slack**. +If your bot will use Slack-specific functionality such as buttons, click the **Interactive Messages** tab and enable interactive messages. -When you have completed these steps, your bot will be successfully configured to communicate with users in Slack. +![Enable messages](~/media/channels/slack-EnableMessages.png) +1. Enter the Request URL for Interactive Messages. The Request URL should be https://slack.botframework.com/api/Actions. +2. Click the **Enable Interactive Messages** button. +3. Click **Save changes** once the URL is successfully validated. +![Enable messages](~/media/channels/slack-MessageURL.png) diff --git a/articles/media/channels/slack-AppCredentials.png b/articles/media/channels/slack-AppCredentials.png new file mode 100644 index 000000000..7c72a20b3 Binary files /dev/null and b/articles/media/channels/slack-AppCredentials.png differ diff --git a/articles/media/channels/slack-CreateApp-AddBotUser.png b/articles/media/channels/slack-CreateApp-AddBotUser.png new file mode 100644 index 000000000..a0df2cbde Binary files /dev/null and b/articles/media/channels/slack-CreateApp-AddBotUser.png differ diff --git a/articles/media/channels/slack-CreateApp.png b/articles/media/channels/slack-CreateApp.png index b5a578af2..0cbd8d5f1 100644 Binary files a/articles/media/channels/slack-CreateApp.png and b/articles/media/channels/slack-CreateApp.png differ diff --git a/articles/media/channels/slack-CreateBot.png b/articles/media/channels/slack-CreateBot.png index 0561f76d6..39d96d1e9 100644 Binary files a/articles/media/channels/slack-CreateBot.png and b/articles/media/channels/slack-CreateBot.png differ diff --git a/articles/media/channels/slack-EnableMessages.png b/articles/media/channels/slack-EnableMessages.png index 31a1789f7..84fb0ed07 100644 Binary files a/articles/media/channels/slack-EnableMessages.png and b/articles/media/channels/slack-EnableMessages.png differ diff --git a/articles/media/channels/slack-MessageURL.png b/articles/media/channels/slack-MessageURL.png index 134bbf622..2b4b2f91a 100644 Binary files a/articles/media/channels/slack-MessageURL.png and b/articles/media/channels/slack-MessageURL.png differ diff --git a/articles/media/channels/slack-RedirectURL.png b/articles/media/channels/slack-RedirectURL.png new file mode 100644 index 000000000..61d8793ec Binary files /dev/null and b/articles/media/channels/slack-RedirectURL.png differ diff --git a/articles/media/channels/slack-SubmitCredentials.png b/articles/media/channels/slack-SubmitCredentials.png new file mode 100644 index 000000000..4f84d517c Binary files /dev/null and b/articles/media/channels/slack-SubmitCredentials.png differ