Self-hosted Slack integration

The following steps will guide you through the simple process of creating a Slack application.

  1. Go to the Slack developer portal and click on Create New App.
  2. It will ask you whether you want to do it from scratch, or from an app manifest. Select manifest and then select your workspace. The manifest is the following:
display_information:
  name: Crowd.dev - {your-community} 
features:
  bot_user:
    display_name: Crowd.dev - {your-community}
    always_online: true
oauth_config:
  redirect_urls:
    - https://{API-URL}/api/slack/callback
    - https://localhost/api/slack/callback
  scopes:
    user:
      - channels:history
      - channels:read
      - reactions:read
      - users:read
      - users:read.email
    bot:
      - channels:history
      - channels:join
      - channels:read
      - reactions:read
      - users:read
      - users:read.email
      - files:read
settings:
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false
  1. You will need to change {your-community} and {API-URL} for your own values. If you are not looking to deploy the app and only want to run it locally, please remove the first redirect URL.
  2. When the manifest is ready, click Next and Create.
  3. Once it is created, click on Install to Workspace to install it to your workspace.
  4. Copy the environment variables:
  • Navigate to Basic information and go to App Credentials
  • Copy to backend/.env.override.local (for local development) or make sure that these environment variables are available to services:
    • Client ID -> CROWD_SLACK_CLIENT_ID
    • Client Secret -> CROWD_SLACK_CLIENT_SECRET
1784

Now you can connect your Slack Integration in your deployment of crowd.dev! You can now follow the steps in Slack integration to connect it.