Skip to content

EasyChatRooms Bot Management Documentation

This document explains how to use the three main screens in the EasyChatRooms admin panel for creating and managing bot accounts and their channel‑join behavior.


1. Bot Channels (Bots → Bot Channels)

On this screen you define which channels bots will join and how they join them.

Screen Layout

  • Channel Name: List of channels configured in the system.
  • Autojoin Disabled: When selected, bots will never auto‑join this channel.
  • Random: When selected, bots will join this channel intermittently (based on built‑in probability).
  • All: When selected, all bots will always join this channel.
  • Save: Click to persist your changes.

Usage Steps

  1. Locate the row for the channel you want to configure.
  2. Select one of Autojoin Disabled, Random, or All.
  3. Click Save at the bottom to apply your settings.

Note: Use Random for channels where occasional bot participation is desired (e.g. trivia or game channels).


2. Bulk Bot Creation (Bots → Bulk Bot Creation)

Use this form to generate hundreds (or thousands) of bot accounts at once and preview them as JSON.

Form Fields & Descriptions

  • Select Gender: Choose the gender for all bots (Male/Female/Unspecified).
  • Nicknames (One per line): List one nickname per line.
  • Manipulate Nicknames if Already Taken: If checked, any duplicate nicknames will be auto‑modified (e.g. by appending numbers) to ensure uniqueness.
  • Avatar URLs (One per line): One avatar image URL per line.
  • Use Ready Avatars (Select Gender First): Pulls from a built‑in avatar pool matching the selected gender.
  • Random Profile Settings: Toggle to randomly assign:
    • Relationship Goal
    • Location (One per line)
    • Zodiac, Education, Age (18–45)
    • Hobbies (One per line)
  • Number of Bots: Total bots you wish to create.
  • Show Bots List: Generates and displays a JSON preview of all bots based on your inputs.
  • Create Bots: After reviewing the JSON preview, click to actually create all bots in the system.

Workflow

  1. Fill out the form fields with your desired settings.
  2. Optionally check Manipulate Nicknames if Already Taken.
  3. Click Show Bots List to review the generated JSON output.
  4. If everything looks correct, click Create Bots to register them all.

3. Bot List Update (Bots → Bot List)

The Bot List screen shows existing bot accounts. Use the Update bot list button to refresh data and channel‑join settings.

Screen Layout

  • Update bot list: Reloads all bot records and their channel assignments from the database.
  • Global Search: Quickly filter bots by nickname, email, or ID.
  • Table columns: ID, Nickname, Email, Role, Status, Actions.
    • Actions icons:
      • 🖉 Edit bot details
      • 🎵 Open Bot Messenger
      • 🔔 Notification settings

When to Use

  • After Bulk Creation: Refresh to see newly created bots.
  • After Changing Channel Settings: Reload so that updated channel‑join rules take effect.

4. Summary Workflow

  1. Bulk Bot Creation → Generate and preview bot JSON, then create.
  2. Bot Channels → Configure which channels bots join and their join behavior.
  3. Bot List → Click Update bot list to refresh and view all bots with their latest channel settings.

This guide covers creating bots, setting their channel‑join rules, and keeping your bot list up to date. For further assistance, please contact support.