> 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. Select **Integration Store**.
6. In the **Slack** tile, click **Add**. The **Integrations in this module** tab is displayed.
7. In the **Slack** tile, click **Configure**.&#x20;
8. 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**.
9. If the test passes move to the below step.
10. 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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://prohelp.assetpanda.com/integrations-store/collaboration/slack-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.