Telegram向けチャットボットビルダー Skill

開発者自身のエディターで、その開発者のBotFatherトークンを使って作業するTelegramボットビルダーです。Webhookと競合するロングポーリングを解消し、トークンを環境変数に保存し、再起動後も状態が保持されるように設定しました。

KissMySkills.com | インストール: このファイルをプロジェクトに配置し、Claude Code、Cursor、またはコードベースを読み取れるAIで開きます。または、Claude、ChatGPT、Geminiに貼り付けてプロジェクトを説明します。その後、開始するよう依頼してください。 この開発者と一緒に、登録済みのBotFatherトークンから実際のデプロイ後も安定して動くボットまで、エディター上でTelegramボットを構築します。「telegram botの作り方」を検索すると、どの結果も「BotFatherにメッセージを送り、トークンを取得し、メッセージを返す」ところで終わります。それはデモであって、ボットではありません。ポーリングとWebhookのどちらを使うのか、トークンをどこに保存するのか、またインメモリ辞書で状態を代用した結果、2人のユーザーが同時にメッセージを送った瞬間にひそかに壊れることについて説明していません。デモの先まで対応します。ロングポーリングとWebhookの本当の選択、相手のスタックに合うライブラリ、再起動後も保持されるチャットごとの状態、最初の100人のユーザーを超えても動き続けるデプロイを扱います。 1. Node.js/TypeScript（grammY、Telegraf）かPython（python-telegram-bot、aiogram）か、そしてバージョン。 2. 実行場所が、常時稼働するサーバーまたはコンテナか、ゼロまでスケールするサーバーレス/エッジ関数か。 3. ボットが実際に行うこと。コマンド、インラインキーボード、メディア、または状態を持つ完全な会話フローか。 4. メッセージをデータベース、別のAPI、またはLLMに送る必要があるか。 1. BotFatherへの登録: ボットのユーザー名、トークン、プライバシーモードについて説明します（グループチャット内のボットは、プライバシーモードがオフでない限り、コマンドと自分宛ての返信しか見られません。多くの開発者は、メンションにひそかに反応しない状態になって初めてこの点に気づきます）。 2. デフォルトで決めるのではなく、インフラに基づいてポーリングとWebhookを選択します。ロングポーリングには公開URLも証明書も不要で、管理下のサーバーでは適切な選択です。Webhookには公開HTTPSエンドポイントが必要です（Telegramは通常のHTTPを呼び出しません）。さらに、すべてのリクエストで確認するシークレットトークンも必要です。ボットが待機し続けられないサーバーレスまたはオートスケーリングのインフラでのみ、Webhookを選ぶのが適切です。 3. 最初のコミットからトークンをコードベースの外に保管します。環境変数またはシークレットマネージャーを使用し、ハンドラーファイルに文字列として記述してはいけません。ボットトークンが漏れると、誰でも直ちにボットを操作できるためです。 4. 再起動後も状態を保持します。チャットごとの会話データは、単純なインメモリオブジェクトではなく、Redisまたはデータベースに保存します。インメモリ辞書はデプロイのたびにリセットされ、ワーカープロセスが複数になるとすぐに状態が同期しなくなるためです。 5. 更新を二重処理しないようにします。Webhookモードではupdate_idのべき等性チェックを行います。TelegramはWebhook呼び出しが十分な速さで200を返さないと再試行するためです。遅いハンドラーでは、同じボットが2回応答してしまいます。 6. レート制限を意識します。Telegramでは、1チャットあたりおおよそ毎秒1メッセージ、全チャットで毎秒約30メッセージが許可されています。そのため、多数のユーザーへの一斉送信には、きついループではなく専用のキューとバックオフが必要です。 7. 公開URLなしでローカルテストを行い、その後、プラットフォーム独自のプロセスマネージャーでWebhookまたはロングポーリングのプロセスを稼働し続ける形でデプロイします。ターミナルでスクリプトを実行し続ける方法は使いません。 · バージョン管理に入るファイルへボットトークンをハードコードしない。すべてのセットアップ手順で、環境変数またはシークレットストアを経由させます。