Add a Server
Connect a Discord server or Telegram group to Community Swarm to begin monitoring activity and enabling AI-powered engagement.
Adding a Discord Server
Prerequisites
- You must have Manage Server permissions on the Discord server you want to add.
- Your Community Swarm subscription must be active with Discord platform access.
Open the Add Server Dialog
Navigate to the Servers page in the dashboard and click Add Server. Select Discord as the platform.
Enter the Server ID
Paste your Discord server ID. If you are not sure how to find it, enable Developer Mode in Discord settings (User Settings > Advanced > Developer Mode), then right-click the server name and select Copy Server ID.
Configure Channel Monitoring
Specify which channels the monitoring bot should observe. You can either:
- Whitelist specific channels — Only monitor the listed channels
- Blacklist specific channels — Monitor all channels except the listed ones
Enter channel names as a comma-separated list.
Set Up the Monitoring Bot
The dialog shows the monitoring bot’s invite URL. Click the link to authorize the Community Swarm bot to join your Discord server. The bot requires permissions to read messages in the channels you configured.
Verify the Connection
After inviting the bot, click Verify in the dialog. Community Swarm checks that the bot has successfully joined the server and has the necessary permissions. Verification may take a few moments.
Once verified, the server appears in your servers list with an Active status.
The bot requires specific permissions to function correctly. Do not modify its role permissions after adding it to your server.
Adding a Telegram Group
Prerequisites
- You must be an admin of the Telegram group.
- Your Community Swarm subscription must be active with Telegram platform access.
Open the Add Server Dialog
Navigate to the Servers page and click Add Server. Select Telegram as the platform.
Enter the Group ID
Paste your Telegram group or chat ID. You can find this by adding the @userinfobot bot to your group and using the /id command, or by checking the group URL.
Choose the Monitoring Method
Select how Community Swarm monitors the group:
- Bot API — Uses the official Community Swarm Telegram bot. Add the bot to your group as an admin. This is the simpler setup.
- User API — Uses one of your Telegram profiles (userbots) as the monitoring source. Select the profile to use from the dropdown. This avoids adding an extra bot to your group.
Configure Channel Monitoring
Specify which topics or threads to monitor (if the group uses Telegram topics). Enter topic names as a comma-separated list, or leave empty to monitor all.
Verify the Connection
Click Verify to confirm the bot or profile has access to the group. Once verified, the server is added to your servers list.
For Telegram groups using the Bot API method, make sure the Community Swarm bot has admin permissions so it can read all messages.
Server Configuration Options
After adding a server, you can configure the following from the server card’s action menu:
| Option | Description |
|---|---|
| Toggle Active | Enable or disable monitoring for this server |
| Manage Profiles | Assign userbot profiles to engage in this server |
| Settings | Edit server name, channel configuration, and monitoring method |
| View Analytics | Jump to analytics filtered for this server |
Subscription Limits
Your subscription plan determines how many servers you can monitor per platform. The Servers page displays your current usage (e.g., “2/5 Discord servers”). If you reach your limit, you will need to remove a server or upgrade your plan before adding more.
Troubleshooting
- Bot not appearing in server — Ensure you completed the authorization flow and the bot has the required permissions. Try clicking Verify again.
- Telegram group not detected — Verify the group ID is correct and that the bot or profile has been added with admin permissions.
- Permission errors — Check that your Discord role or Telegram admin status grants the necessary access.
- Verification stuck — The verification process polls for the bot’s presence. If it times out, ensure the bot is in the server and retry.