Introduction
# Telegram Bot Skill (Advanced)
## Purpose Provide a clean, production-oriented guide for building Telegram bot workflows via the Bot API, focusing on command UX, update handling, and safe operations using plain HTTPS.
## Best fit - You want a command-first bot that behaves professionally. - You need a reliable update flow (webhook or polling). - You prefer direct HTTP calls instead of libraries.
## Not a fit - You require a full SDK or framework integration. - You need complex media uploads and streaming in-process.
## Quick orientation - Read `references/telegram-bot-api.md` for endpoints, update types, and request patterns. - Read `references/telegram-commands-playbook.md` for command UX and messaging style. - Read `references/telegram-update-routing.md` for update normalization and routing rules. - Read `references/telegram-request-templates.md` for HTTP payload templates. - Keep this SKILL.md short and use references for details.
## Required inputs - Bot token and base API URL. - Update strategy: webhook or long polling. - Command list and conversation tone. - Allowed update types and rate-limit posture.
## Expected output - A clear command design, update flow plan, and operational checklist.
## Operational notes - Prefer strict command routing: `/start`, `/help`, `/settings`, `/status`. - Always validate incoming update payloads and chat context. - Handle 429s with backoff and avoid message bursts.
## Security notes - Never log tokens. - Use webhooks with a secret token header when possible.