Telegram Bot#

Create and manage Telegram bots using the Bot API.

Quick Start#

bash

# Get bot token from @BotFather on Telegram
# Create bot.py:
python scripts/bot.py --token YOUR_TOKEN --handler my_handler.py

Bot Creation Steps#

1. Open Telegram, search for @BotFather
2. Send /newbot to create new bot
3. Get API token
4. Configure webhooks or polling

Core Features#

• Commands: /start, /help, /settings
• Callbacks: Inline buttons, queries
• Groups: Admin tools, filters
• Webhooks: Receive updates via HTTP

Script Usage#

bash

python scripts/bot.py [OPTIONS]

Options:
  --token TEXT        Bot API token (required)
  --handler PATH      Python handler file
  --webhook-url URL   Webhook endpoint URL
  --port PORT         Webhook server port (default: 8443)
  --poll              Use long polling instead of webhook

Handler Format#

python

# my_handler.py
def handle_update(update, context):
    """Handle incoming updates."""
    if update.message:
        text = update.message.text
        if text == "/start":
            context.bot.send_message(
                chat_id=update.message.chat_id,
                text="Hello! I'm your bot."
            )

Examples#

See references/examples.md for:

• Echo bot
• Inline keyboard bot
• Group admin bot
• Notification bot
• Weather bot