# Discord Integration for Biel.ai

> For the complete documentation index, see [llms.txt](/llms.txt)

> Add an AI chatbot to your Discord server that answers questions from your documentation using Biel.ai.

# Discord integration

The Biel.ai Discord bot lets members of your server ask questions about your documentation directly in any channel using the `/ask` slash command.

![Discord Integration](./images/discord-integration.png)

## What you can do

- **Slash command**: members use `/ask` to get instant answers from your documentation.
- **Works in any channel**: the bot responds wherever it has permission, no setup per channel required.
- **Reset the conversation**: use `/clear` in any channel to start a fresh conversation context.

## Prerequisites

- A [Biel.ai account](https://app.biel.ai) with a project that has indexed content.
- A Discord server where you have **Manage Server** permission (required to authorize bots).

## Setup

1. Go to your project settings in the [Biel.ai dashboard](https://app.biel.ai).
2. Under the **Integrations** section, find the Discord card and click **Add to Discord**.
3. Discord opens an authorization page. Select the server where you want to install the bot and click **Authorize**.
4. After authorizing, you are redirected back to Biel.ai and the bot is connected.

The `/ask` command is registered immediately and available to all members of the server.

## Usage

### Asking questions

In any channel in your server, type:

```text
/ask question: How do I reset my password?
```

The bot responds with an answer sourced from your documentation.

### Starting a new conversation

Biel remembers the previous messages in a channel so it can answer follow-up questions with context. To reset that context and start a fresh conversation, run:

```text
/clear
```

Only you will see the confirmation, and your next `/ask` in that channel starts from scratch.

:::tip[Not getting answers?]
Make sure your Biel.ai project has indexed content. You can check this from the **Sources** tab in your project settings.
:::

## Troubleshooting

**The `/ask` command doesn't appear**

Discord can take a few seconds to register new slash commands. Wait a moment and try again. If it still doesn't appear, try restarting your Discord client.

**The bot doesn't respond**

Check that the bot has **Send Messages** and **Use Application Commands** permissions in the channel. These can be configured in the channel's permission settings.

**The bot gives incorrect or outdated answers**

Re-index your documentation in the [Biel.ai dashboard](https://app.biel.ai) to make sure the bot is querying the latest content.

---

Need help? [Contact us](https://biel.ai/contact) or visit the [support page](https://docs.biel.ai/support.md).