Skip to main content
標準的な webhook 設定については、Webhook トリガーを設定を参照してください。 本記事では、Typeform のカスタムペイロード構造に必要となる特有の処理について説明します。

ステップ 1: Webhook ワークフローを作成

  1. Settings → Workflows」に移動
  2. + New Workflow」をクリック
  3. トリガーとして「Webhook」を選択します
  4. webhook URL をコピーします

ステップ 2: Typeform を設定

  1. Typeform でフォームを開く
  2. Connect → Webhooks」に移動
  3. Twenty の webhook URL を貼り付けます
  4. 保存

ステップ 3: Typeform のペイロードを理解する

Typeform は入れ子の JSON 構造を送信します。 簡略化した例はこちら:
重要なポイント:
  • フォームデータは form_response の下に入れ子になっています
  • 回答は配列として返され、名前付きフィールドではありません
  • 各回答には参照用にフィールドの種類とタイトルが含まれます

ステップ 4: answers 配列からフィールドを抽出する

answers は配列のため、後続ステップでは配列全体しか選択できず、個別のフィールドは選択できません。 必要なフィールドを抽出するために「Code」アクションを追加します:
以降のステップでは、変数ピッカーから contact.firstNamecontact.email のような個別フィールドを選択できるようになります。
配列の扱いの詳細については、Code アクションで配列を扱うを参照してください。

ステップ 5: レコードを作成

Create Record」アクションを追加します:

ステップ 6: テストして有効化

  1. Typeform でテスト回答を送信
  2. ワークフローの実行を確認し、データが取り込まれたことを検証
  3. ワークフローを有効化します

関連