チャットボットの接続
自作したボットサーバーのWebhook URLを登録すると、チャットで@ボット名と入力して呼び出し、応答を受け取れます。
ボットの仕組み
TabpleのボットはDiscord・Telegramのボットと同じWebhook方式です。チャットでボットを@メンションすると、Tabpleが登録されたWebhook URLにメッセージを転送し、ボットサーバーが返した応答をそのままチャットに投稿します。Tabpleはメッセージをやり取りする経路の役割だけを担い、LLM・APIトークン・ツール呼び出しの権限をボットに提供しません。回答を作るロジック(独自のLLMを含む)は、すべてボットサーバー側が担います。
ボットの登録
プロジェクト設定 → アプリと連携
プロジェクト設定の「アプリと連携」タブで「ボットを直接登録」を押し、「ボットを登録」ボタンを押します。登録・削除できるのは、プロジェクトのオーナー/管理者のみです。
名前とアバター
名前は、チャットで@の後に入力する呼び出し名です(英字/数字/ハングル/_/- 2〜30文字)。アバターは10MB以下の画像ファイルをアップロードでき、説明はメンバーに表示される短い案内文です(任意)。
Webhook URLの入力
ボットサーバーがメッセージを受け取るアドレスです。セキュリティのため、HTTPSの公開ドメインのみ使用できます。
Secretの生成
Tabpleが送るリクエストにHMAC署名を付けるときに使う秘密鍵です。32文字以上が必要で、「生成」ボタンで32バイトのランダムな値を作成できます。同じ値をボットサーバーにも保存してください。
マーケットからインストール
「アプリと連携」の「マーケットから追加」で、マーケットの「Webhookボット」アプリを選ぶこともできます。ボット名・サーバーのアドレス(Webhook URL)・Secretの3つを入力するだけで同じボットが登録され、「インストール済みアプリ」にも表示されます。
オフにする・削除する
「インストール済みアプリ」で、スイッチを使ってこのプロジェクトでだけボットを一時的にオフにでき、「削除」を押すとこのプロジェクトから外れます。削除すると、チャットでの@ボット名のメンションは動作しなくなります。
チャットで呼び出す
@ボット名でメンション
ボットがメンバーとして参加しているプロジェクトのチャンネル(非公開チャンネルを除く)で、@ボット名 質問内容の形でメンションすると、ボットが呼び出されます。メンション部分を除いた残りのテキストがボットサーバーに送られます。
応答の確認
ボットが応答を準備している間は入力中の表示が出て、応答が届くとBOTバッジ付きのメッセージとして投稿されます。ボットサーバーに問題がある場合は、「ボット応答失敗」のメッセージで原因を知らせます。
1:1 DM
ボットとの1:1のDMでは、メンションしなくてもメッセージを送るだけでボットが呼び出されます。ボットが参加しているグループDMでは、@ボット名でメンションすると呼び出されます。
呼び出しのルールと上限
- ボットは、自分がメンバーとして登録されているプロジェクトのチャンネルと、自分が参加しているDMでのみ反応します — ボットがいないプロジェクト、非公開チャンネル、このプロジェクトでオフにしたボットは、同じ名前をメンションしても呼び出されません。
- ボットが送ったメッセージに含まれるメンションは無視されます(ボット → ボットの連鎖を防止)。ボットが自分自身をメンションした場合も同様です。
- ボットごとの上限 — 1分あたり10回/1時間あたり200回
- 呼び出したユーザーごとの上限 — 1分あたり20回/1日1,000回
- プロジェクトごとの上限 — 1分あたり30回/1日5,000回
- 上限を超えた呼び出しは、応答なしで記録だけが残ります。しばらくしてから再度お試しください。
セキュリティポリシー
- Tabpleは、ボットにLLM・APIトークン・ツール呼び出しの権限を発行しません。ボットサーバーが独自のロジックと独自のLLMで動作します。
- すべての呼び出しリクエストは、登録したSecretでHMAC-SHA256署名されて送信されます — ボットサーバーは偽造されたリクエストを見分けられます。
- ボットの応答本文には通常のメッセージと同じ4,000文字の制限が適用され、添付ファイルはHTTPSのアドレスのみ最大8件まで表示されます。
- ボットサーバーの実装方法(署名の検証・非同期応答)は、次のガイド「Webhookボットサーバーを作成」で扱います。