Skip to main content
The official Discord integration allows users to chat with your bot in Discord servers, threads, and direct messages.

​
Setup

You will need:
1

Install the integration in Botpress

First, install the integration to your bot:
  1. In Botpress Studio, select Explore Hub in the upper-right corner.
  2. Search for the Discord integration.
  3. Select Install Integration.
In the Configuration menu, you should see one field:
  • Bot Token
Leave it empty for now—you’ll come back to it after completing the setup in Discord.
2

Create a Discord application

Next, create a Discord application:
  1. Go to the Discord Developer Portal and sign in.
  2. Select New Application in the top-right corner.
  3. Give your application a name and select Create.
3

Create a bot user

Now, create a bot user for your application:
  1. In your application’s left sidebar, select Bot.
  2. Under the bot’s username, you can optionally set a custom avatar and display name.
  3. Under Privileged Gateway Intents, enable the following:
    • Server Members Intent
    • Message Content Intent
  4. Select Save Changes.
4

Copy your bot token

Next, copy your bot’s token:
  1. Still on the Bot page, below Token, select Reset Token (or Copy if a token is already visible).
  2. Confirm the reset if prompted.
  3. Copy the token and store it somewhere safe—you will not be able to see it again.
Never share your bot token publicly or commit it to version control. Anyone with access to this token can control your bot.
5

Invite the bot to your server

Now, invite the bot to your Discord server:
  1. In the left sidebar, select OAuth2 > OAuth2 URL Generator.
  2. Under Scopes, select:
    • bot
    • applications.commands
  3. Under Bot Permissions, select the permissions your bot requires. At minimum:
    • View Channels
    • Send Messages
    • Create Public Threads
    • Create Private Threads
    • Send Messages in Threads
    • Pin Messages
    • Attach Files
    • Read Message History
    • Add Reactions
    • Create Polls
  4. Copy the generated URL at the bottom of the page and open it in your browser.
  5. Select the server you want to add the bot to and select Authorize.
6

Configure the integration in Botpress

In your Botpress integration configuration, click “Connect with OAuth”, then follow the instructions in the wizard to fill out the following fields:
  1. In the integration’s Bot Token field, paste your Discord bot token.
  2. Select Save Configuration.
Your Discord integration is ready—users can now chat with your Botpress bot in Discord servers, threads, and direct messages.

​
Options

The Discord integration’s Configuration menu offers a few additional options:

​
Custom display name / avatar

  • Fill in the Bot Name field to display a custom name as the sender in Discord conversations.
  • Fill in the Bot Avatar URL field to set a custom image as the bot’s Discord avatar.
The avatar URL must be publicly accessible. Supported formats include PNG, JPG, and GIF.

​
Cards

Here’s a reference for all Cards available with the integration:

​
Add Member Role

​
output
object
This Card has no output.

​
Add Reaction

​
output
object
This Card has no output.

​
Ban User

​
output
object
This Card has no output.

​
Call API

​
input
object

​
Create Channel

​
output
object

​
Create Poll

​
Create Role

​
Delete Channel

​
output
object
This Card has no output.

​
Delete Reaction

​
output
object
This Card has no output.

​
Delete Role

​
output
object
This Card has no output.

​
End Poll

​
output
object

​
Get Channel Pins

​
output
object

​
Get Guild

​
output
object

​
Get Guild Channels

​
output
object

​
Get Guild Member

​
output
object

​
getOrCreateChannelConversation

​
input
object

​
Get or Create a User

​
List Guild Members

​
output
object

​
Pin Message

​
output
object
This Card has no output.

​
Remove Member Role

​
output
object
This Card has no output.

​
Unban User

​
output
object
This Card has no output.

​
Unpin Message

​
output
object
This Card has no output.
Last modified on April 14, 2026