はじめに

Pabal の紹介

Pabal とは何か、どのように構成されているか、今できることとまだできないこと。

Pabal とは

擺撥（パバル、파발）は、朝鮮時代に馬を乗り継ぎながら急ぎの知らせを走り継いだ駅站の制度です。Pabal.me はその名を取ったメッセンジャーで、組織やコミュニティが自前のサーバーで運用する Telegram 互換のメッセンジャーです。

• サーバーを自分で運用します。アカウント・会話・写真はすべて、運営者のサーバーとデータベース（PostgreSQL）に保存されます。サーバープログラムの名前は HunsTelegram（Java 21）です。
• Telegram と同じ言葉を話します。アプリとサーバーの間は Telegram と同じ MTProto 2.0（レイヤー 216）、ボットとサーバーの間は Telegram と同じ HTTP Bot API です。そのため、Telegram 用に作られたアプリ・ライブラリ・ボットが、アドレスを変えるだけで Pabal に接続できます。
• Telegram とはつながっていない、別の世界です。Pabal のアカウントは Pabal サーバーにしか存在せず、Telegram のユーザーとメッセージをやり取りすることはできません。

AI エージェントとの会話：音声ボットが有効になると、ボットはメッセージに答え、電話にも出ます。同じボットに、パソコンではメッセージで尋ね、スマートフォンや Apple Watch から電話をかけられ、誰でも @BotFather でそうしたボットを作れます。まだ準備中で、何ができるのか、データがどこへ行くのかは AI エージェントにまとめました。

どのように構成されているか

上の図はメッセージが通る道です。音声ボットを有効にしたサーバーには、通話用の入口がさらに加わります — 通話中継（UDP 3478）と Apple Watch の音声のエッジ（WSS）。その道は AI エージェントに描きました。

今できること、まだできないこと

Telegram との関係

Pabal は、Telegram の公開されたプロトコルに従う独立したサーバーです。Telegram 社とは関係がなく、Telegram のサーバーに接続することもありません。

• 互換性があるもの：MTProto 2.0（4 種類のトランスポート、ハンドシェイク、一時キーのバインド）、レイヤー 216 のリクエスト・レスポンス形式、HTTP Bot API のアドレス形式・リクエスト・レスポンス・エラー形式。公式の Telegram Desktop 6.2.6 を改変せずに（サーバーアドレスと公開鍵だけを変えて）接続し、確認しました。
• 異なるもの：アカウントとデータはサーバーごとに別々です。ユーザー ID・メッセージ ID・ファイル ID は、このサーバーの中でのみ意味を持ちます。Telegram で使っていたボットトークンは使えず、Pabal の @BotFather から新しく受け取る必要があります。

リンクの形式

アプリとサーバーは https://pabal.me/ でリンクを作ります。ブラウザーで開くと、アプリを開くための小さなページが表示されます。

ユーザー名は、英字で始まる英字・数字・アンダースコアの 5〜32 文字です（ボットは bot で終わる）。docs、admin、health のようにサイトが使うパスと同じ名前は、リンクでは開けません。

セキュリティモデル

• アプリ ↔ サーバー：MTProto 2.0 で暗号化されます。アプリはサーバーの RSA 公開鍵を組み込んでビルドされるため、別のサーバーが Pabal サーバーになりすますことはできません。会話は Telegram の「クラウドチャット」と同じで、サーバーは内容を読むことができます（エンドツーエンド暗号化ではありません）。信頼できる人がサーバーを運用しなければならないのはこのためです。
• ボット ↔ サーバー：Bot API は HTTPS でのみ公開します。ボットトークンはボットのパスワードです — 漏れた場合は @BotFather で /revoke を使って変更してください。以前のトークンと、そのトークンによる接続はただちに切断されます。
• サーバー → Webhook：サーバーは、HTTPS かつグローバルアドレスの Webhook にのみリクエストを送ります。プライベートネットワーク・ループバック・クラウドのメタデータのような内部アドレスは拒否します。ボットは secret_token を使って、リクエストが本物の Pabal サーバーから来たかどうかを確認できます。
• サーバー → Android の通知：プッシュ通知は Google の Firebase Cloud Messaging（FCM）を経由します。通知の内容（送信者の名前、メッセージのプレビュー）は、サーバーがその端末だけが持つ鍵で暗号化して送るため Google には読めず、Google が見るのはデバイストークンや送信時刻といった配信情報だけです。運営者は、通知からメッセージの内容を完全に省くこともできます。
• サーバー → iPhone の通知：iPhone のプッシュ通知は Apple の APNs を経由します。Android と同じ方式で、Apple に見える表の文言は「新しい通知があります」だけで、送信者と内容はその端末だけが持つ鍵で暗号化され、スマートフォンの中で復号されます。プッシュを含むアプリのビルド（1.1）からです。
• 音声ボットの通話（準備中）：ボットとの通話は、人と人との通話とは違い、エンドツーエンド暗号化ではありません。Pabal の音声ゲートウェイが音声を復号して AI モデルに渡し、既定のエンジンを使うと通話の音声は米国（Google Cloud us-central1）の Google へ送られます。運営者が決められること — サーバーを自ら運営する、ボットのオーナーのモデルキー、ストリームモード、運営者のスイッチ — は AI エージェント — 自分たちで決められることにあります。
• 管理：管理画面はサーバー自身（127.0.0.1）でのみ開き、トークンがなければデータを見られません。運営者は SSH トンネルで入ります。
• 保存：認証キーはサーバーが復号に使う必要があるため、データベースにそのまま入っています。データベースとバックアップは、サーバーの RSA 秘密鍵と同じくらい厳重に守る必要があります。

用語