AgentSkillsCN

telegram

Telegram Bot开发指南：从Bot基础概念入手，深入探讨aiogram 3种核心模式（处理器/中间件/FSM有限状态机）、Webhook回调机制、键盘交互体验、内联模式、Mini Apps迷你应用、支付功能（Stars星币/订阅服务）以及身份认证流程。关键词：Telegram、aiogram、Bot API、Webhook回调、处理器、中间件、FSM有限状态机、内联键盘、回复键盘、callback_query回调、内联模式、Mini Apps迷你应用、Web Apps网页应用、支付功能、Telegram Star星币、登录小部件。

SKILL.md
--- frontmatter
name: telegram
description: "Telegram Bot development playbook: bot fundamentals, aiogram 3 patterns (handlers/middlewares/FSM), webhooks, keyboard UX, inline mode, Mini Apps, payments (Stars/subscriptions), authentication. Keywords: Telegram, aiogram, Bot API, webhook, handlers, middlewares, FSM, inline keyboard, reply keyboard, callback_query, inline mode, Mini Apps, Web Apps, payments, Telegram Stars, Login Widget."
version: "3.24.0"
release_date: "2026-01-02"

Telegram (Skill Router)

Router skill: pick the reference that matches your task.

Quick Navigation

TaskReference
New to Telegram botsbots-overview.md
Bot capabilities overviewbot-features.md
API methods/typesbot-api.md
Webhook setup & securitywebhooks.md
aiogram 3 handlers/FSMaiogram-patterns.md
Keyboard UXkeyboard-design.md
Inline modeinline-mode.md
Mini Apps (Web Apps)mini-apps.md
Payments (Stars)payments.md
Authentication (Login Widget, URL Auth)authentication.md
Rate limits & performanceperformance.md

Critical Prohibitions

  • •❌ No polling + webhooks simultaneously for same bot
  • •❌ No hardcoded tokens/secrets — use environment variables
  • •❌ No secrets in callback_data or logs
  • •❌ No ignoring answer_callback_query — always respond
  • •❌ No blocking work in webhook handlers — use background tasks
  • •❌ No trusting Login Widget data without hash verification

Definition of Done

  • • Webhook handlers validate X-Telegram-Bot-Api-Secret-Token
  • • Keyboards: max 2 buttons per row, mobile-first
  • • Callback data validated, not trusted blindly
  • • Handlers are idempotent or have de-duplication

Related Skills