From e50c02139cbd004266ce2b52f2cb5d4b044237b4 Mon Sep 17 00:00:00 2001
From: Alex Rodriguez <alex@techdocs.studio>
Date: Tue, 7 Apr 2026 13:59:11 +0200
Subject: [PATCH 1/2] docs: document Discord integration

---
 docs/integrations.md         |  9 +++++-
 docs/integrations/discord.md | 53 ++++++++++++++++++++++++++++++++++++
 sidebars.js                  |  1 +
 3 files changed, 62 insertions(+), 1 deletion(-)
 create mode 100644 docs/integrations/discord.md

diff --git a/docs/integrations.md b/docs/integrations.md
index 667a2aca..7131ec60 100644
--- a/docs/integrations.md
+++ b/docs/integrations.md
@@ -50,7 +50,14 @@ Connect Biel.ai to AI development tools, IDEs, and other platforms to give them
       <p className="text--truncate" title="Integrate with n8n workflows">Integrate with n8n workflows</p>
     </a>
   </article>
-  
+
+  <article className="col col--6">
+    <a className="card padding--lg" href="/integrations/discord">
+      <h2 className="text--truncate" title="Discord">Discord</h2>
+      <p className="text--truncate" title="Answer questions from your docs in Discord">Answer questions from your docs in Discord</p>
+    </a>
+  </article>
+
 </section>
 
 
diff --git a/docs/integrations/discord.md b/docs/integrations/discord.md
new file mode 100644
index 00000000..b4327e88
--- /dev/null
+++ b/docs/integrations/discord.md
@@ -0,0 +1,53 @@
+---
+sidebar_label: Discord
+title: Discord Bot Integration for Biel.ai
+description: Add an AI chatbot to your Discord server that answers questions from your documentation using Biel.ai.
+keywords: [discord bot, discord integration, biel.ai discord, documentation chatbot discord, slash command discord, ask bot discord]
+sidebar_position: 6
+---
+
+# Discord bot
+
+The Biel.ai Discord bot lets members of your server ask questions about your documentation directly in any channel using the `/ask` slash command.
+
+## Requirements
+
+- 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).
+
+## 1. Connect the bot to your server
+
+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.
+
+## 2. Ask a question
+
+In any channel where the bot is present, type:
+
+```
+/ask question: How do I reset my password?
+```
+
+The bot responds with an answer sourced from your documentation, including links to the relevant pages.
+
+:::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.
+:::
+
+## Disconnect
+
+To remove the bot from a server, kick it directly from your Discord server settings under **Integrations** > **Bots and Apps**. Biel.ai detects the removal and unlinks the server automatically.
+
+## 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.
diff --git a/sidebars.js b/sidebars.js
index 727bdf2b..9f03475d 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -150,6 +150,7 @@ const sidebars = {
         'integrations/zapier',
         'integrations/make',
         'integrations/n8n',
+        'integrations/discord',
       ],
     },
     {

From c6239a4a76f1a6e00eeca2fbbcad6e71076e2efd Mon Sep 17 00:00:00 2001
From: Alex Rodriguez <alex@techdocs.studio>
Date: Tue, 7 Apr 2026 14:15:10 +0200
Subject: [PATCH 2/2] docs: update discord integration channel usage
 instructions

---
 docs/integrations/discord.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/integrations/discord.md b/docs/integrations/discord.md
index b4327e88..254d755e 100644
--- a/docs/integrations/discord.md
+++ b/docs/integrations/discord.md
@@ -26,7 +26,7 @@ The `/ask` command is registered immediately and available to all members of the
 
 ## 2. Ask a question
 
-In any channel where the bot is present, type:
+In any channel in your server, type:
 
 ```
 /ask question: How do I reset my password?