> 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/~/revisions/5vNgx1SBLaM9wSz456q7/integrations-and-data-ingestion/how-to-integrate-with/discord-channels.md).

# Discord channels

### Overview

With Birdie bot for Discord, Birdie can import messages from any channel in your authorized Discord server.

Ideally, each conversation must be organized into a thread to keep the conversation context as Birdie reads individual messages, but Birdie will also import loose/individual messages in the channel as feedback into your account.

### Requirements

* User with Discord admin role
* Authorize Birdie bot
* Provide channel names for setup

### Setup in Discord (authorize Birdie bot)

{% stepper %}
{% step %}

### Access the Birdie bot page

Open the Birdie bot authorization link while logged in as a Discord admin user:

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

Click Continue to Discord.

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

{% step %}

### Select your Discord server

Choose the Discord server from the list you have access to.

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

{% step %}

### Grant permissions

Make sure you have all options checked. Birdie will be able to view and read messages from your channels.

{% hint style="info" %}
Ensure all permission options are selected so Birdie can access and read messages in the channels you want to import.
{% endhint %}

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

{% step %}

### Authorize

Click Authorize, then Done.

![Authorize and Done](https://tawk.link/685001d2e1d1cb19110409b6/kb/attachments/0AECTXY9eD.png)
{% endstep %}

{% step %}

### Share channel names

Now, share the channel names with your Birdie CS agent so they can complete the setup.
{% 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.


---

# 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, and the optional `goal` query parameter:

```
GET https://ask.birdie.ai/~/revisions/5vNgx1SBLaM9wSz456q7/integrations-and-data-ingestion/how-to-integrate-with/discord-channels.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.