Bot Management

Bots

Navigate to Chat & Communication > Bots

ChatNet includes an extensible bot framework that allows automated interactions within chat rooms. Bots can greet users, respond to messages, and perform various tasks.

Bot Management

The Bots page shows all registered bots in a list view with their current status. From here you can:

Enable/Disable a bot quickly using the toggle button
Configure a bot by clicking the Configure button to access detailed settings

Bot Configuration

Each bot's configuration page includes:

Setting	Description
Status	Enable or disable the bot globally
Name	The bot's display name
Description	A short description of what the bot does
Configuration Fields	Bot-specific settings (varies per bot)
Room Mode	Controls which rooms the bot is active in (see below)
Room List	Select rooms for whitelist/blacklist mode

Bots operate at two levels:

Global level — the bot must be enabled globally to function
Room level — determined by the Room Mode setting

Room Modes

Mode	Behavior
All Rooms	Bot is active in every room — no per-room selection needed
Whitelist	Bot is active only in the rooms you check
Blacklist	Bot is active in all rooms except the rooms you check

When "All Rooms" is selected the room checkboxes are hidden. Switching to "Whitelist" or "Blacklist" reveals the room list with an appropriate heading ("Enabled Rooms" or "Disabled Rooms").

Built-in Bots

Welcome Bot

Automatically greets users when they join a chat room.

Setting	Description
Welcome Message	The greeting template. Supports `{room_name}` and `{user_name}` placeholders

Default message:Welcome to {room_name}, {user_name}! Feel free to introduce yourself.

The welcome message can be customized per room using room-level overrides — allowing different rooms to have different greeting messages.

AI Chat Bot

Responds to user messages in chat rooms when triggered by a keyword (default: @AI). Uses the configured AI provider to generate contextual responses.

Setting	Description
System Prompt	Instructions that define the bot's personality and behavior
Trigger	The keyword that activates the bot (default: `@AI`)
History Count	Number of recent messages to include as context (0–50)
AI Provider	Override which AI provider this bot uses (optional)

How it works:

A user sends a message containing the trigger keyword (e.g., @AI what is the weather?)
The bot detects the trigger and collects recent chat history for context
An asynchronous request is made to the configured AI provider
The AI response is posted back to the chat room as a message from the bot

The system prompt can be customized per room, allowing the AI bot to have different personalities or expertise areas in different rooms.

Note: The AI Chat Bot requires at least one AI provider to be configured and enabled in the AI Settings. If no provider is assigned in the bot's configuration, it falls back to the global Chatbot task assignment.