> 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/discord-channels.md).

# Discord channels

### Overview

With the Birdie bot for Discord, Birdie can import messages from any channel in a Discord server you authorize.

Ideally, each conversation should be organized into a thread so Birdie can preserve the conversation context when importing messages. However, Birdie can also import individual messages posted directly in a channel as feedback.

### Requirements

Birdie's integration with Discord requires:

* A user with a Discord admin role
* Authorization to add the Birdie bot
* Server ID (Guild ID)
* Channel IDs for setup

### Supported Channels

Birdie currently supports the following channel types:

* Text Channels
* Forum Channels

### Setup in Discord

Below is a step-by-step guide to help you set up your Discord → Birdie integration.

{% stepper %}
{% step %}

### Access the Birdie bot page

Open the Birdie bot authorization link while logged in as a Discord administrator and click "Continue to Discord":

<https://discord.com/oauth2/authorize?client\\_id=1301530719788601447\\&permissions=66560\\&integration\\_type=0\\&scope=bot>

<img src="/files/rnBz2AMtkRezyagzPe1v" alt="" width="600">
{% endstep %}

{% step %}

### Select your Discord server

Choose the Discord server you want to enable the bot in.

<img src="/files/21gNd3KwSTwln6u9kMHD" alt="" width="560">
{% endstep %}

{% step %}

### Grant permissions to the bot

Enable "View Channels" and "Read Message History" permissions, then click "Authorize"

<img src="/files/EMrYdQPTYy4kHXn4q8H2" alt="" width="560">
{% endstep %}

{% step %}

### Enable Developer Mode

To retrieve server/channel IDs, you need to enable "Developer Mode" in User Settings (bottom-left corner) > Advanced

<img src="/files/ic3a4KmOpVbDZ38uJFr1" alt="" width="280">

&#x20;

<img src="/files/dCAwonUd9LW6RFWjdgB3" alt="" width="320">

&#x20;

<img src="/files/TU5RVo8tHzhJA0i5RZhP" alt="" width="600">
{% endstep %}

{% step %}

### Share Server/Channel IDs

To obtain the Server ID, click on the server name and click "Copy Server ID"

<img src="/files/j11douKPVn6ufFHStH6l" alt="" width="320">

Then, for each channel you want to monitor, right-click on it and select "Copy Channel ID".

<img src="/files/RYuPo0THZAwCrtHJI69D" alt="" width="320">

{% hint style="info" %}
Birdie can also import data from Forum Channels, each thread is treated as a separate conversation. (To retrieve a forum channel ID, follow the same steps used to retrieve a text channel ID)
{% endhint %}

Once you have the server ID and all the channel IDs, share them with us following our guide: [Securely Sharing Credentials for Data Integration](https://ask.birdie.ai/integrations-and-data-ingestion/securely-sharing-credentials-for-data-integration).
{% endstep %}
{% endstepper %}

### Data in scope

After the integration is configured, Birdie imports messages from the Discord channels you authorize (including threaded conversations and individual messages) so they can be analyzed alongside your other feedback sources.

### Privacy

The bot only requests the permissions necessary to retrieve conversations from your server. These include:

* View Server Channels
* Read Message History


---

# 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/discord-channels.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.