Slack App Setup

# Hybrid Groups Slack App Setup

1 Welcome
2 Create Slack App
3 Generate App Token
4 Install Slack App

This setup guide will walk you through the process of creating and installing the Hybrid Groups Slack App in your Slack workspace.

The setup requires a Slack account and permission to install apps (most users have this by default).

Create Slack App

To create the Hybrid Groups Slack App an App Configuration Token is required. Follow these steps to create the token:

1. Navigate to Slack Apps

Go to api.slack.com/apps and log in to your Slack account. Find the section Your App Configuration Tokens.

2. Generate your token

Click Generate Token to create a new token pair, then copy the generated Access Token and paste it below.

This token is only used once for app creation and is not stored.

## Slack App Created Successfully!

App Name: Hybrid Groups

Generate App-Level Token

The Hybrid Groups backend requires an App-Level Token to receive events from Slack.

To create this token, click Go to App-Level Tokens at the bottom of this page. You will be redirected to the Slack app settings page. Follow these steps:

1. Go to App-Level Tokens section

In the App-Level Tokens section of your newly created Slack app, click Generate Token and Scopes.

2. Generate your token

Give the token a name (e.g. App Token) and add the connections:write scope. Click Generate to create the token.

3. Copy your token

Copy the generated token and paste it below.

→

Next step

App-Level Token

Install the Slack App

Install the Slack App in your workspace. During the installation process a Bot User OAuth Token is generated. This token is required to perform actions in your Slack workspace.

To start the installation, click Install App in Workspace at the bottom of this page. You will be redirected to the Slack app settings page. Follow these steps:

1. Install your Slack App

Go to the Install App section of your Slack app and click Install to [workspace].

2. Grant permissions

A permissions dialog will appear requesting workspace access. Review the permissions and click Allow to authorize the app.

3. Copy your Bot User OAuth Token

After installation, the OAuth Tokens section displays your Bot User OAuth Token. Copy it and paste it below.

→

Next step

Bot User OAuth Token

## Setup Complete!

Your Slack App was created and configured successfully. Slack App tokens and configuration settings are saved to the application's .env file.

App Name: Hybrid Groups
App User ID:

Next Steps

🐳 Running with Docker

Start the application server:

`docker run -it --rm \
-v [your-data-dir]:/app/.data \
ghcr.io/gradion-ai/hybrid-groups:latest \
server slack`

💻 Running without Docker

Start the Hybrid Groups backend:

`python -m hygroup.scripts.server --gateway slack`

Getting Started

Hybrid Groups is now ready to use in your Slack workspace.

Add the app to any Slack channel from the channel's menu under Open channel details -> Integrations -> Add apps.

Start using Hybrid Groups by following the introduction in the documentation.

You can close this window now.