連携
連携はボットと外部サービスを結びつけます。各連携は(暗号化されたシークレットを含む)保存済み設定であり、その後リアクションのアクションで使用されます。セクションは左側メニューの連携にあります。各カードには連携を追加ボタン、接続切り替えスイッチ、設定ボタンがあります。
利用可能なサービス
- AI — 言語モデル(OpenAI 互換 API)。AI 返信 を参照。
- Google Sheets — テーブルへの行の追加。
- Google Drive — フォルダーへのファイルのアップロード。
- GetCourse — GetCourse へのユーザーと取引の送信。
- Webhook — 任意のサービスへの HTTP によるデータの汎用送信。
- 外部ハンドラー — WebSocket 経由で独自バックエンドを接続: リアクションをあなたのサーバーが処理します。外部ハンドラー を参照。
設定
追加時にサービスを選択し、名前とサービスタイプに依存する設定フィールドを入力します:
Webhook
- Webhook URL — 受信エンドポイントのアドレス。
- HMAC 署名(シークレット)— 正当性の確認用。リクエストはヘッダー
X-Signature: sha256=...で署名されます。
GetCourse
- アカウントとシークレットキー。
- オブジェクト — 「ユーザー」または「取引」。
Google Sheets
- スプレッドシート ID と範囲。
- サービスアカウント JSON(シークレット)— Google サービスアカウントのキー。
Google Drive
- フォルダー ID。
- サービスアカウント JSON(シークレット)。
AI
- Base URL、モデル、システムプロンプト、API キー(シークレット)。詳細は AI 返信 を参照。
外部ハンドラー
WebSocket 連携: あなたのサーバーが GetMyBot に接続し、Telegram Bot API 形式のコマンドで返答してリアクションを処理します。
- WebSocket アドレス — あなたのサービスが接続するアドレス。
- 接続トークン(シークレット)— 作成時に1回だけ表示されます。再発行ボタンがあります。
プロトコルの詳細と実装例は 外部ハンドラー を参照してください。
リアクションでの使用
- AI と Webhook はアクション/チャンネルとしてすぐに利用できます: AI アクションを追加するか、ウェブリクエストアクションで Webhook アドレスにデータを送信してください。
- GetCourse・Google スプレッドシート・Google ドライブのアクションはリアクションコンストラクターで「近日公開」とマークされています — 連携自体は今すぐ設定できます。
セキュリティ
すべての外部リクエストは SSRF 保護を通じます(内部ネットワークへのアクセスは禁止)、また応答サイズは制限されています。連携のシークレットは暗号化されて保存されます。
次のステップ
- AI 返信 — モデルの設定と適用。
- 外部ハンドラー — WebSocket 経由での独自バックエンドの接続。
- ソースとキー — データの読み書き用 REST/OzmaDB コネクター。
- ウェブリクエストと Webhook — 受信・送信 HTTP。