プロジェクト紹介
Telegram 2 グループ管理ボット＋Vercel 管理画面 | Bot 開発事例
Vercel Pro にデプロイ。ゼロから作成された Telegram グループ管理ボット。ファンアウト同期 (メイングループ → サブグループ)、グループへの入群時のランダムクイズ認証、簡体字対応 (OpenCC 厳格な戦略)、キーワードブラックリスト、不正アクセス対策、退群時の急増監視、スケジュール投稿 (QStash + Vercel Cron)、および完全なバックエンド CRUD 機能。
問題の背景
Telegram の複数グループを個別管理すると規則がずれやすくなります。入室認証・フィルタ・配信を Bot が処理し、管理画面で素材と予定を設定します。
核心機能
- メイングループ → サブグループの複数グループ同期 (copyMessage fan-out)
- グループ参加資格認証（誤答/時間超過による退会）
- OpenCC 簡体字による保護 + キーワードブラックリスト
- 攻撃からの防御と、大規模な退会を防ぐ監視
- スケジュールされた投稿（QStash による正確なトリガー + Cron による最終的な処理）
- Bot DM 素材のインポート（動的なステッカーと富テキストの保持）
実装方法
- —Serverless-first grammY 構造（webhook + transformer-throttler）
- —QStash + Vercel Cron による二重でのスケジュール設定、分単位の制限を回避
- —Drizzle strict: true、破壊的な遷移の禁止
実装データフロー
- 01グループ・認証問題・投稿素材を設定する。
- 02入室確認とメッセージ規則を適用する。
- 03予約投稿を配信し、処理履歴を確認する。