> ## Documentation Index
> Fetch the complete documentation index at: https://hoopdev-fix-add-missing-mechanic-for-session-download-button.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> Review sessions directly from your Slack workspace.

<Frame>
  <img src="https://mintcdn.com/hoopdev-fix-add-missing-mechanic-for-session-download-button/CSN3Tfze1AaWBPxZ/images/integrations/slack-1.png?fit=max&auto=format&n=CSN3Tfze1AaWBPxZ&q=85&s=c4810a99eec0e8ce828985bb80f8f4e1" width="960" height="850" data-path="images/integrations/slack-1.png" />
</Frame>

## Requirements

* Privileges to [create an application on Slack](https://api.slack.com/apps)
* Privileges to install the new app in a workspace
* Admin user on hoop

## App Installation - Slack

1. Create [a slack app from **an app manifest**](https://api.slack.com/apps?new_app=1)
2. Select the workspace > click next > paste the manifest below

<AccordionGroup>
  <Accordion title="slack-manifest.json">
    ```json theme={null}
    {
      "display_information": {
        "name": "hoop",
        "description": "An app to interact with a hoop gateway instance",
        "background_color": "#7a7879"
      },
      "features": {
        "bot_user": {
          "display_name": "Hoop Bot",
          "always_online": true
        },
        "slash_commands": [
          {
            "command": "/hoop",
            "description": "Subscribe to notifications sent by Hoop",
            "usage_hint": "subscribe",
            "should_escape": false
          }
        ]
      },
      "oauth_config": {
        "scopes": {
          "bot": [
            "app_mentions:read",
            "channels:read",
            "chat:write",
            "commands",
            "im:write",
            "channels:manage",
            "groups:write",
            "mpim:write",
            "chat:write.public"
          ]
        }
      },
      "settings": {
        "event_subscriptions": {
          "bot_events": [
            "app_mention"
          ]
        },
        "interactivity": {
          "is_enabled": true
        },
        "org_deploy_enabled": false,
        "socket_mode_enabled": true,
        "token_rotation_enabled": false
      }
    }
    ```
  </Accordion>
</AccordionGroup>

1. Follow the guide and click on **Install to Workspace**
2. Scroll below and create an **App-Level Token** and **copy the token**
   * Token Name: `hoop`
   * Scopes: `connections:write`, `app_configurations:write`
3. Go to **Install App** on the left side bar and copy the **Bot User Oauth Token**

***

Lastly, invite the bot in the slack channel that you wish to receive notifications by typing the name of the bot `@hoop`

<Frame>
  <img src="https://mintcdn.com/hoopdev-fix-add-missing-mechanic-for-session-download-button/CSN3Tfze1AaWBPxZ/images/integrations/slack-2.png?fit=max&auto=format&n=CSN3Tfze1AaWBPxZ&q=85&s=4e377c1a62b1d44921862936fe357aea" width="576" height="204" data-path="images/integrations/slack-2.png" />
</Frame>

## App Installation - Hoop

For this step, you'll need both the Slack bot token and app-level token to configure the plugin. You can obtain these tokens at:

* **SLACK\_BOT\_TOKEN:** `Oauth & Permissions > OAuth Tokens for Your Workspace` (*This is the token created in the app installation process*)
* **SLACK\_APP\_TOKEN:** `Basic Information > App-Level Tokens`

Configure the Slack App:

1. Go to **Integrations** > **Slack** > **Configurations Tab**
2. Type both tokens in the input

<Frame>
  <img src="https://mintcdn.com/hoopdev-fix-add-missing-mechanic-for-session-download-button/CSN3Tfze1AaWBPxZ/images/integrations/slack-configuration.jpg?fit=max&auto=format&n=CSN3Tfze1AaWBPxZ&q=85&s=11199d9622258fa658f3f0c5bdeae9dd" width="2758" height="860" data-path="images/integrations/slack-configuration.jpg" />
</Frame>

Alternatively, it's possible to use the Hoop command line to configure the integration:

```bash theme={null}
# login to your instance
hoop login
# configure the slack integration
hoop admin create plugin slack \
    --overwrite \
    --config SLACK_BOT_TOKEN=xoxb-... \
    --config SLACK_APP_TOKEN=xapp-...
```

## Subscribing to Slack channels

We need to go to the Slack plugin page and access the menu → Manage plugins → Slack.

Then, click on settings and add all the channels (separated by commas) you would like to receive the review from that connection.

<Frame>
  <img src="https://mintcdn.com/hoopdev-fix-add-missing-mechanic-for-session-download-button/CSN3Tfze1AaWBPxZ/images/integrations/slack-3.gif?s=f16226fc7f72f39083021ecab228d7cd" width="960" height="598" data-path="images/integrations/slack-3.gif" />
</Frame>

## Subscribe to Notifications

To subscribe and sign up to receive notifications from the Hoop Bot, type `/hoop subscribe` and access the generated link. After signing in, the user will start to receive notification when there’s a review approved and ready to be executed.

### Subscribing Manually (Optional)

To add approvers who are allowed to review sessions, fetch the user's Slack ID and update it using the command line.

```bash theme={null}
hoop admin create user <approver@domain.tld> --overwrite \
  --groups admin,sre \
  --slackid <SLACK-USER-ID>
```

### Copy the Slack ID

* In the Slack app, click on the top right corner of your profile photo
* Select Profile
* Click on the More options button (see image below) and copy the member’s ID

<Frame>
  <img src="https://mintcdn.com/hoopdev-fix-add-missing-mechanic-for-session-download-button/CSN3Tfze1AaWBPxZ/images/integrations/slack-4.png?fit=max&auto=format&n=CSN3Tfze1AaWBPxZ&q=85&s=21852d21dd64fee097392fa1918dab14" width="480" height="442" data-path="images/integrations/slack-4.png" />
</Frame>

<Info>
  You can copy the ID of other members too on Slack.
</Info>

## Usage

To be able to use it, the review plugins must be enabled for a connection. When trying to interacting with it, it will send a message to the configured slack channel.

**Associate the connection with the `review` and `slack` plugins**

```bash theme={null}
hoop admin create conn bash \
    --overwrite \
    --agent default \
    --reviewers 'admin,sre' \
    --plugin slack \
    -- bash
```

Then, interacting with the connection will send a message to your Slack channel. After it’s approved, it will send a message to the creator.

```bash theme={null}
hoop connect bash
```

```bash theme={null}
hoop exec bash -i 'ls'
```