From 3e336830d3f9be705c403081f59560ab275c42db Mon Sep 17 00:00:00 2001
From: Adrian Kahali <adrian.kahali@hotmail.com>
Date: Tue, 20 Jan 2026 11:44:11 -0500
Subject: [PATCH 1/2] fix: move functional integrations and add icons

---
 docs.json                                          |  10 +++++++---
 .../assets/auto-optimize.png                       | Bin
 .../assets/conversation-analyzer-table.png         | Bin
 .../assets/conversation-analyzer.png               | Bin
 .../assets/icons/conversation-analyzer.svg         |  13 +++++++++++++
 .../assets/icons/improvement.svg                   |  11 +++++++++++
 .../assets/icons/knowledge-base-optimization.svg   |   6 ++++++
 .../assets/improvement-integration.png             | Bin
 .../assets/improvement-table-result.png            | Bin
 .../assets/improvement-table.png                   | Bin
 .../assets/improvement-ui-diff.png                 | Bin
 .../assets/improvement-ui.png                      | Bin
 .../assets/kb-optimizer.png                        | Bin
 .../assets/test-after-optimizing.png               | Bin
 .../assets/test-before-optimize.png                | Bin
 .../assets/view-improvement.png                    | Bin
 .../conversation-analyzer.mdx                      |   1 +
 .../improvement.mdx                                |   1 +
 .../introduction.mdx                               |   0
 .../knowledge-base-optimization.mdx                |   1 +
 20 files changed, 40 insertions(+), 3 deletions(-)
 rename integrations/{functional-integrations => integration-guides}/assets/auto-optimize.png (100%)
 rename integrations/{functional-integrations => integration-guides}/assets/conversation-analyzer-table.png (100%)
 rename integrations/{functional-integrations => integration-guides}/assets/conversation-analyzer.png (100%)
 create mode 100644 integrations/integration-guides/assets/icons/conversation-analyzer.svg
 create mode 100644 integrations/integration-guides/assets/icons/improvement.svg
 create mode 100644 integrations/integration-guides/assets/icons/knowledge-base-optimization.svg
 rename integrations/{functional-integrations => integration-guides}/assets/improvement-integration.png (100%)
 rename integrations/{functional-integrations => integration-guides}/assets/improvement-table-result.png (100%)
 rename integrations/{functional-integrations => integration-guides}/assets/improvement-table.png (100%)
 rename integrations/{functional-integrations => integration-guides}/assets/improvement-ui-diff.png (100%)
 rename integrations/{functional-integrations => integration-guides}/assets/improvement-ui.png (100%)
 rename integrations/{functional-integrations => integration-guides}/assets/kb-optimizer.png (100%)
 rename integrations/{functional-integrations => integration-guides}/assets/test-after-optimizing.png (100%)
 rename integrations/{functional-integrations => integration-guides}/assets/test-before-optimize.png (100%)
 rename integrations/{functional-integrations => integration-guides}/assets/view-improvement.png (100%)
 rename integrations/{functional-integrations => integration-guides}/conversation-analyzer.mdx (97%)
 rename integrations/{functional-integrations => integration-guides}/improvement.mdx (97%)
 rename integrations/{functional-integrations => integration-guides}/introduction.mdx (100%)
 rename integrations/{functional-integrations => integration-guides}/knowledge-base-optimization.mdx (95%)

diff --git a/docs.json b/docs.json
index 3d8f0798..326d0809 100644
--- a/docs.json
+++ b/docs.json
@@ -288,7 +288,7 @@
                   "/integrations/integration-guides/bamboohr",
                   "/integrations/integration-guides/canny",
                   "/integrations/integration-guides/chat",
-                  "/integrations/functional-integrations/conversation-analyzer",
+                  "/integrations/integration-guides/conversation-analyzer",
                   "/integrations/integration-guides/chatwoot",
                   "/integrations/integration-guides/plus-email-notifier",
                   "/integrations/integration-guides/github",
@@ -299,11 +299,11 @@
                   "/integrations/integration-guides/hitl",
                   "/integrations/integration-guides/hubspot",
                   "/integrations/integration-guides/hunter",
-                  "/integrations/functional-integrations/improvement",
+                  "/integrations/integration-guides/improvement",
                   "/integrations/integration-guides/instagram",
                   "/integrations/integration-guides/intercom",
                   "integrations/integration-guides/klaviyo",
-                  "/integrations/functional-integrations/knowledge-base-optimization",
+                  "/integrations/integration-guides/knowledge-base-optimization",
                   "/integrations/integration-guides/line",
                   "/integrations/integration-guides/loops",
                   "/integrations/integration-guides/mailerlite",
@@ -644,6 +644,10 @@
     {
       "source": "/for-developers/sdk/:slug*",
       "destination": "/integrations/sdk/:slug*"
+    },
+    {
+      "source": "/integrations/functional-integrations/:slug*",
+      "destination": "/integrations/integration-guides/:slug*"
     }
   ],
   "integrations": {
diff --git a/integrations/functional-integrations/assets/auto-optimize.png b/integrations/integration-guides/assets/auto-optimize.png
similarity index 100%
rename from integrations/functional-integrations/assets/auto-optimize.png
rename to integrations/integration-guides/assets/auto-optimize.png
diff --git a/integrations/functional-integrations/assets/conversation-analyzer-table.png b/integrations/integration-guides/assets/conversation-analyzer-table.png
similarity index 100%
rename from integrations/functional-integrations/assets/conversation-analyzer-table.png
rename to integrations/integration-guides/assets/conversation-analyzer-table.png
diff --git a/integrations/functional-integrations/assets/conversation-analyzer.png b/integrations/integration-guides/assets/conversation-analyzer.png
similarity index 100%
rename from integrations/functional-integrations/assets/conversation-analyzer.png
rename to integrations/integration-guides/assets/conversation-analyzer.png
diff --git a/integrations/integration-guides/assets/icons/conversation-analyzer.svg b/integrations/integration-guides/assets/icons/conversation-analyzer.svg
new file mode 100644
index 00000000..588ec0e0
--- /dev/null
+++ b/integrations/integration-guides/assets/icons/conversation-analyzer.svg
@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none"
+
+    stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"
+    class="lucide lucide-messages-square">
+    <style>
+        path { fill: #24292f; }
+        @media (prefers-color-scheme: dark) {
+          path { fill: #ffffff; }
+        }
+      </style>
+    <path d="M14 9a2 2 0 0 1-2 2H6l-4 4V4a2 2 0 0 1 2-2h8a2 2 0 0 1 2 2z" />
+    <path d="M18 9h2a2 2 0 0 1 2 2v11l-4-4h-6a2 2 0 0 1-2-2v-1" />
+</svg>
\ No newline at end of file
diff --git a/integrations/integration-guides/assets/icons/improvement.svg b/integrations/integration-guides/assets/icons/improvement.svg
new file mode 100644
index 00000000..872be65b
--- /dev/null
+++ b/integrations/integration-guides/assets/icons/improvement.svg
@@ -0,0 +1,11 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-lightbulb">
+    <style>
+        path { stroke: #24292f; }
+        @media (prefers-color-scheme: dark) {
+          path { stroke: #ffffff; }
+        }
+      </style>
+    <path d="M15 14c.2-1 .7-1.7 1.5-2.5 1-.9 1.5-2.2 1.5-3.5A6 6 0 0 0 6 8c0 1 .2 2.2 1.5 3.5.7.7 1.3 1.5 1.5 2.5"/>
+    <path d="M9 18h6"/>
+    <path d="M10 22h4"/>
+</svg>
\ No newline at end of file
diff --git a/integrations/integration-guides/assets/icons/knowledge-base-optimization.svg b/integrations/integration-guides/assets/icons/knowledge-base-optimization.svg
new file mode 100644
index 00000000..df1a5012
--- /dev/null
+++ b/integrations/integration-guides/assets/icons/knowledge-base-optimization.svg
@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-book-up"><style>
+    path { stroke: #24292f; }
+    @media (prefers-color-scheme: dark) {
+      path { stroke: #ffffff; }
+    }
+  </style><path d="M12 13V7"/><path d="M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20"/><path d="m9 10 3-3 3 3"/></svg>
\ No newline at end of file
diff --git a/integrations/functional-integrations/assets/improvement-integration.png b/integrations/integration-guides/assets/improvement-integration.png
similarity index 100%
rename from integrations/functional-integrations/assets/improvement-integration.png
rename to integrations/integration-guides/assets/improvement-integration.png
diff --git a/integrations/functional-integrations/assets/improvement-table-result.png b/integrations/integration-guides/assets/improvement-table-result.png
similarity index 100%
rename from integrations/functional-integrations/assets/improvement-table-result.png
rename to integrations/integration-guides/assets/improvement-table-result.png
diff --git a/integrations/functional-integrations/assets/improvement-table.png b/integrations/integration-guides/assets/improvement-table.png
similarity index 100%
rename from integrations/functional-integrations/assets/improvement-table.png
rename to integrations/integration-guides/assets/improvement-table.png
diff --git a/integrations/functional-integrations/assets/improvement-ui-diff.png b/integrations/integration-guides/assets/improvement-ui-diff.png
similarity index 100%
rename from integrations/functional-integrations/assets/improvement-ui-diff.png
rename to integrations/integration-guides/assets/improvement-ui-diff.png
diff --git a/integrations/functional-integrations/assets/improvement-ui.png b/integrations/integration-guides/assets/improvement-ui.png
similarity index 100%
rename from integrations/functional-integrations/assets/improvement-ui.png
rename to integrations/integration-guides/assets/improvement-ui.png
diff --git a/integrations/functional-integrations/assets/kb-optimizer.png b/integrations/integration-guides/assets/kb-optimizer.png
similarity index 100%
rename from integrations/functional-integrations/assets/kb-optimizer.png
rename to integrations/integration-guides/assets/kb-optimizer.png
diff --git a/integrations/functional-integrations/assets/test-after-optimizing.png b/integrations/integration-guides/assets/test-after-optimizing.png
similarity index 100%
rename from integrations/functional-integrations/assets/test-after-optimizing.png
rename to integrations/integration-guides/assets/test-after-optimizing.png
diff --git a/integrations/functional-integrations/assets/test-before-optimize.png b/integrations/integration-guides/assets/test-before-optimize.png
similarity index 100%
rename from integrations/functional-integrations/assets/test-before-optimize.png
rename to integrations/integration-guides/assets/test-before-optimize.png
diff --git a/integrations/functional-integrations/assets/view-improvement.png b/integrations/integration-guides/assets/view-improvement.png
similarity index 100%
rename from integrations/functional-integrations/assets/view-improvement.png
rename to integrations/integration-guides/assets/view-improvement.png
diff --git a/integrations/functional-integrations/conversation-analyzer.mdx b/integrations/integration-guides/conversation-analyzer.mdx
similarity index 97%
rename from integrations/functional-integrations/conversation-analyzer.mdx
rename to integrations/integration-guides/conversation-analyzer.mdx
index 3edc2ca7..f6f92e40 100644
--- a/integrations/functional-integrations/conversation-analyzer.mdx
+++ b/integrations/integration-guides/conversation-analyzer.mdx
@@ -3,6 +3,7 @@ title: Conversation Analyzer
 description: >-
   This functional integration automatically stores all of your bot's
   conversations and provides AI-generated analysis.
+icon: '/integrations/integration-guides/assets/icons/conversation-analyzer.svg'
 ---
 
 
diff --git a/integrations/functional-integrations/improvement.mdx b/integrations/integration-guides/improvement.mdx
similarity index 97%
rename from integrations/functional-integrations/improvement.mdx
rename to integrations/integration-guides/improvement.mdx
index 1ef8f123..acccf5d6 100644
--- a/integrations/functional-integrations/improvement.mdx
+++ b/integrations/integration-guides/improvement.mdx
@@ -1,6 +1,7 @@
 ---
 title: Improvement
 description: Provide feedback on specific LLMz iterations to improve future conversations.
+icon: '/integrations/integration-guides/assets/icons/improvement.svg'
 ---
 
 
diff --git a/integrations/functional-integrations/introduction.mdx b/integrations/integration-guides/introduction.mdx
similarity index 100%
rename from integrations/functional-integrations/introduction.mdx
rename to integrations/integration-guides/introduction.mdx
diff --git a/integrations/functional-integrations/knowledge-base-optimization.mdx b/integrations/integration-guides/knowledge-base-optimization.mdx
similarity index 95%
rename from integrations/functional-integrations/knowledge-base-optimization.mdx
rename to integrations/integration-guides/knowledge-base-optimization.mdx
index c0efaf2a..760073bd 100644
--- a/integrations/functional-integrations/knowledge-base-optimization.mdx
+++ b/integrations/integration-guides/knowledge-base-optimization.mdx
@@ -1,6 +1,7 @@
 ---
 title: Knowledge Base Optimization
 description: Automatically improve your bot's ability to respond to knowledge queries.
+icon: '/integrations/integration-guides/assets/icons/knowledge-base-optimization.svg'
 ---
 
 

From c943f2cc01cea88a21a5fb76fd8818b15def41bb Mon Sep 17 00:00:00 2001
From: Adrian Kahali <adrian.kahali@hotmail.com>
Date: Tue, 20 Jan 2026 11:49:57 -0500
Subject: [PATCH 2/2] fix link

---
 integrations/get-started/introduction.mdx | 29 +++++++----------------
 1 file changed, 9 insertions(+), 20 deletions(-)

diff --git a/integrations/get-started/introduction.mdx b/integrations/get-started/introduction.mdx
index 0d1e785f..cf65b62a 100644
--- a/integrations/get-started/introduction.mdx
+++ b/integrations/get-started/introduction.mdx
@@ -6,32 +6,21 @@ description: Connect your bot to external services.
 
 Integrations allow you to **connect your bot** to external services, APIs, and tools.
 
-You can use our pre-built [functional integrations](/integrations/functional-integrations), or explore any available integrations on [Botpress Hub](/integrations/get-started/botpress-hub).
+You can explore any available integrations on [Botpress Hub](/integrations/get-started/botpress-hub), which includes integrations built by both Botpress and by users.
 
 <Note>
-
-    Want to build your own integration and publish it on [Botpress Hub](/integrations/get-started/botpress-hub)? Check out the [For Developers](/integrations/sdk/integration/getting-started) section.
-
+  Want to build your own integration and publish it on [Botpress Hub](/integrations/get-started/botpress-hub)? Check out our [integrations SDK](/integrations/sdk/integration/getting-started).
 </Note>
 
 ## Get Started
 
-<CardGroup>
-    <Card
-        title="Functional integrations"
-        icon="box"
-        href="/integrations/functional-integrations"
-    >
-    Internal integrations that add functionality to your bot
-    </Card>
-    <Card
-        title="Botpress Hub"
-        icon="boxes"
-        href="/integrations/get-started/botpress-hub"
-    >
-    Marketplace to find and install integrations
-    </Card>
-</CardGroup>
+  <Card
+      title="Botpress Hub"
+      icon="boxes"
+      href="/integrations/get-started/botpress-hub"
+  >
+  Marketplace to find and install integrations
+  </Card>
 
 ## Popular integrations