All Collections
Beta
How to create a Slack bot
How to create a Slack bot

How to connect your bot to Slack

Franz Vitulli avatar
Written by Franz Vitulli
Updated over a week ago

To connect a bot created on The Bot Platform to Slack, you need to create a Slack app first, then set it up as a bot.

Create an app

  1. Sign in to your Slack workspace.

  2. Click ‘Create New App’, then ‘From Scratch’.

  3. Enter a name for your bot and select The Bot Platform as the workplace.
    Protip: use the same name you're going to use for the bot you'll create on The Bot Platform so that you will always know what bot to edit in our powerful CMS!

  4. Click ‘Create App’.

Add scopes

  1. Navigate to the ‘OAuth & Permissions’ page.

  2. Scroll until you see the ‘Scopes’ section.

  3. Click ‘Add an Oauth Scope’, under 'Bot Token Scopes' then select the following:

    1. chat:write

    2. im:history

    3. im:write

    4. users:read

    5. users:read.email

    6. channels:read

Set up permissions

As you are in the ‘OAuth & Permissions’ page:

  1. Scroll until you see the ‘OAuth Tokens for Your Workspace’ section.

  2. Click ‘Install to Workspace’.

  3. Then ‘Allow’ the bot permission to access The Bot Platform workspace.

  4. You’ll then see a ‘Bot User OAuth Token’, copy it and paste it somewhere safe, e.g. a text file you own. You're going to need to enter it in our platform at the end of this process.

Enable Messages

  1. Navigate to the ‘App Home’ page.

  2. Scroll until you see the ‘Show Tabs’ section.

  3. Enable the ‘Messages Tab’ toggle.

  4. Tick the ‘Allow users to send Slash commands and messages from the messages tab’ box.

Enable webhook

  1. Navigate to the ‘Event Subscriptions’ page.

  2. Click the ‘Enable Events’ toggle.

  3. Enter the URL below into the ‘Request URL’ box and hit enter.

  4. You should have a green verified tick.

Subscribe to Bot Events

As you are in the ‘Event Subscriptions’ page:

  1. Scroll until you see the ‘Subscribe to bot events’ section.

  2. Click ‘Add Bot User Event’ and select for ‘message.im’ and 'app_home_opened'.

  3. Click the green ‘Save Changes’ button.

Interactivity & Shortcuts

  1. Navigate to the ‘Interactivity & Shortcuts’ page.

  2. Click the ‘**Interactivity’ toggle.

  3. In the ‘Request URL’ box, enter the following URL:

  4. Click ‘Save Changes’.

Bot Credentials

  1. Navigate to the ‘Basic Information’ page.

  2. Scroll until you see the ‘App Credentials’ section.

  3. Copy the following data:

    1. App ID

    2. Signing Secret

You should also have the Bot OAuth Token from the ‘Slack Bot - Permissions’ step.

Connect your app to The Bot Platform

Once you have App ID, Signing Secret, and Bot OAuth Token you'll be ready to connect your bot on The Bot Platform to your Slack app—The Bot Platform will ask for those three in the connection process.

  1. Head to https://app.thebotplatform.com/ and click "Create a new bot".

  2. Choose a bot template from the library or create a bot from scratch.

  3. Click "Connect to Slack" in the orange banner:

  4. Add the correct information into the three following fields:

    5. Click connect. You bot should now be connected to Slack, so you can start building out your messages. If you have any issues with connecting your bot, please reach out to us via the Intercom widget in the bottom right hand corner of the platform.

Updating your Slack app's details

To edit your bot's name, description, logo and info, follow these steps:

  1. Navigate to the ‘Basic Information’ page.

  2. Scroll until you see the ‘Display Information’ section.

  3. Edit App name, Short description, App icon & Preview, Background colour, and/or Long description, and Save changes. We recommend using a square image measuring 800px x 800px for your logo.

Did this answer your question?