Webhook

Webhookブロックは、自動的なWebhookヘッダーとオプションのHMAC署名を使用して、外部のWebhookエンドポイントにHTTP POSTリクエストを送信します。

設定

Webhook URL

Webhookリクエストの送信先エンドポイントです。静的URLと他のブロックからの動的な値の両方に対応しています。

ペイロード

リクエストボディで送信するJSONデータです。AIワンドを使用してペイロードを生成したり、ワークフロー変数を参照したりできます。

{
  "event": "workflow.completed",
  "data": {
    "result": "<agent.content>",
    "timestamp": "<function.result>"
  }
}

署名シークレット

HMAC-SHA256ペイロード署名用のオプションのシークレットです。指定すると、X-Webhook-Signatureヘッダーが追加されます。

X-Webhook-Signature: t=1704067200000,v1=5d41402abc4b2a76b9719d911017c592...

署名を検証するには、HMAC-SHA256(secret, "${timestamp}.${body}")を計算し、v1の値と比較します。

追加ヘッダー

リクエストに含めるカスタムのキーと値のヘッダーです。同じ名前の自動ヘッダーがある場合は上書きされます。

自動ヘッダー

すべてのリクエストには、以下のヘッダーが自動的に含まれます。

出力

使用例

外部サービスへの通知 - ワークフローの結果をSlack、Discord、またはカスタムエンドポイントに送信します。

Agent → Function (format) → Webhook (notify)

外部ワークフローのトリガー - 条件が満たされたときに他のシステムでプロセスを開始します。

Condition (check) → Webhook (trigger) → Response