Webhook機能

Webhook機能を使うと、外部のサービスやスクリプトからHTTPリクエストを送るだけで、SamuraiAIのワークフローを実行できます。手動で画面を操作しなくても、外部のツールや自動化の仕組みと連携してワークフローを起動できるようになります。

機能概要

Webhook機能の主な特徴は以下の通りです。

ワークフロー編集画面でStartノードを選択し、右側のプロパティパネルを開きます。「トリガー」のドロップダウンから「Webhook」を選択します。

Webhook設定画面

トリガーをWebhookに切り替えると、専用のEndpoint URLが発行されます。このURLにPOSTリクエストを送信するとワークフローが実行されます。

URLの右側にあるボタンでコピーできます。

実行ユーザーには、Webhookリクエストを処理するユーザーが表示されます。このユーザーの権限や認証情報を使ってワークフローが実行されます。

外部からデータを受け取りたい場合は、Requestセクションの「変数を追加」から入力変数を設定します。

設定できる変数の種類:

変数を追加すると、サンプルのリクエストボディ（JSON）が表示されます。外部サービスからリクエストを送るときの参考にしてください。

Responseセクションで、レスポンスモードを選択します。

Request・Responseの設定

すぐに応答を返してバックグラウンドで実行する（デフォルト）

リクエストを受け取るとすぐにHTTP 202レスポンスを返し、ワークフローをバックグラウンドで実行します。実行結果を待たずにすぐ次の処理に進みたい場合に適しています。

レスポンス例:

{
  "status": "accepted",
  "thread_id": "uuid-xxx-xxx-xxx"
}

ワークフローの完了を待ってから応答を返す

ワークフローが完了するまで待ち、実行結果を含むHTTP 200レスポンスを返します。実行結果をすぐに利用したい場合に適しています。

このモードではタイムアウト時間（1〜300秒、デフォルト60秒）を設定できます。

レスポンス例:

{
  "status": "completed",
  "thread_id": "uuid-xxx-xxx-xxx",
  "output": {
    "workflow_output": "..."
  }
}

設定が完了したら「保存」をクリックします。保存するとEndpoint URLが有効になり、外部からリクエストを受け付けられるようになります。

利用シーン	内容
フォーム送信時	問い合わせフォームの送信をトリガーに、自動で回答を生成する
Google Apps Script連携	スプレッドシートの更新をトリガーに、GASからワークフローを呼び出す
定期バッチ処理	外部のスケジューラーからデータ処理ワークフローを起動する
アプリ連携	自社アプリのイベントに応じてワークフローを実行する

これで、外部サービスやスクリプトからSamuraiAIのワークフローを呼び出せるようになります。既存の業務ツールとの連携に、ぜひ活用してみてください。

最終更新日: 2026/04/16