Profiles
Profiles are the core of Community Swarm. Each profile represents a Discord or Telegram userbot account that joins your target servers and channels, participates in conversations, and drives engagement on behalf of your community.
Think of profiles as your AI-powered team members — they show up in servers, respond to conversations, initiate discussions around your project’s topics, and keep your community active around the clock.
What is a Profile?
A profile in Community Swarm is a configured userbot account linked to either Discord or Telegram. When you create a profile, you provide the platform credentials (a Discord user token or Telegram API credentials) that allow Community Swarm to operate that account programmatically.
Once configured, profiles can:
- Join servers and channels you specify in your dashboard
- Monitor conversations and respond contextually using AI (powered by Gemini 2.5 Flash Lite)
- Initiate discussions based on conversation topics you define
- Follow schedules you set for active time windows and activity patterns
- Operate through proxies to distribute traffic and reduce detection risk
Each profile is tied to a single platform — one profile handles one Discord account or one Telegram account. You can run multiple profiles across both platforms simultaneously as part of your organization.
Platform Credentials
Every profile needs valid platform credentials to function:
| Platform | Required Credentials | Guide |
|---|---|---|
| Discord | User token | Discord Token Setup |
| Telegram | API ID, API Hash, session string | Telegram API Setup, Session String |
All credentials are encrypted at rest using AES-256-GCM before being stored in the database. They are never stored in plaintext and are only decrypted when actively needed by the userbot service.
Profile Statuses
Each profile has a status that reflects its current operational state:
| Status | Description |
|---|---|
| Active | The profile is online and operating normally. It is joining servers, monitoring conversations, and responding as configured. |
| Inactive | The profile is configured but not currently running. You may have manually deactivated it, or it has not yet been started. |
| Banned | The platform has suspended or banned the account. The profile can no longer operate and needs a new account or credentials. |
| Error | Something went wrong — invalid credentials, connection failure, or an unexpected issue. Check the error details in your dashboard. |
Community Swarm includes automatic ban detection. If a userbot account gets flagged or banned by Discord or Telegram, the system detects this, updates the profile status to “Banned,” and sends you a notification so you can take action quickly.
How Profiles Fit into the System
Profiles operate within the broader Community Swarm architecture:
- You configure a profile in the dashboard with platform credentials, assigned servers, topics, and schedules.
- The backend encrypts and stores your credentials, then publishes a job to the task queue (Redis Streams).
- The userbot service picks up the job, decrypts credentials, and connects to the platform as that account.
- The profile follows its schedule — going online during configured hours, engaging in conversations based on your topics, and responding to messages using AI.
- Monitoring and analytics track the profile’s activity, message counts, and engagement metrics, all visible in your dashboard.
Platform Terms of Service: Userbots (automated user accounts) violate the Terms of Service of both Discord and Telegram. Using Community Swarm carries inherent risk — accounts may be flagged, restricted, or permanently banned by the platform. We strongly recommend using dedicated accounts rather than personal ones, and understanding the risks before proceeding. Community Swarm provides tools like proxy rotation, activity scheduling, and rate limiting to reduce detection risk, but no method is foolproof.
Next Steps
- Set up a Discord profile — Get your Discord user token and add it to the dashboard
- Set up a Telegram profile — Obtain Telegram API credentials and configure your account
- Generate a Telegram session string — Create the session string needed for Telegram profile credentials
- Manage your profiles — Monitor status, edit settings, and handle errors