The Bot Platform

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.

Head over to <a href="https://api.slack.com/apps" rel="nofollow noopener noreferrer" target="_blank">https://api.slack.com/apps</a>:

1. Sign in to your Slack workspace.
2. Head over to <a href="https://api.slack.com/apps" rel="nofollow noopener noreferrer" target="_blank">https://api.slack.com/apps</a>:

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

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!

1. Click ‘Create New App’, then ‘From Scratch’.
2. 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!
3. Click ‘Create App’.

Navigate to the ‘OAuth &amp; Permissions’ page.

Scroll until you see the ‘Scopes’ section.

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

1. Navigate to the ‘OAuth &amp; 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

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

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

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

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.

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.

Navigate to the ‘App Home’ page.

Scroll until you see the ‘Show Tabs’ section.

Enable the ‘Messages Tab’ toggle.

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

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.

Navigate to the ‘Event Subscriptions’ page.

Click the ‘Enable Events’ toggle.

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

<a href="https://app.thebotplatform.com/slack/8929f8672d308b8aa4ea4b169c10f89a" rel="nofollow noopener noreferrer" target="_blank">https://app.thebotplatform.com/slack/8929f8672d308b8aa4ea4b169c10f89a</a>

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.
 <a href="https://app.thebotplatform.com/slack/8929f8672d308b8aa4ea4b169c10f89a" rel="nofollow noopener noreferrer" target="_blank">https://app.thebotplatform.com/slack/8929f8672d308b8aa4ea4b169c10f89a</a>
4. You should have a green verified tick.

As you are in the ‘Event Subscriptions’ page:

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

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

Click the green ‘Save Changes’ button.

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.

Navigate to the ‘Interactivity &amp; Shortcuts’ page.

Click the ‘**Interactivity’ toggle.

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

1. <a href="https://app.thebotplatform.com/slack/f26a78c790feff19a8c09eab6e729a77" rel="nofollow noopener noreferrer" target="_blank">https://app.thebotplatform.com/slack/f26a78c790feff19a8c09eab6e729a77</a>

1. Navigate to the ‘Interactivity &amp; Shortcuts’ page.
2. Click the ‘**Interactivity’ toggle.
3. In the ‘Request URL’ box, enter the following URL:
 1. <a href="https://app.thebotplatform.com/slack/f26a78c790feff19a8c09eab6e729a77" rel="nofollow noopener noreferrer" target="_blank">https://app.thebotplatform.com/slack/f26a78c790feff19a8c09eab6e729a77</a>
4. Click ‘Save Changes’.

Navigate to the ‘Basic Information’ page.

Scroll until you see the ‘App Credentials’ section.

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.

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.

Scroll until you see the ‘Display Information’ section.

Edit App name, Short description, App icon &amp; Preview, Background colour, and/or Long description, and Save changes.

1. Navigate to the ‘Basic Information’ page.
2. Scroll until you see the ‘Display Information’ section.
3. Edit App name, Short description, App icon &amp; Preview, Background colour, and/or Long description, and Save changes.

Create an app

Add scopes

Set up permissions

Enable Messages

Enable webhook

Subscribe to Bot Events

Interactivity & Shortcuts

Bot Credentials

Change your Slack app's details