From d21dfc47118aa340ed61dc3dfc8de3682f5dc376 Mon Sep 17 00:00:00 2001
From: sergeikofman444 <sergeikofman444@gmail.com>
Date: Tue, 24 Mar 2026 14:26:41 -0400
Subject: [PATCH 1/2] initial commit

---
 docs.json                                     |   1 +
 .../assets/icons/discord.svg                  |   6 +
 integrations/integration-guides/discord.mdx   | 122 ++++++++++++++++++
 snippets/integrations/versions.mdx            |   4 +-
 4 files changed, 131 insertions(+), 2 deletions(-)
 create mode 100644 integrations/integration-guides/assets/icons/discord.svg
 create mode 100644 integrations/integration-guides/discord.mdx

diff --git a/docs.json b/docs.json
index 0c98173c..5649c1b1 100644
--- a/docs.json
+++ b/docs.json
@@ -290,6 +290,7 @@
                   "/integrations/integration-guides/canny",
                   "/integrations/integration-guides/chat",
                   "/integrations/integration-guides/chatwoot",
+                  "/integrations/integration-guides/discord",
                   "/integrations/integration-guides/plus-email-notifier",
                   "/integrations/integration-guides/github",
                   "/integrations/integration-guides/gmail",
diff --git a/integrations/integration-guides/assets/icons/discord.svg b/integrations/integration-guides/assets/icons/discord.svg
new file mode 100644
index 00000000..7700ee33
--- /dev/null
+++ b/integrations/integration-guides/assets/icons/discord.svg
@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 127.14 96.36">
+  <defs>
+    <style>.cls-1{fill:#5865f2;}</style>
+  </defs>
+  <path class="cls-1" d="M107.7,8.07A105.15,105.15,0,0,0,81.47,0a72.06,72.06,0,0,0-3.36,6.83A97.68,97.68,0,0,0,49,6.83,72.37,72.37,0,0,0,45.64,0,105.89,105.89,0,0,0,19.39,8.09C2.79,32.65-1.71,56.6.54,80.21h0A105.73,105.73,0,0,0,32.71,96.36,77.7,77.7,0,0,0,39.6,85.25a68.42,68.42,0,0,1-10.85-5.18c.91-.66,1.8-1.34,2.66-2a75.57,75.57,0,0,0,64.32,0c.87.71,1.76,1.39,2.66,2a68.68,68.68,0,0,1-10.87,5.19,77,77,0,0,0,6.89,11.1A105.25,105.25,0,0,0,126.6,80.22h0C129.24,52.84,122.09,29.11,107.7,8.07ZM42.45,65.69C36.18,65.69,31,60,31,53s5-12.74,11.43-12.74S54,46,53.89,53,48.84,65.69,42.45,65.69Zm42.24,0C78.41,65.69,73.25,60,73.25,53s5-12.74,11.44-12.74S96.23,46,96.12,53,91.08,65.69,84.69,65.69Z"/>
+</svg>
diff --git a/integrations/integration-guides/discord.mdx b/integrations/integration-guides/discord.mdx
new file mode 100644
index 00000000..1720bb78
--- /dev/null
+++ b/integrations/integration-guides/discord.mdx
@@ -0,0 +1,122 @@
+---
+title: Discord
+description: Add your bot to Discord using the official integration.
+icon: '/integrations/integration-guides/assets/icons/discord.svg'
+---
+
+{/* vale off */}
+
+import integrationVersions from '/snippets/integrations/versions.mdx'
+import { OpenInHub } from '/snippets/integrations/open-in-hub.jsx'
+import Cards from '/snippets/integrations/cards/botpress/discord.mdx'
+
+<OpenInHub integration={integrationVersions.discord}/>
+
+{/* vale on */}
+
+The official Discord integration allows users to chat with your bot in Discord servers, threads, and direct messages.
+
+## Setup
+
+<Info>
+  You will need:
+
+  - A [published bot](/get-started/quick-start)
+  - A [Discord account](https://discord.com/) with permission to create applications
+</Info>
+
+<Steps>
+  <Step title="Install the integration in Botpress">
+    First, install the integration to your bot:
+
+    1. In Botpress Studio, select **<Icon icon="boxes"/> Explore Hub** in the upper-right corner.
+    2. Search for the **Discord** integration.
+    3. Select **Install Integration**.
+
+    In the **Configuration** menu, you should see one field:
+
+    - **Bot Token**
+
+    Leave it empty for now—you'll come back to it after completing the setup in Discord.
+  </Step>
+  <Step title="Create a Discord application">
+    Next, create a Discord application:
+
+    1. Go to the [Discord Developer Portal](https://discord.com/developers/applications) and sign in.
+    2. Select **New Application** in the top-right corner.
+    3. Give your application a name and select **Create**.
+  </Step>
+  <Step title="Create a bot user">
+    Now, create a bot user for your application:
+
+    1. In your application's left sidebar, select **Bot**.
+    2. Under the bot's username, you can optionally set a custom avatar and display name.
+    3. Under **Privileged Gateway Intents**, enable the following:
+       - **Server Members Intent**
+       - **Message Content Intent**
+    4. Select **Save Changes**.
+  </Step>
+  <Step title="Copy your bot token">
+    Next, copy your bot's token:
+
+    1. Still on the **Bot** page, below **Token**, select **Reset Token** (or **Copy** if a token is already visible).
+    2. Confirm the reset if prompted.
+    3. Copy the token and store it somewhere safe—you will not be able to see it again.
+
+    <Warning>
+      Never share your bot token publicly or commit it to version control. Anyone with access to this token can control your bot.
+    </Warning>
+  </Step>
+  <Step title="Invite the bot to your server">
+    Now, invite the bot to your Discord server:
+
+    1. In the left sidebar, select **OAuth2** > **OAuth2 URL Generator**.
+    2. Under **Scopes**, select:
+       - `bot`
+       - `applications.commands`
+    3. Under **Bot Permissions**, select the permissions your bot requires. At minimum:
+       - **View Channels**
+       - **Send Messages**
+       - **Create Public Threads**
+       - **Create Private Threads**
+       - **Send Messages in Threads**
+       - **Pin Messages**
+       - **Attach Files**
+       - **Read Message History**
+       - **Add Reactions**
+       - **Create Polls**
+    4. Copy the generated URL at the bottom of the page and open it in your browser.
+    5. Select the server you want to add the bot to and select **Authorize**.
+  </Step>
+  <Step title="Configure the integration in Botpress">
+    Finally, configure the integration in Botpress:
+
+    1. In the integration's **Bot Token** field, paste your Discord bot token.
+    2. Select **Save Configuration**.
+  </Step>
+</Steps>
+
+<Check>
+  Your Discord integration is ready—users can now chat with your Botpress bot in Discord servers, threads, and direct messages.
+</Check>
+
+---
+
+## Options
+
+The Discord integration's **Configuration** menu offers a few additional options:
+
+### Custom display name / avatar
+
+- Fill in the **Bot Name** field to display a custom name as the sender in Discord conversations.
+- Fill in the **Bot Avatar URL** field to set a custom image as the bot's Discord avatar.
+
+<Note>
+  The avatar URL must be publicly accessible. Supported formats include PNG, JPG, and GIF.
+</Note>
+
+---
+
+## Cards
+
+<Cards />
diff --git a/snippets/integrations/versions.mdx b/snippets/integrations/versions.mdx
index 60d605eb..c4fb9b58 100644
--- a/snippets/integrations/versions.mdx
+++ b/snippets/integrations/versions.mdx
@@ -176,8 +176,8 @@ export const integrationVersions = {
     "id": "intver_01KGQ972H97YAN3D3KY9425JYN"
   },
   "discord": {
-    "version": "0.3.2",
-    "id": "intver_01J3E7AN39P65XZ0Z00C1ZAHJ9"
+    "version": "0.1.0",
+    "id": "intver_01KKHR3XSD9SQZJ89ZGWJSF3PR"
   },
   "docusign": {
     "version": "2.0.0",

From 4fdcd50ad04bb8e04bbbfeb12c9f32076eac83bb Mon Sep 17 00:00:00 2001
From: sergeikofman444 <sergeikofman444@gmail.com>
Date: Tue, 24 Mar 2026 16:17:42 -0400
Subject: [PATCH 2/2] added correct discord version

---
 integrations/integration-guides/discord.mdx | 2 +-
 snippets/integrations/versions.mdx          | 8 ++++++--
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/integrations/integration-guides/discord.mdx b/integrations/integration-guides/discord.mdx
index 1720bb78..3c6f55b2 100644
--- a/integrations/integration-guides/discord.mdx
+++ b/integrations/integration-guides/discord.mdx
@@ -10,7 +10,7 @@ import integrationVersions from '/snippets/integrations/versions.mdx'
 import { OpenInHub } from '/snippets/integrations/open-in-hub.jsx'
 import Cards from '/snippets/integrations/cards/botpress/discord.mdx'
 
-<OpenInHub integration={integrationVersions.discord}/>
+<OpenInHub integration={integrationVersions['shell/discord']}/>
 
 {/* vale on */}
 
diff --git a/snippets/integrations/versions.mdx b/snippets/integrations/versions.mdx
index c4fb9b58..2360c243 100644
--- a/snippets/integrations/versions.mdx
+++ b/snippets/integrations/versions.mdx
@@ -176,8 +176,8 @@ export const integrationVersions = {
     "id": "intver_01KGQ972H97YAN3D3KY9425JYN"
   },
   "discord": {
-    "version": "0.1.0",
-    "id": "intver_01KKHR3XSD9SQZJ89ZGWJSF3PR"
+    "version": "0.3.2",
+    "id": "intver_01J3E7AN39P65XZ0Z00C1ZAHJ9"
   },
   "docusign": {
     "version": "2.0.0",
@@ -627,6 +627,10 @@ export const integrationVersions = {
     "version": "0.1.9",
     "id": "intver_01KJG7WM4KXXT6KDKPWARH2AH8"
   },
+  "shell/discord": {
+    "version": "0.1.0",
+    "id": "intver_01KKHR3XSD9SQZJ89ZGWJSF3PR"
+  },
   "showpad": {
     "version": "2.0.0",
     "id": "intver_01JFAR2MD45546TPY7V2CPBAMD"