Slack OAuth Connection Guide

Follow these steps to configure a Slack OAuth integration for AINexLayer.

Step 1: Creating a New Slack Application

1. Go to api.slack.com/apps
2. Click "Create New App"
3. Choose "From scratch" to manually configure your app

Step 2: Naming Your App & Selecting Workspace

1. Enter App Name: AINexLayer
2. Choose the workspace where you'll develop your app
3. Click "Create App"

Step 3: Obtaining App Credentials

After creating the app, navigate to the Basic Information page to find your credentials:

1. Copy your Client ID
2. Copy your Client Secret (click Show to reveal)

Step 4: Configuring Redirect URLs

1. In the left sidebar, click "OAuth & Permissions"
2. Scroll down to Redirect URLs
3. Click "Add New Redirect URL"
4. Enter: https://localhost:8000/api/v1/auth/slack/connector/callback
5. Click "Add", then "Save URLs"

Step 5: Setting Up Bot Token Scopes

On the same OAuth & Permissions page, scroll to Scopes and add the following Bot Token Scopes:

Click "Add an OAuth Scope" to add each scope.

Step 6: Enabling Public Distribution

1. In the left sidebar, click "Manage Distribution"
2. Under Share Your App with Other Workspaces, ensure distribution is enabled
3. You can use the "Add to Slack" button or Sharable URL to install the app

Deploying AINexLayer with Slack Connector

Add the Slack credentials to your .env file (created during Docker installation):

SLACK_CLIENT_ID=your_slack_client_id
SLACK_CLIENT_SECRET=your_slack_client_secret
SLACK_REDIRECT_URI=http://localhost:8000/api/v1/auth/slack/connector/callback

Then restart the services:

docker compose up -d