Connecting to Discord

AstrBot v3.5.16 and later supports connecting to the Discord messaging platform.

Create AstrBot Discord Platform Adapter

Navigate to the messaging platform, click to add a new adapter, find Discord and click to enter the Discord configuration page.

For this tutorial, you only need to configure items 1, 2, 3, and 5

• Bot Name: Customize this to easily distinguish between different adapters
• Enable: Check to enable this adapter
• Bot Token: Token obtained after creating an App in Discord (see below)
• Discord Proxy Address: If you need to use a proxy to access Discord, you can enter the proxy address here (optional)
• Auto-register Plugin Commands as Discord Slash Commands: When checked, AstrBot will automatically register commands from installed plugins as Discord slash commands for user convenience.

Create an App in Discord

1. Go to Discord Developer Portal, click the blue button in the top right corner, enter an application name, and create the application.

2. Click on Bot in the left sidebar, click the Reset Token button. After the token is created, click the Copy button and paste the token into the Discord Bot Token field in the configuration.

3. Scroll down and enable all three of these options:

• Presence Intent: Allows the bot to access user online status
• Server Members Intent: Allows the bot to access server member information
• Message Content Intent: Allows the bot to read message content

4. Click OAuth2 in the left sidebar, and in the OAuth2 URL Generator, select Bot Like this: Then in the Bot Permissions section that appears below, select the allowed permissions. Generally, it's recommended to add the following permissions:
   • Send Messages
   • Create Public Threads
   • Create Private Threads
   • Send TTS Messages
   • Manage Messages
   • Manage Threads
   • Embed Links
   • Attach Files
   • Read Message History
   • Add Reactions If you find this tedious, you can directly use administrator permissions, but it's still recommended to use the permissions configured above (or the permissions you specifically need) in your production environment.

Remember, the higher the permissions, the greater the risk.

5. Copy the Generated URL that appears below. Open this URL to add the bot to your desired server.

6. Enter your Discord server, your bot should now show as online @ mention the bot you just created (or don't mention it), type /help. If it responds successfully, the test is successful.

Troubleshooting

• If you're stuck at the final step and the bot is not online, please ensure your server can directly connect to Discord

If you have any questions, please submit an Issue.