Webhookを受信する（トリガー）
このピースでできることformrun の接続方法ステップ 1：APIキーを取得するステップ 2：workrun に接続を追加するステップ 3：Webhook を設定する（トリガーを使う場合）テスト方法ピースの設定項目1. 認証（必須）2. 名前（認証が「ヘッダー認証」の場合は必須）3. 値（認証が「ヘッダー認証」の場合は必須）
このピースでできること
- formrunからのWebhookデータを受信して、ワークフローを開始します。
- フォームへの回答などをきっかけにワークフローをトリガーできます。
- 認証なし、またはヘッダー認証から選択して、セキュリティを確保できます。
formrun の接続方法
formrun と workrun の連携方法は、使うピースによって 2 種類あります。
- アクション（カード一覧の取得・メール送信など）を使う場合 → ステップ 1・2 の APIキー接続 が必要です
- トリガー（Webhookを受信する）だけを使う場合 → 接続の作成は不要です。ステップ 3 の Webhook 設定のみ行ってください
ステップ 1：APIキーを取得する
- formrun にログインし、対象チームの 「チーム設定」 画面を開きます。
- 「API設定」 から API キーを発行します。
- 発行された API キーをコピーしておきます。
ステップ 2：workrun に接続を追加する
- workrun で formrun のアクションをフローに追加します。
- 「接続を選択」の横にある 「＋ 新しい接続」 をクリックします。
- 「APIキー」 フィールドに、ステップ 1 でコピーした API キーを貼り付けます。
- 「保存」 をクリックして接続を完了します。
ステップ 3：Webhook を設定する（トリガーを使う場合）
- 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設定と同じ値を設定してください。
- 推測されにくい値を使用することを推奨します。