Skip to content

Slack Installation

Ryan Emerle edited this page Jun 16, 2021 · 1 revision

Testing with Slack

To test with Slack you can create yourself a sandbox workspace

Create a Workspace

Go to Slack
Click Create Workspace
01_create_ws.png

Enter your email
02_enter_email.png

Name your workspace
3_name_workspace.png

Create the initial channel
05_name_initial_channel.png

Skip adding invites
06_add_invites.png

Click Let's Go
07_create_complete.png


Create a Bot App

Go to the Slack app with newly created sandbox workspace
Go to Administration->Manage apps
10_manage_apps.png
Click the Build button in the upper right
11_build_app.png
Click Basic app setup
12_basic_api_setup.png
Scroll all the way to the bottom and choose Create a classic Slack app
13_create_classic_app.png
Name the app
14_create_app.png
Click Bots to add a bot 15_create_bot_user.png
Click Add Legacy Bot User 16_add_legacy_bot.png
Name the bot
17_name_legacy_bot.png


Install the App

To make the bot active, we need to install it ot our workspace. Choose Install App. 18_choose_install_app.png
Click Install App to Workspace 19_install_app.png
Allow the bot permissions 20_allow_app.png


Get the API Token

Once the app is installed you can get the API token. You want the Bot User Oauth Access Token. 21_get_token.png

This token should be passed to the bot as the HUBOT_SLACK_TOKEN via an environment variable. This can
be done by setting the environment variable, or by using an .env file with Docker Compose.

If you start up the bot with this token, it will appear in the workspace and you can interact with it.