# Slack Integration with Pandium

We will use the Slack Web API for this integration, so you will need to obtain credentials for it. These will be used to provision your integration on Pandium.

## Steps to Integrate

1. Within [this Slack Quickstart Guide](https://api.slack.com/start/quickstart) and follow the steps for:
   - Creating an app.
   - Requesting scopes: for _Bot Token Scopes_ choose **chat:write** and **users:read**.

There is no need to install or authorize your app through Slack because Pandium will do that when you connect a tenant.

2. On your Slack app's _OAuth & Permissions_ page go to the _Redirect URLs_ section and add https://api.sandbox.pandium.com/v0/author/callback/oauth2

3. On the _Basic Information_ page go to the _App Credentials_ section and make note of the _Client ID_ and _Client Secret_. These will be needed to provision your integration on Pandium.

4. Confirm that your app has the necessary bot configuration by navigating to the App Home page in your Slack app settings.

5. On the App Home page, ensure your bot user is configured:
   - Find the Your App's Presence in Slack section and verify a bot user exists. If no bot user exists, make sure to double check scopes and a redirect URL were added as part of steps 1 & 2.
   - If you wish to modify your bot Display Name and Default username for the App's bot, click Edit next to "App Display Name".

Now that you have Slack credentials we can use those to set up an integration on your Pandium Sandbox integration hub!
