> ## Documentation Index
> Fetch the complete documentation index at: https://docs.validio.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrating Slack App to Socket Mode

> Migrate your existing Slack app to Socket Mode for Validio notifications.

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](https://api.slack.com/apps).
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](https://docs.validio.io/docs/integrations/notification-channels/slack.md) 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.