> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hotglue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

# Connector Details

| Name        | Value                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| :---------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Platform    | [Slack](https://slack.com)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Auth Type   | OAuth                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Direction   | Read                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Tap Repo    | [https://github.com/hotgluexyz/tap-slack](https://github.com/hotgluexyz/tap-slack)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Tap Metrics | <p>Usage: <Tooltip tip="low"><Icon icon="user" iconType="regular" color="#fff" size="14px" /><Icon icon="user" iconType="regular" color="#fff" size="14px" /><Icon icon="user" iconType="regular" color="#A9A9A9" size="14px" /><Icon icon="user" iconType="regular" color="#A9A9A9" size="14px" /></Tooltip><br />Success Rate: <Tooltip tip="medium"><Icon icon="circle-check" iconType="regular" color="#fff" size="14px" /><Icon icon="circle-check" iconType="regular" color="#fff" size="14px" /><Icon icon="circle-check" iconType="regular" color="#A9A9A9" size="14px" /><Icon icon="circle-check" iconType="regular" color="#A9A9A9" size="14px" /></Tooltip></p> |

# Credentials Setup

Follow the steps below to get the credentials you need to use the Slack connector.

The first thing that you need to do to get your Slack OAuth credentials is to head to the [Slack API dashboard](https://api.slack.com). If you do not have a Slack account, you will be prompted to create one.

Once you're on the Slack API dashboard, select **create new app**

![](https://files.readme.io/a36cfc6-Screen_Shot_2022-01-27_at_3.03.52_PM.png)

In the popup, select **Create from scratch**

![](https://files.readme.io/bbb711f-Screen_Shot_2022-01-27_at_3.04.44_PM.png)

Now give your app a name, and pick a Slack workspace to test with, then click Create App

![](https://files.readme.io/cfbe60f-Screen_Shot_2022-01-27_at_3.06.55_PM.png)

From the next screen, select OAuth & Permissions

![](https://files.readme.io/610782b-Screen_Shot_2022-01-27_at_3.07.28_PM.png)

On the OAuth & Permissions page, scroll down to the **Redirect URLs** section, and add `https://hotglue.xyz/callback` as a valid URL and click **Save URLs**

![](https://files.readme.io/57cf0a7-Screen_Shot_2022-01-27_at_3.08.20_PM.png)

Now scroll down to the **Scopes** section. For hotglue to work, you must grant the following scopes:

* `channels:history`
* `channels:join`
* `channels:read`
* `files:read`
* `groups:read`
* `links:read`
* `reactions:read`
* `remote_files:read`
* `remote_files:write`
* `team:read`
* `usergroups:read`
* `users.profile:read`
* `users:read`
* `users:read.email`

![](https://files.readme.io/3108aa5-Screen_Shot_2022-01-27_at_3.16.46_PM.png)

Finally, click on Basic Information in the top left.

![](https://files.readme.io/c78ffbf-Screen_Shot_2022-01-27_at_3.17.48_PM.png)

Now scroll down to the **App Credentials** section. Here you will be able to access the necessary client id and client secret.

![](https://files.readme.io/b00fbd7-Screen_Shot_2022-01-27_at_3.20.20_PM.png)

You can now use these credentials in hotglue to configure your Slack integration!

# Add your Slack bot to a channel

Once a user has authenticated via OAuth with your Slack app, your bot will be available in the apps list of their Slack workspace. But before the bot can read any **messages**, you must first add them in the channels you wish to get messages from.

Go to channel details in Slack and click on **Integrations**

![](https://files.readme.io/084fdd1-Screen_Shot_2022-01-27_at_4.08.44_PM.png)

From here, click on **Add an App**, and select your app in the list

![](https://files.readme.io/b17d136-Screen_Shot_2022-01-27_at_4.09.24_PM.png)

That's it!
