From 3a6dc2726e501dc45dc877953c79fe2fb02780c5 Mon Sep 17 00:00:00 2001
From: Alex Rodriguez <alex@techdocs.studio>
Date: Fri, 3 Apr 2026 18:54:17 +0200
Subject: [PATCH 1/6] docs: document Slack integration

---
 docs/integrations/slack.md | 77 ++++++++++++++++++++++++++++++++++++++
 sidebars.js                |  1 +
 2 files changed, 78 insertions(+)
 create mode 100644 docs/integrations/slack.md

diff --git a/docs/integrations/slack.md b/docs/integrations/slack.md
new file mode 100644
index 0000000..57c285b
--- /dev/null
+++ b/docs/integrations/slack.md
@@ -0,0 +1,77 @@
+---
+sidebar_label: Slack
+description: Connect your Biel.ai project to Slack so users can ask questions and get AI-powered answers directly from any Slack channel or DM.
+sidebar_position: 4
+---
+
+# Slack integration
+
+Connect your Biel.ai project to Slack and let users interact with your documentation bot directly from any channel or direct message. The bot answers questions using your indexed documentation, with full source citations.
+
+## What you can do
+
+- **Answer questions in channels** — users mention `@Biel.ai` and get an instant answer
+- **Direct message support** — users chat with the bot privately without leaving Slack
+- **Cited sources** — every answer includes links to the relevant documentation pages
+- **Per-project routing** — each Slack workspace connects to a specific Biel.ai project
+
+## Prerequisites
+
+Before starting, ensure you have:
+
+- A **Biel.ai account** with at least one project and indexed documentation
+- A **Slack workspace** where you have permission to install apps
+- Admin access to your Biel.ai dashboard
+
+## Setup
+
+### 1. Connect your Slack workspace
+
+1. In the Biel.ai dashboard, open the project you want to connect
+2. Go to **Settings** → scroll down to the **Integrations** section
+3. Click **Add to Slack**
+4. You will be redirected to Slack's authorization screen — review the permissions and click **Allow**
+5. Once authorized, Slack redirects back to Biel.ai and the workspace is connected
+
+### 2. Invite the bot to a channel
+
+After connecting, invite the bot to any channel where you want it to respond:
+
+```
+/invite @Biel.ai
+```
+
+For direct messages, users can find the bot by searching its name in the Slack search bar.
+
+### 3. Start asking questions
+
+**In a channel** — mention the bot followed by your question:
+
+```
+@Biel.ai how do I authenticate with the API?
+```
+
+**In a direct message** — just send your message directly, no mention needed:
+
+```
+What are the system requirements?
+```
+
+The bot will respond with an AI-generated answer and a list of source links from your documentation.
+
+## Supported event types
+
+| Event | Description |
+|-------|-------------|
+| `app_mention` | User mentions `@Biel.ai` in a channel |
+| `message.im` | User sends a direct message to the bot |
+
+## Troubleshooting
+
+**The bot does not respond to mentions**
+
+Make sure the bot has been invited to the channel with `/invite @Biel.ai`. The bot can only see messages in channels it has been added to.
+
+---
+
+Need help? [Contact us](https://biel.ai/contact) or visit the [support page](/support).
diff --git a/sidebars.js b/sidebars.js
index 727bdf2..515a9b0 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -147,6 +147,7 @@ const sidebars = {
         'integrations/mcp-server',
         'integrations/github-workflow',
         'integrations/custom-gpt',
+        'integrations/slack',
         'integrations/zapier',
         'integrations/make',
         'integrations/n8n',

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 2/6] 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 667a2ac..7131ec6 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 0000000..b4327e8
--- /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 727bdf2..9f03475 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -150,6 +150,7 @@ const sidebars = {
         'integrations/zapier',
         'integrations/make',
         'integrations/n8n',
+        'integrations/discord',
       ],
     },
     {

From b9460241f61d4eda7f57379da1c93a4f1a671682 Mon Sep 17 00:00:00 2001
From: Alex Rodriguez <alex@techdocs.studio>
Date: Tue, 7 Apr 2026 14:05:32 +0200
Subject: [PATCH 3/6] fix: add code blocks language identifiers

---
 docs/integrations/slack.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/integrations/slack.md b/docs/integrations/slack.md
index 57c285b..8d4e125 100644
--- a/docs/integrations/slack.md
+++ b/docs/integrations/slack.md
@@ -37,7 +37,7 @@ Before starting, ensure you have:
 
 After connecting, invite the bot to any channel where you want it to respond:
 
-```
+```text
 /invite @Biel.ai
 ```
 
@@ -47,13 +47,13 @@ For direct messages, users can find the bot by searching its name in the Slack s
 
 **In a channel** — mention the bot followed by your question:
 
-```
+```text
 @Biel.ai how do I authenticate with the API?
 ```
 
 **In a direct message** — just send your message directly, no mention needed:
 
-```
+```text
 What are the system requirements?
 ```
 

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 4/6] 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 b4327e8..254d755 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?

From 23e8f5617eafd09192a59caeef53e5916b908243 Mon Sep 17 00:00:00 2001
From: Alex Rodriguez <alex@techdocs.studio>
Date: Fri, 10 Apr 2026 20:16:47 +0200
Subject: [PATCH 5/6] docs: document Microsoft Teams integration

---
 docs/integrations.md                 |  7 +++
 docs/integrations/microsoft-teams.md | 74 ++++++++++++++++++++++++++++
 sidebars.js                          |  1 +
 3 files changed, 82 insertions(+)
 create mode 100644 docs/integrations/microsoft-teams.md

diff --git a/docs/integrations.md b/docs/integrations.md
index 667a2ac..626de15 100644
--- a/docs/integrations.md
+++ b/docs/integrations.md
@@ -50,6 +50,13 @@ 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/microsoft-teams">
+      <h2 className="text--truncate" title="Microsoft Teams">Microsoft Teams</h2>
+      <p className="text--truncate" title="Deploy the Biel bot in Microsoft Teams">Deploy the Biel bot in Microsoft Teams</p>
+    </a>
+  </article>
   
 </section>
 
diff --git a/docs/integrations/microsoft-teams.md b/docs/integrations/microsoft-teams.md
new file mode 100644
index 0000000..0a9c696
--- /dev/null
+++ b/docs/integrations/microsoft-teams.md
@@ -0,0 +1,74 @@
+---
+sidebar_label: Microsoft Teams
+description: Deploy the Biel.ai bot in Microsoft Teams so your team can ask questions to your documentation directly from any channel or chat.
+sidebar_position: 6
+---
+
+# Microsoft Teams integration
+
+Deploy the Biel.ai bot in Microsoft Teams so your team can ask questions to your documentation directly from any channel, group chat, or direct message — without leaving Teams.
+
+## Prerequisites
+
+- A [Biel.ai account](https://app.biel.ai) with documentation indexed.
+- A **Business** or **Enterprise** plan.
+- **Teams Administrator** access to your Microsoft 365 organisation.
+
+## Setup
+
+### 1. Get the app package from Biel
+
+Contact the Biel team to receive the `biel-teams-app.zip` package configured for your organisation.
+
+### 2. Upload the app to your Teams Admin Center
+
+A Teams administrator in your organisation must upload the package:
+
+1. Open [Teams Admin Center](https://admin.teams.microsoft.com).
+2. Go to **Teams apps** → **Manage apps** → **Upload new app**.
+3. Upload the `biel-teams-app.zip` file.
+4. Under **Permission policies**, configure which users or groups can install the app.
+
+:::tip
+If your organisation has strict app permission policies, you may need to explicitly allow the Biel app for the relevant users or groups before it becomes discoverable in the Teams app store.
+:::
+
+### 3. Install the bot
+
+Once the app is available in your organisation's catalog, users can find it by searching for **Biel** in the Teams app store and clicking **Add**.
+
+The bot works in:
+
+- **Personal chats** — direct messages to the bot.
+- **Group chats** — add the bot to any group conversation.
+- **Channels** — add the bot to a team channel.
+
+## Usage
+
+Send any message to the bot and it will respond with an answer sourced from your documentation.
+
+```text
+You: How do I reset my password?
+Biel: To reset your password, go to Settings → Security → Reset Password and follow the steps shown.
+```
+
+You can ask follow-up questions and the bot will maintain context within the same conversation thread:
+
+```text
+You: What permissions do I need for that?
+Biel: You need the Account Owner or Admin role to access the Security settings.
+```
+
+## Troubleshooting
+
+**The bot doesn't appear in the app store**
+
+Check that the app has been approved and that the user is covered by the configured permission policy in Teams Admin Center.
+
+**The bot doesn't respond**
+
+Ensure your Biel.ai project has documentation indexed and that the `biel-teams-app.zip` package was provided for your specific project. Contact [Biel support](https://biel.ai) if the issue persists.
+
+**Responses are incorrect or outdated**
+
+Re-index your documentation in the [Biel.ai dashboard](https://app.biel.ai) to make sure the bot is querying the latest content.
diff --git a/sidebars.js b/sidebars.js
index 727bdf2..6f8b472 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -150,6 +150,7 @@ const sidebars = {
         'integrations/zapier',
         'integrations/make',
         'integrations/n8n',
+        'integrations/microsoft-teams',
       ],
     },
     {

From 48cfc65dbefd6e74f4ce61869e73e7151f12a64f Mon Sep 17 00:00:00 2001
From: Alex Rodriguez <alex@techdocs.studio>
Date: Fri, 10 Apr 2026 20:34:13 +0200
Subject: [PATCH 6/6] docs: update integrations sidebar order and integration
 docs

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 docs/integrations.md                 |  7 +++++
 docs/integrations/discord.md         | 40 +++++++++++++++++++--------
 docs/integrations/microsoft-teams.md | 19 +++++++++----
 docs/integrations/slack.md           | 41 +++++++++++++---------------
 sidebars.js                          |  2 +-
 5 files changed, 68 insertions(+), 41 deletions(-)

diff --git a/docs/integrations.md b/docs/integrations.md
index 0ded979..79459c5 100644
--- a/docs/integrations.md
+++ b/docs/integrations.md
@@ -51,6 +51,13 @@ Connect Biel.ai to AI development tools, IDEs, and other platforms to give them
     </a>
   </article>
 
+  <article className="col col--6">
+    <a className="card padding--lg" href="/integrations/slack">
+      <h2 className="text--truncate" title="Slack">Slack</h2>
+      <p className="text--truncate" title="Answer questions from your docs in Slack">Answer questions from your docs in Slack</p>
+    </a>
+  </article>
+
   <article className="col col--6">
     <a className="card padding--lg" href="/integrations/discord">
       <h2 className="text--truncate" title="Discord">Discord</h2>
diff --git a/docs/integrations/discord.md b/docs/integrations/discord.md
index 254d755..d6d55c7 100644
--- a/docs/integrations/discord.md
+++ b/docs/integrations/discord.md
@@ -1,21 +1,29 @@
 ---
 sidebar_label: Discord
-title: Discord Bot Integration for Biel.ai
+title: Discord 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
+# 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.
 
-## Requirements
+## What you can do
+
+- **Slash command** — members use `/ask` to get instant answers from your documentation.
+- **Cited sources** — every answer includes links to the relevant documentation pages.
+- **Works in any channel** — the bot responds wherever it has permission, no setup per channel required.
+
+## 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).
 
-## 1. Connect the bot to your server
+## Setup
+
+### 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**.
@@ -24,11 +32,15 @@ The Biel.ai Discord bot lets members of your server ask questions about your doc
 
 The `/ask` command is registered immediately and available to all members of the server.
 
-## 2. Ask a question
+### 2. Disconnect the bot
+
+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.
+
+## Usage
 
 In any channel in your server, type:
 
-```
+```text
 /ask question: How do I reset my password?
 ```
 
@@ -38,16 +50,20 @@ The bot responds with an answer sourced from your documentation, including links
 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
+**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
+**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](/support).
diff --git a/docs/integrations/microsoft-teams.md b/docs/integrations/microsoft-teams.md
index 0a9c696..ee8f3d6 100644
--- a/docs/integrations/microsoft-teams.md
+++ b/docs/integrations/microsoft-teams.md
@@ -1,6 +1,8 @@
 ---
 sidebar_label: Microsoft Teams
+title: Microsoft Teams Integration for Biel.ai
 description: Deploy the Biel.ai bot in Microsoft Teams so your team can ask questions to your documentation directly from any channel or chat.
+keywords: [microsoft teams bot, teams integration, biel.ai teams, documentation chatbot teams, teams channel bot]
 sidebar_position: 6
 ---
 
@@ -8,6 +10,13 @@ sidebar_position: 6
 
 Deploy the Biel.ai bot in Microsoft Teams so your team can ask questions to your documentation directly from any channel, group chat, or direct message — without leaving Teams.
 
+## What you can do
+
+- **Personal chats** — direct message the bot for quick answers.
+- **Group chats** — add the bot to any group conversation.
+- **Channels** — add the bot to a team channel so everyone can ask questions.
+- **Conversation context** — the bot maintains context within the same conversation thread.
+
 ## Prerequisites
 
 - A [Biel.ai account](https://app.biel.ai) with documentation indexed.
@@ -37,12 +46,6 @@ If your organisation has strict app permission policies, you may need to explici
 
 Once the app is available in your organisation's catalog, users can find it by searching for **Biel** in the Teams app store and clicking **Add**.
 
-The bot works in:
-
-- **Personal chats** — direct messages to the bot.
-- **Group chats** — add the bot to any group conversation.
-- **Channels** — add the bot to a team channel.
-
 ## Usage
 
 Send any message to the bot and it will respond with an answer sourced from your documentation.
@@ -72,3 +75,7 @@ Ensure your Biel.ai project has documentation indexed and that the `biel-teams-a
 **Responses are incorrect or outdated**
 
 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](/support).
diff --git a/docs/integrations/slack.md b/docs/integrations/slack.md
index 8d4e125..1c846c8 100644
--- a/docs/integrations/slack.md
+++ b/docs/integrations/slack.md
@@ -1,6 +1,8 @@
 ---
 sidebar_label: Slack
+title: Slack Integration for Biel.ai
 description: Connect your Biel.ai project to Slack so users can ask questions and get AI-powered answers directly from any Slack channel or DM.
+keywords: [slack bot, slack integration, biel.ai slack, documentation chatbot slack, slack channel bot]
 sidebar_position: 4
 ---
 
@@ -10,28 +12,26 @@ Connect your Biel.ai project to Slack and let users interact with your documenta
 
 ## What you can do
 
-- **Answer questions in channels** — users mention `@Biel.ai` and get an instant answer
-- **Direct message support** — users chat with the bot privately without leaving Slack
-- **Cited sources** — every answer includes links to the relevant documentation pages
-- **Per-project routing** — each Slack workspace connects to a specific Biel.ai project
+- **Answer questions in channels** — users mention `@Biel.ai` and get an instant answer.
+- **Direct message support** — users chat with the bot privately without leaving Slack.
+- **Cited sources** — every answer includes links to the relevant documentation pages.
+- **Per-project routing** — each Slack workspace connects to a specific Biel.ai project.
 
 ## Prerequisites
 
-Before starting, ensure you have:
-
-- A **Biel.ai account** with at least one project and indexed documentation
-- A **Slack workspace** where you have permission to install apps
-- Admin access to your Biel.ai dashboard
+- A [Biel.ai account](https://app.biel.ai) with at least one project and indexed documentation.
+- A **Slack workspace** where you have permission to install apps.
+- Admin access to your Biel.ai dashboard.
 
 ## Setup
 
 ### 1. Connect your Slack workspace
 
-1. In the Biel.ai dashboard, open the project you want to connect
-2. Go to **Settings** → scroll down to the **Integrations** section
-3. Click **Add to Slack**
-4. You will be redirected to Slack's authorization screen — review the permissions and click **Allow**
-5. Once authorized, Slack redirects back to Biel.ai and the workspace is connected
+1. In the Biel.ai dashboard, open the project you want to connect.
+2. Go to **Settings** → scroll down to the **Integrations** section.
+3. Click **Add to Slack**.
+4. You will be redirected to Slack's authorization screen — review the permissions and click **Allow**.
+5. Once authorized, Slack redirects back to Biel.ai and the workspace is connected.
 
 ### 2. Invite the bot to a channel
 
@@ -43,7 +43,7 @@ After connecting, invite the bot to any channel where you want it to respond:
 
 For direct messages, users can find the bot by searching its name in the Slack search bar.
 
-### 3. Start asking questions
+## Usage
 
 **In a channel** — mention the bot followed by your question:
 
@@ -59,19 +59,16 @@ What are the system requirements?
 
 The bot will respond with an AI-generated answer and a list of source links from your documentation.
 
-## Supported event types
-
-| Event | Description |
-|-------|-------------|
-| `app_mention` | User mentions `@Biel.ai` in a channel |
-| `message.im` | User sends a direct message to the bot |
-
 ## Troubleshooting
 
 **The bot does not respond to mentions**
 
 Make sure the bot has been invited to the channel with `/invite @Biel.ai`. The bot can only see messages in channels it has been added to.
 
+**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](/support).
diff --git a/sidebars.js b/sidebars.js
index ee47846..6d42dd9 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -147,10 +147,10 @@ const sidebars = {
         'integrations/mcp-server',
         'integrations/github-workflow',
         'integrations/custom-gpt',
-        'integrations/slack',
         'integrations/zapier',
         'integrations/make',
         'integrations/n8n',
+        'integrations/slack',
         'integrations/discord',
         'integrations/microsoft-teams',
       ],