Migrating Slack App to Socket Mode

Validio requires Slack apps to run with Socket Mode enabled for communication. This means that you will need to update existing Slack notification channels to use Slack apps with with socket mode enabled.

To migrate existing Slack apps to use Socket Mode:

  1. Navigate to your existing Slack app in your App Management Dashboard.
  2. Create a Slack App-level token with the connections:write permission.
  3. Enable Socket mode for the slack App.
  4. Add the files:write permission to the bot token and reinstall the app.
  5. Update each notification channel in Validio with the new tokens. See the Slack notification channel guide.

Create a Slack App-level Token

  1. Navigate to Settings > Basic Information > App-Level Tokens, and click Generate Token and Scopes.
  2. In the Generate an app-level token dialog, enter a Token Name.
  3. Under Scopes to be accessed by this token, click Add Scope and add connections:write .
  4. Click Generate. App-level tokens contain the following prefix in their string: xapp-
  5. Copy and save this token to configure the Slack notification channel in Validio.

Enable Socket Mode for the Slack App

Navigate to Settings > Socket Mode > Connect using Socket Mode to enable the feature.

(After the feature is enabled, Slack will prompt you to add a new app-level token. If you already created one with the connections:write permission, you can skip this step.)

Update Bot Token Permissions

  1. Navigate to Features > OAuth & Permissions > Scopes > Bot Token Scopes.

  2. Click Add an OAuth Scope and select files:write.

  3. Under OAuth Tokens, click the button to install the app to your workspace and automatically generate the bot token.

  4. Review the access request to your workspace and click Allow.

    When the bot token is generated, you will see it under Bot User OAuth Token. Bot tokens contain the following prefix in their string: xoxb-

  5. Copy and save this token to configure the Slack notification channel in Validio.