Add an AI chatbot to your Discord server

Overview

You can add Inkeep as a Discord app to your Discord community or team's internal support, solutions engineering, or other channels.

Get Server ID

To configure the bot, you'll need your Discord Server ID:

1. Open Discord in your browser.
2. Select the target server in the left navigation bar
3. Copy the {SERVER_ID} from the browser's navigation bar. The URL will be in the format of https://discord.com/channels/{SERVER_ID}/{CHANNEL_ID}
4. Alternatively, you can find the ID in server settings.

Create Integration

To use the Inkeep Discord bot, we first need to register it as an integration.

1. Open the Inkeep Dashboard
2. Navigate to the Integrations tab within the desired project
3. Click on Create Integration
4. From the dropdown menu, choose Discord
5. Fill in the required fields Name and Server ID.
6. (Optional) If you'd like the bot to only reply to tags in a specific channel, specify the channel ID in Only reply in selected Channel IDs under Advanced Settings. By default, the bot is able to be tagged in any public channel or private channels it is added to.
7. Click on Create

Add to Server

To install the Inkeep Discord bot in your server:

1. Click here
2. Select the desired server in the ADD TO SERVER dropdown
3. Review the permissions and click Continue

To start using the bot, tag @Ask Inkeep in a message with your question. You or your users can do this in any channel.

Create a dedicated channel (optional)

We recommend having a dedicated channel for team or community members to ask questions to the bot.

1. Create an ✨ask-ai or similar channel.
2. Ask an example question in the channel to demonstrate how to use the bot. Type @Ask Inkeep before your question and hit enter.
3. The Inkeep bot will automatically create a new thread (if enabled) and reply to the user.
4. For follow-up questions, the user must tag the bot again.

Since Discord does not have the ability to pin a channel, consider:

• Making an announcement in your #general or other relevant channels linking users to it
• Adding guidance on how to use the bot in a pinned message on your main channel or incorporate as part of your onboarding experience.

Customize the Display Name

Instead of using @Ask Inkeep, you can customize the bot name from Discord.

1. Have at least one message that tags @Ask Inkeep
2. In that message, right click on @Ask Inkeep
3. Select Change Nickname
4. Enter your desired name for the bot, e.g. Ask CompanyAI

The bot can now be tagged via @Ask CompanyAI and all existing instances of @Ask Inkeep will be updated.

Tag a team member

Sometimes, you want users to be able to escalate to a human for help if the bot is not able to help.

To make this flow seamless, you can configure the Discord integration to show Mark as resolved ✅ and Ask for help 👋 buttons instead of the default 👍 👎.

When a user clicks on Ask for help 👋, the bot can tag users, roles, or other bots.

To set up:

1. Open the Inkeep Dashboard
2. Navigate to the Integrations tab within the desired project
3. Select the Discord Integration
4. Expand Advanced Settings
5. Under When a user leaves negative feedback..., click the dropdown menu
6. Select Tag a team member
7. Specify the User IDs, Role IDs, or Bot IDs you'd like to tag

You can get the ID of a Bot or User by right-clicking on a profile on Discord and clicking on Copy User ID or Copy group ID.

For a Role, you'll need to:

1. Navigate to the server
2. On the top left of the Discord app, click on your server name
3. Click on Server Settings
4. Navigate to Roles from the left side pane
5. Click on ... next to the desired role and select Copy Role ID

Auto-reply mode

Instead of requiring users to tag the bot with @Ask Inkeep, you can configure the Discord bot to automatically reply to all new threads in specific channels. This can be useful for dedicated support channels or community Q&A forums.

To set up auto-reply mode:

1. Open the Inkeep Dashboard
2. Navigate to the Integrations tab within the desired project
3. Select the Discord Integration
4. Expand Advanced Settings
5. In the Auto-reply Channel IDs field, add the channel IDs where you want the bot to auto-reply to new threads
6. (Optional) Customize the bot's behavior with these settings:
   • Reply message: Enter a custom initial message for the bot to use when it's tagged or auto-replies
   • Is AI Draft Mode enabled?: Adjusts the bot's tone for generating draft responses for team review
   • Is human reviewing conversations?: Informs users that team members are monitoring conversations
7. Click Save to apply the changes

Limiting bot responses to specific channels

If you want to restrict the bot to only respond in certain channels:

1. In the Advanced Settings, find the Only reply in selected Channel IDs field
2. Add the channel IDs where you want the bot to be active
3. The bot will now only respond when tagged in these specified channels

This can be useful for managing the bot's presence in large servers or for creating dedicated AI assistance channels.