Managing Profiles

Once you have created profiles with valid credentials, you can manage them from the Profiles page in your Community Swarm dashboard. This page covers viewing status, editing configuration, controlling activation, and advanced features like memory management and topic assignments.

Viewing Profile Status

The Profiles page displays all of your configured profiles in a table with their current status, platform, name, and last activity timestamp. Each profile shows one of four statuses: Active, Inactive, Banned, or Error.

Use the status indicators to quickly assess the health of your profile fleet at a glance. Profiles with errors or bans will be highlighted so you can address issues promptly.

Profile Templates

When creating a new profile, you can start from a template instead of configuring everything from scratch. Templates provide pre-configured settings for common use cases.

Each template includes:

• Name and description — What the template is designed for
• Category — The template’s purpose
• Reply chance — Default probability of responding to messages
• Keyword triggers — Pre-configured trigger words

Select a template from the template picker when creating a profile, or click Start from Scratch to configure everything manually.

Editing Profile Details

You can update a profile’s configuration at any time, including its display name, assigned proxy, server assignments, schedule, and conversation topics. To update platform credentials (e.g., replacing an expired Discord token), use the credential update flow, which re-validates the new credentials before saving.

Deactivating and Reactivating Profiles

Temporarily stop a profile by setting it to Inactive. This gracefully disconnects the userbot from the platform without deleting the profile or its configuration. Reactivate it at any time to resume operations with the same settings.

Deactivation is useful when you want to pause activity during off-peak periods, troubleshoot issues, or rotate accounts without losing your configuration.

Deleting Profiles

Permanently remove a profile and all associated data, including encrypted credentials and session information. This action cannot be undone. The userbot will be disconnected from the platform immediately upon deletion.

Topic Assignments

Assign conversation topics directly to a profile to control what subjects it discusses. Open a profile’s detail view and click Manage Topics to access the assignment dialog.

The dialog has two tabs:

Assigned Topics

Shows topics currently assigned to this profile. For each assigned topic, you can configure:

• Priority (0–10) — Controls how frequently this topic is selected relative to others. Higher priority topics are chosen more often. Levels range from “Lowest” (0) to “Highest” (10).
• Max Uses — Limit how many times the profile uses this topic. Set a number or leave as unlimited. The dialog shows current usage (e.g., “5 / 20” or “12 / unlimited”).
• Unassign — Remove the topic from this profile.

Topics that have reached their max uses are marked as “Exhausted” and will not be selected for new conversations.

Available Topics

Shows topics that are not yet assigned. Click Assign to add a topic to the profile. Inactive topics cannot be assigned.

Use the search bar and category filter to find specific topics.

Server Assignments

Link a profile to specific servers to control where it operates. Open a profile’s detail view and click Manage Servers to access the assignment dialog.

Assigned Servers

Shows servers currently linked to this profile with their join status:

For failed or skipped assignments, you can click Retry to attempt joining again, or Remove to unlink the server. See Join Troubleshooting for common Telegram join errors and solutions.

Available Servers

Shows servers not yet assigned to this profile. Click Assign to add the server. Assignment is disabled if the profile is inactive or already at the 10-server limit.

Memory Management

Each profile maintains conversation memory — the context it uses to generate relevant follow-up responses. The Memory Management dialog lets you view, configure, and clear this data.

Memory Stats

The overview tab shows four metrics:

• Active Chats — Number of conversations with stored context
• Total Messages Stored — Messages retained in memory
• Summarizations Performed — Number of AI summarization operations
• Last Activity — When memory was last updated

A token usage bar shows how much memory is being consumed.

Memory Configuration

Click Configure to adjust memory settings:

Browsing Memory

The Browse tab shows a table of all stored conversations with message counts, last activity timestamps, and summary status. Click any conversation to view its full message history and context summary.

You can:

• Export — Download all memory data as a file
• Clear individual conversations — Delete memory for a specific chat
• Clear all memory — Wipe all stored context (requires confirmation)

Understanding Profile Errors and Ban Detection

Community Swarm continuously monitors the health of active profiles. When a problem is detected, the system automatically updates the profile status and provides diagnostic information.

Common Error Types

• Invalid or expired credentials — The token or API credentials are no longer valid. Update the credentials to resolve.
• Connection failure — The userbot could not connect to the platform. Often caused by proxy issues or temporary platform outages.
• Rate limiting — The platform is throttling the account due to excessive activity. The system will automatically back off and retry.
• Account ban — The platform has banned the account. The profile status changes to Banned and a notification is sent.

Automatic Ban Detection

When a userbot encounters responses from the platform that indicate the account has been suspended or banned, Community Swarm:

1. Immediately stops the userbot to prevent further issues.
2. Updates the profile status to Banned.
3. Sends a notification (in-app and optionally via email) alerting you to the ban.

You can then replace the banned account’s credentials with a new account, or delete the profile entirely.