telegram

Telegram（スキルルーター）

ルータースキル：タスクに合ったリファレンスを選んでください。

クイックナビゲーション

タスク	リファレンス
Telegram ボットを初めて使う方	bots-overview.md
ボット機能の概要	bot-features.md
API メソッド／型	bot-api.md
Webhook の設定とセキュリティ	webhooks.md
aiogram 3 のハンドラー／FSM	aiogram-patterns.md
キーボードの UX	keyboard-design.md
インラインモード	inline-mode.md
Mini Apps（Web Apps）	mini-apps.md
決済（Stars）	payments.md
認証（Login Widget、URL Auth）	authentication.md
レート制限とパフォーマンス	performance.md

重大な禁止事項

• ❌ 同じボットでポーリングと Webhook を同時に使用しない
• ❌ トークンやシークレットをハードコードしない — 環境変数を使用する
• ❌ callback_data やログにシークレットを含めない
• ❌ answer_callback_query への応答を省略しない — 必ず応答する
• ❌ Webhook ハンドラーでブロッキング処理を行わない — バックグラウンドタスクを使用する
• ❌ ハッシュ検証なしで Login Widget のデータを信頼しない

完了の定義

• Webhook ハンドラーで X-Telegram-Bot-Api-Secret-Token を検証する
• キーボード：1 行あたり最大 2 個のボタン、モバイルファースト
• コールバックデータを検証し、無条件に信頼しない
• ハンドラーが冪等である、または重複排除を行う

リリースノート（3.29.x - 3.31.x / Bot API 10.1 - 10.3）

• aiogram 3.31.0 は Bot API 10.3 を完全にサポートし、リッチメッセージ（リッチブロックボタン、展開可能なブロック引用、ドキュメントブロック）、エフェメラルメッセージ（EphemeralMessageParameters、can_stop／keep_on_stop を備えたメッセージの下書き）、新しい返信マークアップ制御（DisabledButton、force_reply）を追加します。3.30.0 では Bot API 10.2、3.29.0 では Bot API 10.1 が追加されました。最近の aiogram を対象にする場合は、新しいメソッド／型のスキーマを前提としてください。
• 3.31.0 では、Webhook のパスにおけるディスパッチャーのコンテキスト喪失、Bot API レベルの parse_mode が新しい写真／動画エンティティに適用されない問題、ライブフォトのコンテンツタイプ判定、地域固有の i18n ロケール解決も修正され、脆弱性のある依存関係は修正版に更新されました。
• 3.29.1 では、ネストされたユニオンの検証時に発生する深刻な（指数関数的な）速度低下が修正され、修正済みバージョンでは負荷の高いハンドラー／フィルターモデルの解析が大幅に高速化されました。

リリースノート（3.28.x / Bot API 10.0）

• aiogram 3.28.x は Bot API 10.0 をサポートし、ゲストモードの更新、拡充された投票／メディアのフロー、ライブフォト、リアクション管理メソッド、管理対象のビジネスボットのアクセス設定を追加します。
• 3.28.1+ のパッチ系列では InputPollOption.media の検証も修正されているため、投票／メディア連携では新しいスキーマと、修正済み aiogram シリアライザーの動作を前提としてください。

リンク

• Telegram Bot API
• aiogram のリリース
• aiogram のドキュメント

関連スキル

• PostgreSQL — データベース層向け
• FastAPI — API 層向け（存在する場合）