Docs: add discord integration docs

fern/products/docs/docs.yml

@@ -192,6 +192,9 @@ navigation:
           - page: Slack app
             path: ./pages/ask-fern/slack-app.mdx
             slug: slack-app
+          - page: Discord bot
+            path: ./pages/ask-fern/discord-bot.mdx
+            slug: discord-bot
           - api: API reference
             api-name: fai
             paginated: true

fern/products/docs/pages/ai/overview.mdx

@@ -6,11 +6,12 @@ Your documentation site comes with automatic optimizations for AI tools, plus fe
 
 ## Find answers
 
-Users can chat with Ask Fern to get instant answers from your documentation. It's available as an embedded chat widget, via the [API](/learn/docs/ai-features/ask-fern/api-reference/overview) for custom integrations, and as a [Slack app](/learn/docs/ai-features/ask-fern/slack-app) for your community workspace. Ask Fern understands context and provides citations so users can verify information and explore further.
+Users can chat with Ask Fern to get instant answers from your documentation. It's available as an embedded chat widget, via the [API](/learn/docs/ai-features/ask-fern/api-reference/overview) for custom integrations, and as a [Slack app](/learn/docs/ai-features/ask-fern/slack-app) or [Discord bot](/learn/docs/ai-features/ask-fern/discord-bot) for your community workspace. Ask Fern understands context and provides citations so users can verify information and explore further.
 
-<CardGroup cols={2}>
+<CardGroup cols={3}>
   <Card title="Ask Fern overview" icon="sparkles" href="/learn/docs/ai-features/ask-fern/overview" />
   <Card title="Ask Fern Slack app" icon="fa-brands fa-slack" href="/learn/docs/ai-features/ask-fern/slack-app" />
+  <Card title="Ask Fern Discord bot" icon="fa-brands fa-discord" href="/learn/docs/ai-features/ask-fern/discord-bot" />
 </CardGroup>
 
 

fern/products/docs/pages/ask-fern/discord-bot.mdx

@@ -0,0 +1,129 @@
+---
+title: Ask Fern Discord bot
+description: Enable your customers to get instant answers to product questions directly in Discord using Ask Fern's AI-powered documentation bot.
+---
+
+<Info>
+  Ask Fern is also available for Slack. See the [Slack app documentation](/learn/docs/ai-features/ask-fern/slack-app) for setup instructions.
+</Info>
+
+The Ask Fern Discord bot allows customers to ask questions about your products directly in Discord channels and receive AI-generated answers from your documentation database.
+
+Fern stores all questions and answers from Discord interactions for [analytics purposes](/learn/docs/ai-features/ask-fern/features#analytics).
+
+## Setup
+
+Install the Ask Fern bot in your Discord server and configure it for your channels.
+
+<Note>
+  To install Ask Fern in your Discord server, you must have **Manage Server** permissions. This is set in **Server Settings > People > Roles**.
+</Note>
+
+<Steps>
+<Step title="Enable Ask AI in your dashboard">
+
+Before installing the Discord bot, you need to enable Ask AI for your documentation site.
+
+Go to your [Fern Dashboard](https://dashboard.buildwithfern.com) and enable Ask AI in the "Settings" tab of your domain. For more advanced configuration instructions, see the [Ask Fern setup guide](https://buildwithfern.com/learn/docs/ai-features/ask-fern/setup).
+<Frame>
+  <img src="assets/enable-ask-fern-dashboard.png" alt="Enable Ask Fern in your dashboard"/>
+</Frame>
+</Step>
+<Step title="Get your unique install link">
+
+Use the [API Explorer](/learn/docs/ai-features/ask-fern/api-reference/discord/create-discord-integration) to get a unique Discord installation link for your organization. 
+
+You will need:
+- Your [Fern token](/learn/cli-api-reference/cli-reference/commands#fern-token)
+- Your domain without protocol or path (e.g., `website.com`, not `https://website.com/docs`)
+
+You can alternatively use this cURL request:
+```bash
+curl -X POST "https://fai.buildwithfern.com/discord/install?domain=<YOUR_DOMAIN>" \
+     -H "Authorization: Bearer <YOUR_FERN_TOKEN>"
+```
+
+Follow the URL returned in the `integration_url` response field.
+
+</Step>
+<Step title="Add to your server">
+You'll be redirected to Discord to authorize the Ask Fern bot. Select the server where you want to add Ask Fern and click **Authorize**.
+<Frame>
+  <img src="assets/allow-discord-permissions.png" alt="Allow Ask Fern for Discord server"/>
+</Frame>
+</Step>
+<Step title="Configure channels">
+
+Once the bot is added to your server, use the `/configure` slash command in each channel where you want the bot to respond. Without this configuration, the bot won't respond to messages in that channel.
+<Frame>
+  <img src="assets/set-config-discord.png" alt="Configure bot by channel in Discord"/>
+</Frame>
+</Step>
+</Steps>
+
+## Configuration
+
+Customize the bot's behavior to match your workflow needs.
+
+### Bot settings per channel
+
+Use the `/configure` slash command in any channel to adjust the settings. This opens an interactive menu where you can configure:
+
+| Setting | Description |
+|---------|-------------|
+| **Response mode** | Controls whether the bot responds only when directly mentioned with `@Ask Fern` (`mentions_only`) or automatically responds to questions while ignoring casual chat (`auto`). |
+| **Help role** | Optionally select a role or user to tag when users click the "Ask for help" button on bot responses. |
+
+After selecting your preferences, click **Save Configuration** to apply the changes.
+<Frame>
+  <img src="assets/config-saved-discord.png" alt="Config set success message in Discord"/>
+</Frame>
+### Customize the bot name
+
+You can rename the bot to match your brand (example: "YourCompanyName Support"):
+
+<Note>
+  To rename your Bot, you must have **Change Nickname** permissions. This is set in Server **Settings > People > Roles**
+</Note>
+<Steps>
+  <Step>
+    Go to the Members List section at the top of the Discord server
+    <Frame>
+      <img src="assets/members-list-discord.png" alt="Discord members list"/>
+    </Frame>
+  </Step>
+  <Step>
+    Right click the AskFern bot and select "Change Nickname"
+  </Step>
+  <Step>
+    Enter your preferred bot name and click "Save"
+  </Step>
+</Steps>
+Now, users will see your custom bot name instead of the default "Ask Fern" name.
+
+## Architecture
+
+When a user asks Ask Fern a question in Discord, the bot receives the message and triggers Fern's servers to search your documentation database and retrieve relevant context. Using that context, Ask Fern generates a response and replies in a thread.
+
+<Accordion title="Diagram">
+```mermaid
+sequenceDiagram
+  autonumber
+    participant U as User (Discord)
+    participant D as Discord Bot
+    participant F as Fern Servers
+    participant V as Documentation Database
+    participant A as Ask Fern
+
+    U->>D: Ask question to @Ask Fern
+    D->>F: Forward message to Fern servers
+    F->>F: Convert query to vector
+    F->>V: Search for relevant chunks
+    V->>F: Return matching documents
+    F->>A: Send query + context
+    A->>A: Generate response
+    A->>D: Return answer
+    D->>U: Reply in Discord thread
+    F->>F: Store question and answer for analytics
+```
+</Accordion>

fern/products/docs/pages/ask-fern/slack-app.mdx

@@ -4,7 +4,7 @@ description: Enable your customers to get instant answers to product questions d
 ---
 
 <Info>
-  Ask Fern is also available for Discord. Contact support@buildwithfern.com for more information.
+  Ask Fern is also available for Discord. See the [Discord bot documentation](/learn/docs/ai-features/ask-fern/discord-bot) for setup instructions.
 </Info>
 
 The Ask Fern Slack app allows customers to ask questions about your products directly in Slack channels and receive AI-generated answers from your documentation database.

fern/snippets/ask-fern-config.mdx

@@ -2,7 +2,6 @@
 ai-search:
   location:
     - docs
-    - slack
     - discord
   datasources:
     - url: https://example.com/additional-docs
@@ -22,8 +21,8 @@ ai-search:
   - `slack` enables Ask Fern in Slack
   - `discord` enables Ask Fern in Discord
 
-  Most users should enable Ask Fern for both `docs` and either `slack` or `discord`. See the [Slack app documentation](/learn/docs/ai-features/ask-fern/slack-app) for Slack setup instructions. For Discord setup, reach out to support@buildwithfern.com.
-</ParamField>
+  Most users should enable Ask Fern for both `docs` and either `slack` ([setup instructions](/learn/docs/ai-features/ask-fern/slack-app)) or `discord` ([setup instructions](/learn/docs/ai-features/ask-fern/discord-bot)). 
+  </ParamField>
 
 <ParamField path="ai-search.datasources" type="list of objects" required={false} toc={true}>
   <Badge intent="warning">Coming soon</Badge>