Skip to main content
The Discord integration lets your BotSmith agent respond to messages in your Discord server. You create a Discord application and bot in the Discord Developer Portal, connect the bot token to BotSmith, invite the bot to your server, and then start the bot so it can listen for messages in real time.

​
Step 1: Create a Discord Application

  1. Go to discord.com/developers/applications and sign in.
  2. Click New Application in the top-right corner.
  3. Give your application a name and click Create.
  4. In the left sidebar, click Bot.
  5. Click Add Bot, then confirm by clicking Yes, do it!
  6. Under the bot’s username, click Reset Token and confirm. Copy the token — you cannot see it again after leaving this page.

​
Step 2: Enable Message Content Intent

Your bot needs the Message Content Intent to read the text of messages sent in channels.
  1. On the Bot page in the Developer Portal, scroll down to Privileged Gateway Intents.
  2. Enable the Message Content Intent toggle.
  3. Click Save Changes.
If Message Content Intent is not enabled, the bot will receive message events but cannot read the message text. Your agent will not be able to respond to any messages until this setting is turned on.

​
Step 3: Connect to BotSmith

1

Open the Integrations tab

In the BotSmith chatbot editor, click the Integrations tab.
2

Open Discord configuration

Find the Discord card and click Setup.
3

Enter your bot details

Fill in the following fields:
  • Bot Token — Paste the token you copied from the Discord Developer Portal.
  • Client ID (optional) — Your application’s Client ID, found on the General Information page of your Discord app.
  • Server ID (optional) — The ID of the Discord server where the bot will operate. Right-click your server name in Discord and select Copy Server ID. You may need to enable Developer Mode in Discord settings first (User Settings → Advanced → Developer Mode).
4

Save the integration

Click Save Integration.
5

Enable the integration

Toggle Enable Integration on.
6

Start the bot

Click the ⚡ Start Bot button (the lightning bolt icon next to your saved integration). BotSmith starts the bot’s Gateway connection so it can receive real-time message events. You will see a confirmation toast when the bot is online and listening.

​
Step 4: Invite the Bot to Your Server

Generate an invite link to add the bot to your Discord server.
  1. In the Discord Developer Portal, open your application and go to OAuth2 → URL Generator.
  2. Under Scopes, select bot.
  3. Under Bot Permissions, select:
    • Read Messages / View Channels
    • Send Messages
  4. Copy the generated URL at the bottom of the page.
  5. Open the URL in your browser, select your server from the dropdown, and click Authorize.

​
Step 5: Test the Integration

  1. Open your Discord server and navigate to a channel the bot has access to.
  2. Send a message in the channel.
  3. Your BotSmith agent should reply within a few seconds.
If the bot does not respond, check that:
  • Message Content Intent is enabled in the Developer Portal (Step 2).
  • The integration is toggled on and the bot has been started (Step 3).
  • The bot has Read Messages and Send Messages permissions in the channel.
  • Your chatbot is set to Active in BotSmith settings.
The bot must be started each time from the integration panel after saving or reconfiguring credentials. If you reconfigure your bot token, click the Start Bot button again to reconnect.