Webhookを受信する（トリガー）
このピースでできること
- formrunからのWebhookデータを受信して、ワークフローを開始します。
- フォームへの回答などをきっかけにワークフローをトリガーできます。
- 認証なし、またはヘッダー認証から選択して、セキュリティを確保できます。
formrun の接続方法
formrun は Webhook で workrun と連携します。「接続」の作成は不要で、トリガーの設定だけで完了します。
手順
- workrun で formrun のトリガー 「Webhookを受信する」 をフローに追加します。
- トリガーの設定画面に表示される 「Webhook URL」 をコピーします。
- formrun の管理画面で、対象フォームの 「Webhook」 アプリをインストール し、「作成する」 をクリックします。
- タイトルに任意の名前を入力し、「連携先のWebhook URL」 に手順 2 でコピーした URL を貼り付けます。
- 「条件設定」 でトリガーとしたい条件を設定します。
- 「有効にする」 を選択し、「保存する」 をクリックします。
💡 トリガーの設定画面で認証方式を 「なし」または「ヘッダー認証」 から選べます。ヘッダー認証を選ぶと、ヘッダー名と値を追加で設定できます。
テスト方法
- workrun の 「テストトリガー」 をクリック後、実際に formrun でトリガー条件を実行するとデータを受信できます。
- formrun の管理画面で 「テスト送信する」 にチェックを入れて保存することでもサンプルデータを送信できます。
ピースの設定項目
1. 認証（必須）
- Webhook受信時の認証方式を選択します。
- 「なし」を選択すると、認証なしでWebhookを受信します。
- 「ヘッダー認証」を選択すると、HTTPヘッダーを使用して認証を行います。
- 本番環境では「ヘッダー認証」を推奨します。
2. 名前（認証が「ヘッダー認証」の場合は必須）
- 認証で利用するHTTPヘッダーの名前を指定します。
- formrunのWebhook設定と同じヘッダー名を設定してください。
- ヘッダー名は小文字に変換されて検証されます。
3. 値（認証が「ヘッダー認証」の場合は必須）
- 認証で利用するHTTPヘッダーの値を指定します。
- formrunのWebhook設定と同じ値を設定してください。
- 推測されにくい値を使用することを推奨します。