メインコンテンツへスキップ

​
ウェブフック

セッションイベントを任意の HTTPS エンドポイントに HTTP POST で送信します。

​
設定

ダッシュボードの インテグレーション から新規作成し、タイプ「ウェブフック」を選択します。
項目説明
Webhook URLイベント送信先の URL（HTTPS のみ）

​
イベント種別

以下のイベントが発生時に送信されます。

​
session-started

セッションが開始されたとき。 
{
  "type": "session-started",
  "payload": {
    "agentId": "...",
    "session": {
      "id": "...",
      "context": { ... }
    }
  },
  "metadata": {
    "id": "...",
    "invokedAt": "2026-01-01T00:00:00.000Z",
    "workspaceId": "...",
    "integrationId": "..."
  }
}

​
user-message-sent

ユーザーがメッセージを送信したとき。 
{
  "type": "user-message-sent",
  "payload": {
    "agentId": "...",
    "session": { "id": "...", "context": { ... } },
    "message": { ... }
  },
  "metadata": { ... }
}

​
action-executed

ユーザーがアクションを実行したとき。 
{
  "type": "action-executed",
  "payload": {
    "agentId": "...",
    "session": { "id": "...", "context": { ... } },
    "action": { ... }
  },
  "metadata": { ... }
}

​
ペイロード構造

すべてのイベントには以下の共通フィールドがあります。
  • type — イベント種別
  • payload — イベント固有のデータ（エージェントID、セッション情報など）
  • metadata — イベントメタデータ（イベントID、発生日時、ワークスペースID、インテグレーションID）