Skip to main content

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.

These commands are available to all users in DMs and groups (where applicable). No special permissions are required — any user who can message the bot can invoke them.

​
/start

Displays a personalized greeting message using the sender’s first name. Also handles deep-linked guest album delivery when called with a guest_album_ parameter.
  • Syntax: /start
  • Where: DMs and groups
  • Example: 
    /start
  • Note: When opened via a deep link (e.g. from a guest album button), the bot delivers the full album directly to the user’s DM instead of showing the greeting.

​
/help

Displays a dynamically-generated Persian help guide written in casual Tehrani slang. The guide is formatted with RTL-safe HTML and lists all available commands with usage examples. Admins who invoke /help also see admin-only commands (/reply and /admin) appended to the guide.
  • Syntax: /help
  • Where: DMs and groups
  • Example: 
    /help
  • Note: The help text is rendered with parse_mode="HTML" and includes an inline button linking to the bot’s GitHub source repository.

​
/ask <question>

Sends a single question directly to Gemini without loading or modifying the current chat history. This is useful for quick, one-off lookups that should not influence the ongoing conversation context.
  • Syntax: /ask <question>
  • Where: DMs and groups
  • Example: 
    /ask What is the capital of France?

    /ask پایتخت ژاپن کجاست؟
  • Note: This command does not use or update the persistent chat history. Gemini responds to the question in isolation using a neutral, direct system instruction — sarcasm and persona are disabled for /ask responses. Omitting the question triggers a usage reminder.

​
/tldr

Generates a sarcastic, informal Persian summary of the last 150 messages in the current group chat. The summary is written in casual Tehrani slang and playfully roasts the participants based on their messages.
  • Syntax: /tldr
  • Where: Groups only
  • Example: 
    /tldr
  • Note: Requires at least some message history stored in the database for the current group. If no history exists, the bot will say so. The summary is generated by Gemini with fallback model support.

​
/transcribe

Transcribes a voice note to Persian text using Gemini’s speech-to-text capability. Must be used as a reply to an existing voice message.
  • Syntax: Reply to a voice message, then send /transcribe
  • Where: DMs and groups
  • In groups: Use /transcribe@BotUsername to disambiguate the command when multiple bots are present
  • Example: 
    [reply to a voice note] → /transcribe
  • Notes:
    • The command must be sent as a reply to a voice or audio message — sending it standalone will result in an error prompt.
    • The audio is sent to Gemini as audio/ogg and the transcription is returned verbatim without translation.
    • Gemini processes the audio with fallback model support.

​
/support <message>

Submits a support ticket to the bot’s registered admins. The message is forwarded to all admin chat IDs stored in the database, along with the sender’s name, username, and Telegram user ID.
  • Syntax: /support <message>
  • Where: DMs only (group usage is silently ignored)
  • Example: 
    /support The bot stopped responding in my group

    /support یه باگ پیدا کردم
  • Notes:
    • Admins must have used /admin at least once to register their chat ID; if no admins are registered, the bot will inform the user.
    • The forwarded message includes the sender’s full name, username (if set), and numeric user ID — the user ID is used by admins to reply via /reply.

​
/start_discussion

Activates discussion mode for the current chat. In this mode the bot switches to a polite, formal, and technically precise persona — casual slang and sarcasm are suppressed.
  • Syntax: /start_discussion
  • Where: DMs and groups
  • Example: 
    /start_discussion
  • Notes:
    • Requires DISCUSSION_MODE_ENABLED=True (this is the default). If disabled by an admin, the bot will notify users.
    • The setting is persisted per-chat in the database (is_discussion=1).
    • Use /end_discussion to return to the default casual persona.

​
/end_discussion

Deactivates discussion mode for the current chat, returning the bot to its default casual, sarcastic Tehrani persona.
  • Syntax: /end_discussion
  • Where: DMs and groups
  • Example: 
    /end_discussion
  • Note: If discussion mode was not active in the current chat, the bot will notify the user rather than silently doing nothing.

Build docs developers (and LLMs) love

Get started for freeTalk to us