概要
- Telegram Serverless はバックエンドサーバー不要でBotやMini Appを運用可能
- JavaScriptモジュール を記述し、コマンド一つでデプロイ
- V8サンドボックス 内で高速かつ安全に実行
- Bot APIやデータベース が標準搭載、設定不要
- 開発・運用・スケールの手間を大幅削減
Telegram Serverlessの概要
- Telegram Serverless は、BotやMini Appのバックエンド処理をTelegramのインフラ上で直接実行するサービス
- サーバー・コンテナ管理不要 で、スケーリングも自動対応
- JavaScriptモジュール を記述し、ワンコマンドでデプロイ可能
- V8サンドボックス 内で実行され、Bot APIや内蔵データベースへのアクセスが高速・安全
- 旧来のVPSやクラウド関数、ホスティングの設定作業が不要
Serverlessのメリット
- インフラ管理不要 :サーバーレンタルや監視、パッチ作業が完全不要
- 自動スケール :Botの利用状況に応じて自動でリソース調整
- Bot API・DB・HTTP が最初から利用可能、追加設定や認証情報の管理不要
- 高速・独立した実行環境 :各イベントごとにV8サンドボックスで処理
- リアルな開発フロー :ローカルでバージョン管理し、変更点を確認しながらデプロイ
開発モデル・プロジェクト構成
- 開発はローカルフォルダ で完結、バージョン管理対応
- クラウド側 にデプロイされたモジュールとDBが存在
- tgcloud CLI がローカルとクラウドの橋渡し役
- SSH不要、npx tgcloud pushでデプロイ完了
- プロジェクト構成 :
- handlers/:各Telegramイベント用エントリポイント
- lib/:共通コード
- schema.js:データベーステーブル定義
クイックデモ
- schema.js でテーブル定義、 handlers/message.js でイベント処理
- npx tgcloud push でコードをクラウドにアップロード
- npx tgcloud migrate でDBテーブル作成
- 永続的な状態管理 がサーバーレスで実現
利用シーン
- 会話型AI :ユーザーごとの状態をDBに保存
- Mini Appのバックエンド :ユーザーデータや動的コンテンツの提供
- ゲーム・ツール :リーダーボードやクイズ等の実装
- 自動化・外部連携 :サードパーティAPIとの連携処理
開発手順(Getting started)
- Node.js 18以上 と@BotFatherで登録済みBotが必要
- Serverless機能を@BotFatherでON にし、CLIアクセストークンを取得
- プロジェクト作成 :
- npm create @tgcloud/bot example_bot
- cd example_bot
- Botとのリンク :npx tgcloud loginでCLIアクセストークン入力
- 状態確認 :npx tgcloud statusやnpx tgcloud diffで変更点把握
- デプロイ :npx tgcloud pushで変更をクラウド反映
- DBテーブル追加 :schema.js編集後、push&migrateでDBスキーマ反映
- データの保存・取得 :handlers/message.jsでDB操作
- デプロイなしの即時テスト :npx tgcloud runでローカルファイルを使って動作確認
- 同期管理 :
- npx tgcloud status:変更点確認
- npx tgcloud push:デプロイ
- npx tgcloud pull:クラウドの内容をローカルに反映
- npx tgcloud fetch:参照コピーの更新
- npx tgcloud reset:ローカル変更の破棄
- 競合検出 も自動対応
AIアシスタントとの連携
- AGENTS.md や docs/tgcloud-sdk.md がプロジェクトに自動生成
- AIエージェント (OpenAI、Claude Code、Cursor等)による自動コーディング支援
- シンプルなSDK とプロジェクト構成でAIによる保守・開発が容易
- 2ステップデプロイ (push/migrate)もAIが理解しやすい設計
BotFatherアプリでの操作
- スマートフォンのみでもプロジェクト管理可能
- ハンドラーの作成・編集・テスト実行
- ライブラリ(lib/)の操作
- データベース(schema.js)の編集・変更適用
- CLIアクセストークンの取得
まとめ
- Telegram Serverless はBot/Mini App開発・運用に革命をもたらすプラットフォーム
- サーバーレス・自動スケール・高速DB・AI連携 など、現代的な開発要件を網羅
- 初心者から上級者、AIアシスタントまで 幅広い開発スタイルに対応
- Bot開発の新しい標準 として推奨