カード情報を更新する
このピースでできることformrun の接続方法ステップ 1:APIキーを取得するステップ 2:workrun に接続を追加するステップ 3:Webhook を設定する(トリガーを使う場合)テスト方法ピースの設定項目1. フォームID(必須)2. カードID(必須)3. ステータスID(任意)4. 担当者の操作(任意)5. 担当者のメールアドレス(任意)6. ラベルの操作(任意)7. ラベルID(任意)8. 対応状況(任意)9. アーカイブ(任意)
このピースでできること
- formrunのカード(フォーム回答)の情報を更新します。
- ステータス・担当者・ラベル・対応状況・アーカイブのうち、必要なものだけを変更できます。
- 未選択の項目は変更されないため、意図しない上書きの心配なく使えます。
ステータス・担当者・ラベル・対応状況・アーカイブのうち、1つ以上を指定してください。すべて未入力の場合は何も更新されません。
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. フォームID(必須)
- 更新したいカードが属するフォームのID(数字)を入力します。
- formrunの「設定 > フォーム基本設定 > フォームの基本情報」にあるフォームIDで確認できます。
[設定例]
2. カードID(必須)
- 更新対象のカードのID(数字)を入力します。
- カード詳細画面のURLの末尾 の後ろに続く数字がカードIDです。
- 前のステップの「カード一覧を取得する」やトリガーの結果から差し込むこともできます。
[設定例]
3. ステータスID(任意)
- 変更後のステータスIDを数字で入力します。
- formrunの「設定 > 回答画面設定 > ステータス」から、それぞれのステータスIDを確認できます。
[設定例]
4. 担当者の操作(任意)
- 担当者を変えたい場合に選びます。
- 担当者を指定する:次の「担当者のメールアドレス」で指定した人を担当者にします
- 担当者を解除する:現在の担当者を外します
- 未選択の場合は担当者を変更しません。
[設定例]
5. 担当者のメールアドレス(任意)
- 「担当者を指定する」を選んだ場合に、担当者のメールアドレスを入力します。
[設定例]
6. ラベルの操作(任意)
- ラベルを変えたい場合に選びます。
- 指定したIDに置き換える:次の「ラベルID」で指定した内容に入れ替えます(追加ではなく置換です)
- すべて解除する:付いているラベルをすべて外します
- 未選択の場合はラベルを変更しません。
[設定例]
7. ラベルID(任意)
- 「指定したIDに置き換える」を選んだ場合に、設定したいラベルIDを追加します。
- 未入力のままだとラベルは変更されません。
- formrunの「設定 > 回答画面設定 > カードラベル」から、それぞれのラベルIDを確認できます。
[設定例]
8. 対応状況(任意)
- 「対応済みにする」または「未対応にする」を選びます。
- 未選択の場合は変更しません。
[設定例]
9. アーカイブ(任意)
- 「アーカイブする」または「アーカイブを解除する」を選びます。
- 未選択の場合は変更しません。
[設定例]