workrun ヘルプサイト/Webhookをキャッチする（トリガー）

Webhookをキャッチする（トリガー）

2025/10/24 15:282026/10/20 8:40

このピースでできること

HMAC Signature：Signature Header Name（、必須）、Secret（、必須）、Algorithm（、必須・既定sha256）、Signature Encoding（、必須・既定hex）、Signature Prefix（、任意）。

AlgorithmはSHA-256/SHA-1/SHA-512、Signature EncodingはHexadecimal/Base64から選びます。送信元の署名仕様と一致させてください。Signature Prefixを指定した場合は、受信署名にもその接頭辞が必要です。

認証条件に一致したHTTPリクエストの本文と付随情報を取得できます。

実際のキー	内容・条件
	受信本文。JSONの場合は送られたキーを持つデータです。形式は送信元のContent-Typeや内容に依存します。
	受信ヘッダーの名前と値。
	URLのクエリパラメータ。
	HTTPメソッド。提供されている場合に含まれます。
	生の本文。提供されている場合に含まれます。

認証なし、Basic、Header、HMACの各条件を検証し、不一致の場合は業務データを出力しません。HTTP応答だけでフローの実行成功を判断しないでください。

キーの使い方を示す架空例です。実際の値や全項目を示すものではありません。

Webhookトリガーでは、ヘッダー認証に失敗した場合でも、送信元にHTTP 200が返されることがあります。

ただし、HTTP 200が返されたことは、認証やワークフローの実行が成功したことを意味しません。 認証ヘッダーの名前や値が一致しない場合、ワークフローが実行されず、実行履歴にも残らないことがあります。

Webhookが正常に処理されたか確認する際は、次の点をご確認ください。

HTTPステータスコードだけでフローの実行成功を判断しないようご注意ください。

Webhookトリガーの設定画面には、認証に失敗した際のHTTPステータスコードを401などに変更する設定項目はありません。

認証に失敗したリクエストへHTTP 401などを返す必要がある場合は、Webhookの前段で認証を行い、応答コードを制御する仕組みを別途設ける方法をご検討ください。

💡

送信元システムがHTTP 200のみで配信成功を判断する場合、workrun側で認証されず処理されなかったことを検知できない可能性があります。必要に応じて、送信元側の成功判定・再送条件もご確認ください。

「テストトリガー」を開始すると、「サンプルデータの生成」ボタンが表示されます。

「サンプルデータの生成」をクリックすると、外部サービスから実際にWebhookを送信しなくても、workrun側でテスト用のサンプルデータを生成できます。生成したデータは、後続ステップで使用する項目の確認や、ワークフローの設定・テストに利用できます。

ただし、サンプルデータの生成はworkrun側でテスト用データを用意する機能です。送信元サービスのWebhook設定や、実際にWebhookがworkrunへ届くことを確認するものではありません。実際の連携まで確認する場合は、送信元サービスからWebhookを送信してテストしてください。