Docs
Setting Up Your Slack Bot

Setting Up Your Slack Bot

A guide to creating a Slack bot, obtaining its token, and configuring basic permissions.

This guide will walk you through the process of creating a Slack bot, obtaining its token, and setting up basic permissions. Once you have the token, you'll be able to use it in your dashboard to enable Slack integration.

Step 1: Create a Slack App

  1. Go to the Slack API website and sign in to your Slack account.
  2. Click on "Create New App" and choose "From scratch".
  3. Give your app a name and select the workspace where you want to develop it.
  4. Click "Create App".

Step 2: Configure Bot User

  1. In the left sidebar, under "Features", click on "OAuth & Permissions".
  2. Scroll down to "Scopes" and add the following Bot Token Scopes:
    • chat:write (to send messages)
    • channels:read (to get channel IDs)
  3. Scroll up to "OAuth Tokens for Your Workspace" and click "Install to Workspace".
  4. Authorize the app for your workspace.

Step 3: Obtain Bot Token

  1. After installation, you'll be redirected to the "OAuth & Permissions" page.
  2. Under "OAuth Tokens for Your Workspace", you'll see your "Bot User OAuth Token". This is the token you'll need to save in your dashboard.

Step 4: Add Bot to Channels

  1. In your Slack workspace, go to the channel where you want to add the bot.
  2. Type /invite @YourBotName and send the message.
  3. The bot will be added to the channel.

Step 5: Get Channel ID

To get a channel ID:

  1. Right-click on the channel name in Slack.
  2. Select "Copy link" from the context menu.
  3. The channel ID is the last part of the URL after the last /.

Step 6: Save Token in Dashboard

  1. Go to your application's dashboard.
  2. Navigate to the client settings or integration section.
  3. Look for the Slack integration option.
  4. Paste your Bot User OAuth Token into the designated field.
  5. Save your changes.

Using Your Slack Bot

With the token saved, your application can now interact with Slack. You can use the bot to:

  • Send messages to channels it's been added to
  • Retrieve channel information
  • Respond to events (with additional configuration)

Remember to keep your bot token secure and never share it publicly.

For more advanced features and event subscriptions, refer to the Slack API documentation.