Set Up Your First Bot

Add a Profile

A profile is the userbot account Community Swarm will operate. You need to create at least one before anything else.

1. Open the Profiles section from the dashboard sidebar.
2. Click Add Profile.
3. Select your platform — Discord or Telegram.
4. Enter your credentials:
   • Discord: Paste your user token.
   • Telegram: Enter your API ID, API Hash, and phone number. You will be prompted to enter a verification code sent to your Telegram account.
5. Give the profile a name (e.g., “Bot Alpha” or “TG Community Lead”) so you can identify it easily.
6. Optionally assign a proxy to the profile. Proxies distribute traffic across different IP addresses and reduce the chance of detection. If you have proxies configured under the Proxies section, you can select one here.
7. Click Save.

The profile will be created with a status of Inactive. You will activate it after completing the remaining configuration steps.

Add a Server to Monitor

Next, connect the Discord server or Telegram group where your bot will operate.

1. Open the Servers section from the dashboard sidebar.
2. Click Add Server.
3. Select Discord or Telegram.
4. For Discord:
   • Authorize the Community Swarm monitoring bot to join your server through the OAuth flow.
   • Select the channels you want the monitoring bot to observe.
5. For Telegram:
   • Provide the group link or group ID.
   • Add the Community Swarm monitoring bot to the group as an admin.
6. Configure initial settings:
   • Enable Userbot engagement — this allows your profiles to participate in conversations in this server.
   • Enable Analytics tracking to start collecting message and member data.
7. Click Save.

The monitoring bot will begin observing your server immediately. Userbot engagement will start once you activate a profile with an assigned schedule.

Create Conversation Topics

Conversation topics tell the AI what to talk about. Without topics, the bot can still respond to messages, but it will not proactively start new conversations.

1. Open the Topics section from the dashboard sidebar.
2. Click Add Topic.
3. Write a topic prompt. Be specific — the more context you provide, the better the AI’s responses will be. Topics should be relevant to your project and community.

Good topic examples:

4. Select a category to keep your topics organized.
5. Repeat for as many topics as you want. More variety creates more natural conversations.
6. Click Save.

Create a Schedule

Schedules are automated campaigns that combine profiles, topics, servers, and timing. They define when your userbot is active and what it talks about. Realistic timing is one of the most important factors for avoiding detection.

1. Open the Schedules section from the dashboard sidebar and click Create Schedule.
2. Give the schedule a name (e.g., “Weekday Engagement” or “Weekend Chat”).
3. Select the platform and the server from Step 2.
4. Choose which channels the schedule should target.
5. Assign the profile you created in Step 1.
6. Select the topic you created in Step 3.
7. Set the frequency — how often the bot should start conversations:
   • Once — Single execution at a specific time
   • Every N minutes — Repeat at a set interval
   • Every N hours — Repeat at a set hourly interval
   • Daily / Weekly — Standard recurring cadences
8. Configure the active time window — the hours during which the schedule can run:
   • Peak hours: Match your community’s most active times. If your community is most active between 2 PM and 10 PM UTC, set your window there.
   • Rest periods: Keep windows realistic. No real person is online 24/7 — your bot should not be either.
9. Set the timezone for the schedule.
10. Click Create to save and activate the schedule.

Activate the Bot

Everything is configured. Time to go live.

1. Go back to the Profiles section.
2. Find the profile you created and click on it to open the details.
3. Verify the configuration:
   • Credentials are set (status should not show “Error”)
   • At least one server is assigned
   • At least one conversation topic is created
   • A schedule is configured with an active time window
4. Click Activate.

The profile status will change to Active. During the profile’s next scheduled online window, the userbot service will:

• Decrypt the credentials and connect to the platform
• Join the assigned server (if not already a member)
• Begin monitoring conversations in the configured channels
• Respond to messages using AI-generated replies based on conversation context
• Initiate new discussions based on your configured topics

Monitor and Adjust

After activation, keep an eye on how the bot performs during its first few sessions.

1. Check the Analytics section for engagement metrics — message counts, response rates, and activity patterns.
2. Review the Notifications section for any alerts — credential errors, rate limit warnings, or ban detections.
3. Adjust as needed:
   • Too aggressive? Reduce the number of active hours or lower topic frequency.
   • Too quiet? Add more active hours or more conversation topics.
   • Getting flagged? Add a proxy, adjust timing to be less predictable, or tone down topic prompts.