世界を動かす技術を、日本語で。

テレグラムサーバーレス

概要

  • 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.mddocs/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開発の新しい標準 として推奨

Hackerたちの意見

SQLiteのデータベースがすぐに使えるのはいいね。サイズに制限とかあるのかな?

実行時間やストレージの制限はどうなってるの?

これを使ってPlexサーバーを運用することを考えてる。

テレグラムでは、ストレージは無制限だよ™

これいいね。SignalにもTelegramみたいなボットAPIがあればいいのに。

WhatsAppもそうしてくれたらいいのに… BBMみたいに、もっと開発者に優しいプラットフォームが一般的になるといいな。

ボットAPIがないのが、Signalを素晴らしくしている要素の一つだよね。

同じく。昔はTelegramを何でも使ってたけど、エンドツーエンドの暗号化が実際にはされてないことに気づいてからやめた。ボットはすごく便利だった。いろんなバスの時刻を聞けるボットを持ってたけど、地元のバス会社のアプリよりずっと良かったよ。

毎日Signal APIを使って、エージェントチャットやエネルギー価格、サーバーダウン通知の通知を受け取ってる。セットアップはすぐ終わったけど、セットアップ時に本物の電話番号が一度必要なのがちょっと面倒。Telegramはボットのバックエンドに暗号化がないから、開発者が書いたことを全部読めちゃうのに比べたら、まだこっちの方がマシだね。

次におすすめなのはこれだね: https://signald.org/ これを使ってSignalでエージェントを動かしてるんだけど、テレグラムとの違いは自分でホストしなきゃいけないことかな。それ以外はめっちゃいいよ。

価格については何も見当たらないね。

これについても気になるな。

Hacker Newsで議論の続きを見る