From 190923f8a3f1f49f90438f3d07019add1847973f Mon Sep 17 00:00:00 2001 From: Han Wang <44352119+handotdev@users.noreply.github.com> Date: Tue, 9 Dec 2025 14:41:46 -0800 Subject: [PATCH 1/2] Update ai/assistant-integrations.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- ai/assistant-integrations.mdx | 166 ++++++++++++++++++++++++++++++++++ 1 file changed, 166 insertions(+) create mode 100644 ai/assistant-integrations.mdx diff --git a/ai/assistant-integrations.mdx b/ai/assistant-integrations.mdx new file mode 100644 index 000000000..45ebe7aed --- /dev/null +++ b/ai/assistant-integrations.mdx @@ -0,0 +1,166 @@ +--- +title: "Assistant integrations" +description: "Connect Discord and Slack to bring AI-powered documentation assistance to your community channels." +keywords: ["Discord integration", "Slack integration", "AI assistant", "community support", "chat integration"] +--- + + + Assistant integrations are available on [Pro and Custom plans](https://mintlify.com/pricing?ref=assistant). + + +## About assistant integrations + +Connect your Discord servers and Slack workspaces to the Mintlify Assistant to provide AI-powered documentation support directly in your community channels. The assistant answers questions about your documentation using the same agentic RAG technology that powers the embedded assistant on your docs site. + +When users ask questions in connected channels, the assistant: + +* **Searches your documentation** to find relevant information and provide accurate answers. +* **Cites sources** with links back to your documentation pages. +* **Generates code examples** to help users implement solutions. + +Each message sent to the assistant in Discord or Slack counts toward your plan's message allowance, just like messages from your embedded assistant. + +## Access integrations + +Manage your assistant integrations from the dashboard: + +1. Navigate to your [dashboard](https://dashboard.mintlify.com). +2. Select **Assistant** from the products menu. +3. Click the **Integrations** tab. + + + The assistant integrations tab in the dashboard. + The assistant integrations tab in the dashboard. + + +The integrations page displays all available integrations and their connection status. Connected integrations appear in the **Connected apps** section, while available integrations appear in the **All Apps** section. + +## Connect Discord + +Connect your Discord server to enable the Mintlify Assistant bot in your channels. + +### Prerequisites + +- Admin permissions on your Discord server. +- An active Mintlify Pro or Custom plan. + +### Connect your server + +1. Navigate to the [Integrations tab](https://dashboard.mintlify.com/products/assistant/settings/integrations) in your dashboard. +2. Find **Discord** in the integrations list. +3. Click **Connect**. +4. Sign in to Discord if prompted. +5. Select the server where you want to add the assistant. +6. Review the permissions and click **Authorize**. + +The assistant bot is added to your Discord server. You'll see a success message and Discord will appear in the **Connected apps** section. + +### Configure Discord channels + +After connecting your server, configure which channels the assistant can access: + +1. In the integrations list, click **Configure** next to Discord. +2. Select the channels where you want the assistant to respond to questions. +3. Save your configuration. + +The assistant monitors selected channels and responds when users ask questions about your documentation. + +## Connect Slack + +Connect your Slack workspace to enable the Mintlify Assistant in your channels. + +### Prerequisites + +- Admin permissions on your Slack workspace. +- An active Mintlify Pro or Custom plan. + +### Connect your workspace + +1. Navigate to the [Integrations tab](https://dashboard.mintlify.com/products/assistant/settings/integrations) in your dashboard. +2. Find **Slack** in the integrations list. +3. Click **Connect**. +4. Sign in to Slack if prompted. +5. Select the workspace where you want to add the assistant. +6. Review the permissions and click **Allow**. + +The assistant is added to your Slack workspace. You'll see a success message and Slack will appear in the **Connected apps** section. + +### Configure Slack channels + +After connecting your workspace, configure which channels the assistant can access: + +1. In the integrations list, click **Configure** next to Slack. +2. Select the channels where you want the assistant to respond to questions. +3. Save your configuration. + +The assistant monitors selected channels and responds when users ask questions about your documentation. + +## Manage integrations + +### View connection status + +The integrations page shows the connection status for each integration. Connected integrations display a **Connected** badge and appear in the **Connected apps** section at the top of the page. + +### Disconnect an integration + +To disconnect Discord or Slack: + +1. Navigate to the [Integrations tab](https://dashboard.mintlify.com/products/assistant/settings/integrations). +2. Find the integration in the **Connected apps** section. +3. Click **Configure**. +4. Click **Disconnect** and confirm. + +The assistant stops responding in the disconnected platform's channels. + +### Reconfigure channels + +Update which channels the assistant monitors: + +1. Navigate to the [Integrations tab](https://dashboard.mintlify.com/products/assistant/settings/integrations). +2. Find the integration in the **Connected apps** section. +3. Click **Configure**. +4. Update your channel selections. +5. Save your changes. + +## Usage and billing + +Messages sent to the assistant in Discord and Slack count toward your plan's message allowance. Monitor your usage from the [Assistant dashboard](https://dashboard.mintlify.com/products/assistant). + +If you exceed your message allowance, additional messages incur overage charges according to your plan. Set spending limits in the [Billing tab](https://dashboard.mintlify.com/products/assistant/settings/billing) to control costs. + +## Troubleshooting + + + If the Discord bot doesn't respond to questions: + + - Verify the bot has permission to read and send messages in the channel. + - Check that the channel is configured in your integration settings. + - Ensure your message allowance hasn't been exceeded. + - Try disconnecting and reconnecting the integration. + + + + If the Slack app doesn't respond to questions: + + - Verify the app has permission to read and send messages in the channel. + - Check that the channel is configured in your integration settings. + - Ensure your message allowance hasn't been exceeded. + - Try disconnecting and reconnecting the integration. + + + + If you encounter errors when connecting: + + - Verify you have admin permissions on the platform. + - Check that your Mintlify plan includes assistant integrations. + - Try clearing your browser cache and reconnecting. + - Contact [support](mailto:support@mintlify.com) if the issue persists. + + + + If you don't see the Integrations tab: + + - Verify your plan includes assistant integrations (Pro or Custom). + - Check that you have the necessary permissions in your dashboard. + - Contact [support](mailto:support@mintlify.com) to enable the feature. + From 616faa51c2a0729a42a2d09c4aa432f2a83e4564 Mon Sep 17 00:00:00 2001 From: Han Wang <44352119+handotdev@users.noreply.github.com> Date: Tue, 9 Dec 2025 14:41:59 -0800 Subject: [PATCH 2/2] Update docs.json Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- docs.json | 1 + 1 file changed, 1 insertion(+) diff --git a/docs.json b/docs.json index 1c4bb0168..47c1a76ef 100644 --- a/docs.json +++ b/docs.json @@ -155,6 +155,7 @@ "group": "AI", "pages": [ "ai/assistant", + "ai/assistant-integrations", "ai/agent", "ai/autopilot", "ai/llmstxt",