Admin Commands Reference for Dummy Gemini Bot

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AmiraliNotFound/dummy-gemini-bot/llms.txt

Use this file to discover all available pages before exploring further.

Admin commands are restricted to users whose Telegram username is listed in ALLOWED_ADMINS (configured in .env). These commands control runtime configuration, special user management, and direct user communication.

---

​

/admin

Opens the admin WebApp dashboard and registers the admin’s chat ID for support ticket forwarding. When called without subcommands, it displays a full configuration overview including the current model ID, context window size, timeout, TTS settings, system instruction, and available subcommands.

• Syntax: /admin
• Where: DMs only (the handler explicitly rejects non-private chats)
• Example:
  /admin
  
• Notes:
  • Requires WEBAPP_URL to be set in .env for the dashboard button to appear. If WEBAPP_URL is not configured, the text configuration overview is still shown.
  • This command also registers the admin’s chat ID in the admin_chats table, enabling support ticket forwarding from /support.

---

​

/admin set_model <model_id>

Changes the primary Gemini model ID used for all AI responses at runtime — no restart required.

• Syntax: /admin set_model <model_id>
• Example:
  /admin set_model gemini-2.5-flash
  
• Effect: Updates MODEL_ID in runtime_config and persists the change to the database immediately. All subsequent AI requests use the new model.

---

​

/admin set_limit <number>

Sets the conversation history context limit — the number of past messages fed to Gemini as context when generating a reply.

• Syntax: /admin set_limit <number>
• Example:
  /admin set_limit 20
  
• Effect: Updates CONTEXT_LIMIT in runtime_config and the database immediately. Must be a positive integer; non-numeric input is rejected with an error message.

---

​

/admin set_timeout <float>

Sets the AI response generation timeout in seconds. Requests that exceed this threshold are aborted and the bot falls back to its configured fallback models.

• Syntax: /admin set_timeout <float>
• Example:
  /admin set_timeout 15.0
  
• Effect: Updates TIMEOUT in runtime_config and the database immediately. Accepts both integer and decimal values; non-numeric input is rejected.

---

​

/admin set_chance <float>

Sets the probability that the bot will spontaneously roast a random message in a group chat, without being directly addressed.

• Syntax: /admin set_chance <float>
• Example:
  /admin set_chance 0.05
  
• Effect: Updates RANDOM_ROAST_CHANCE in runtime_config and the database immediately. Accepts a decimal between 0.0 (never) and 1.0 (always); values outside this range are rejected.

---

​

/admin set_instruction <prompt>

Replaces the global system instruction (persona prompt) used for all AI responses at runtime.

• Syntax: /admin set_instruction <prompt text>
• Example:
  /admin set_instruction You are a helpful assistant that always replies in formal Persian.
  
• Effect: Updates SYSTEM_INSTRUCTION in runtime_config and the database immediately. All subsequent AI requests use the new system prompt.

---

​

/admin add_special <@username> <instruction>

Adds or updates a VIP user with a custom system instruction. When that user sends a message, the bot uses their personal instruction instead of the global system prompt.

• Syntax: /admin add_special <@username> <instruction>
• Example:
  /admin add_special @john Always respond formally to this user
  
  For names containing spaces, wrap the name in quotes:
  /admin add_special "John Doe" Always respond in English to this user
  
• Effect: Inserts or updates a row in the special_users table with the username (leading @ stripped) and the custom instruction.

---

​

/admin remove_special <@username>

Removes a VIP user and their custom instruction from the database.

• Syntax: /admin remove_special <@username>
• Example:
  /admin remove_special @john
  
• Effect: Deletes the matching row from the special_users table. The leading @ is stripped automatically before the lookup.

---

​

/admin list_special

Lists all VIP users currently registered in the database along with their custom instructions.

• Syntax: /admin list_special
• Example:
  /admin list_special
  
• Note: If no special users are registered, the bot responds with an informational message rather than an empty list.

---

​

/admin stats

Returns a brief statistics overview of the bot’s database, including total unique chats, total logged messages, and database file size.

• Syntax: /admin stats
• Example:
  /admin stats
  
• Effect: Queries get_db_stats and replies with a formatted summary. No changes are made to any configuration.

---

​

/admin broadcast <message>

Sends a plain-text message to every chat ID stored in the database. Useful for announcing downtime or updates to all active users and groups.

• Syntax: /admin broadcast <message>
• Example:
  /admin broadcast The bot will be offline for maintenance at midnight.
  
• Effect: Iterates all known chat IDs and sends the message text to each one with a short rate-limiting delay between sends. A summary of successful and failed deliveries is returned to the admin.

---

​

/reply <user_id> <message>

Sends a message directly to a user’s DM from the bot. Used by admins to respond to support tickets received via /support.

• Syntax: /reply <user_id> <message>
• Where: DMs and groups (admin-only; no private-chat restriction is enforced by the handler)
• Example:
  /reply 123456789 Your issue has been resolved
  
• Notes:
  • user_id is the numeric Telegram user ID included in the forwarded support ticket message.
  • The message is delivered to the user with a ✉️ پاسخ مدیریت header.
  • Passing a non-numeric user_id or a user_id that the bot cannot reach will return an error message to the admin.

---