> For the complete documentation index, see [llms.txt](https://prohelp.assetpanda.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prohelp.assetpanda.com/integrations-store/collaboration/slack-integration.md).

# Slack integration

The Slack integration enables real-time notifications to be triggered through automation rules and delivered from Asset Panda to specific Slack users or channels. This integration provides instant updates into asset-related activities and supports faster decision-making. It improves communication and helps teams stay aligned by delivering updates where they already collaborate.

## Prerequisites

* Active Asset Panda subscription with Admin access
* Slack workspace with permission to install apps
* Slack account with admin role or permission to install and configure Slack apps
* Slack Bot Token Scopes and User Token Scopes
* User and bot must be manually invited to each private channel where notifications should be delivered. 

{% hint style="info" %}
To invite a bot:

* Select a channel, go into integrations, and then add the app.
* @mention the bot by name in the channel.
  {% endhint %}

***

## Slack tasks <a href="#slack-tasks" id="slack-tasks"></a>

{% hint style="info" %}
All setup actions for Slack must be performed using the Slack API portal: <https://api.slack.com/apps>.
{% endhint %}

### Create a Slack app <a href="#slack-app" id="slack-app"></a>

1. Go to <https://api.slack.com/apps>.
2. Click **Create New App.**
3. Select **From scratch.**
4. Enter an app name (for example, `AssetPandaNotification`).
5. Select the workspace where the app will be used.
6. Click **Create App.**

***

### Configure Bot and User Token Scopes  <a href="#slack-token" id="slack-token"></a>

1. In the app dashboard, open **OAuth & Permissions**.
2. Scroll to the **Bot Token Scopes** section.
3. Add the following scopes:

| Scope               | Description                                             |
| ------------------- | ------------------------------------------------------- |
| `chat:write`        | Send messages as the bot.                               |
| `chat:write.public` | Send messages to channels where the bot isn't a member. |

4. Scroll to the **User Token Scopes** section.
5. Add the following scopes:

| Scope                 | Description                                                  |
| --------------------- | ------------------------------------------------------------ |
| `channels:read`       | View basic information about public channels in a workspace. |
| `groups:read`         | View basic information about a user’s private channels.      |
| `search:read.private` | Search a workspace's content in private channels.            |
| `search:read.public`  | Search a workspace's content in public channels.             |
| `search:read.users`   | Search a workspace's users.                                  |

{% hint style="info" %}
To allow access to private channels, invite the user and bot manually to each channel after the app is installed.
{% endhint %}

***

### Install the Slack app&#x20;

1. In **OAuth & Permissions**, go to the **OAuth Tokens for Your Workspace**.
2. Click **Install App to Workspace**.
3. Review the requested permissions and click **Allow**.
4. Copy the generated **User OAuth Token** and **Bot User OAuth Token**.

{% hint style="info" %}
Store the tokens in a secure location. These tokens are required during the integration setup in Asset Panda Pro.
{% endhint %}

***

## Asset Panda tasks <a href="#adding-integration" id="adding-integration"></a>

### Add the Slack integration <a href="#adding-integration" id="adding-integration"></a>

1. Log into Asset Panda Pro with an administrator account
2. Navigate to <img src="/files/dLHka5YWbUR3zisHLua6" alt="Settings icon" data-size="line"> **Settings** > **Account Management**.
3. Expand the appropriate account and module.
4. Click **Manage** in the **Integrations** card.
5. In the **Slack** tile, click **Add**, and then click **Edit**.
6. Authenticate the Slack connection:
   1. Paste the **User OAuth Token** and **Bot User OAuth Token** obtained from the Slack API portal.
   2. Click **Test and save connection**.
7. If the test passes move to the below step.
8. Create an automation to enable notifications to be sent using Slack:

   * Select **Slack notification** as the **Notification Type**.&#x20;
   * Select the relevant Slack users or channels as the recipient.

   See [Create an automation](/settings/account-management/automations.md#create-an-automation).<br>