> For the complete documentation index, see [llms.txt](https://ask.birdie.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ask.birdie.ai/integrations-and-data-ingestion/how-to-integrate-with/slack.md).

# Slack

### Overview

This integration is dedicated to importing Conversations and Conversation Messages from your Slack Workspace into Birdie. Below are key details about what we need to set up the integration and how conversations are imported.

### Requirements

#### Access Tokens

The Slack API uses industry-standard OAuth 2.0 protocol for authentication and authorization, and in order to generate the credentials, your company's targeted Slack Workspace must have an App added to it, with a Bot configured.

#### Using a Slack Bot for Authentication

Due to Slack’s new rate limit policies, each client must now create their own Slack App (Bot) to connect their workspace with Birdie. This ensures proper authentication and helps avoid shared limits across different workspaces.

### Setup in Slack

#### Create a Slack App

{% stepper %}
{% step %}

### Create the App in Slack

* Access <https://api.slack.com/apps> using an admin account in your Slack workspace.
* Click “Create New App” → “From scratch”.
* Choose a name for the app (e.g. Birdie App) and select your Slack workspace.
* Click Create App.

![](https://tawk.link/685001d2e1d1cb19110409b6/kb/attachments/xBMY9shyCi.png)

![](https://tawk.link/685001d2e1d1cb19110409b6/kb/attachments/DVjA_phiui.png)

![](https://tawk.link/685001d2e1d1cb19110409b6/kb/attachments/96l07qwSRf.png)
{% endstep %}
{% endstepper %}

#### Configure OAuth & Permissions

{% stepper %}
{% step %}

### Open OAuth & Permissions

* In the left sidebar of your Slack App settings, go to “OAuth & Permissions”.
  {% endstep %}

{% step %}

### Add Bot Token Scopes

Under Scopes, add the following Bot Token Scopes:

* `channels:history`
* `channels:read`
* `groups:history`
* `groups:read`
* `metadata.message:read`

![](https://tawk.link/685001d2e1d1cb19110409b6/kb/attachments/TgI5Oj65gu.png)
{% endstep %}
{% endstepper %}

#### Install the App to Your Workspace and Get its Access Token

{% stepper %}
{% step %}

### Install the App

* In your Slack App settings, go to OAuth & Permissions.
* Scroll down to the section “OAuth Tokens for Your Workspace”.
* Click the Install to \[Your Workspace Name] button.
* Slack will ask you to review the requested permissions: click Allow to confirm.

![](https://tawk.link/685001d2e1d1cb19110409b6/kb/attachments/heeyt25-hQ.png)
{% endstep %}

{% step %}

### Get the OAuth Access Token

* Once the installation is complete, Slack will automatically generate an OAuth Access Token for your app.
* You’ll find it in the same section under “OAuth Tokens for Your Workspace”.

![](https://tawk.link/685001d2e1d1cb19110409b6/kb/attachments/Bi7YnLB5lG.png)

{% hint style="warning" %}
Important: Please copy and share this Access Token securely with Birdie’s integration team. This token allows Birdie to connect to your workspace and import conversation data.
{% endhint %}
{% endstep %}
{% endstepper %}

#### Add the Bot to Desired Channels

{% stepper %}
{% step %}

### Invite the Bot to a Channel

* Open Slack and navigate to the desired channel.
* Use the /invite command in the channel to add the bot:

```
/invite @Birdie Bot
```

* For private channels, you need to be an admin or have the required permissions to invite the bot.

![](https://tawk.link/685001d2e1d1cb19110409b6/kb/attachments/UBxmVRMzN6.png)

![](https://tawk.link/685001d2e1d1cb19110409b6/kb/attachments/fK92PyOXHF.png)
{% endstep %}

{% step %}

### Bot Access

The bot will now have access to interact with the channel and retrieve messages if its permissions allow.
{% endstep %}
{% endstepper %}

### Connect to Birdie

After you’ve created your Slack App, configured scopes, installed it to your workspace, and securely shared the OAuth Access Token with Birdie, the Birdie team will configure the connector and confirm once the integration is active.

### Data in scope

Once enabled, the Slack connector imports conversations and messages from the channels where the Birdie bot is installed and invited, subject to the scopes you configured, so they can be analyzed alongside your other feedback sources.


---

# 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://ask.birdie.ai/integrations-and-data-ingestion/how-to-integrate-with/slack.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.