フォームとCRMの連携

フォームデータの流れ

参加者がCotonityのイベント申込フォームに入力すると、データは以下の流れでHubSpotに連携されます。

1. フォーム送信 → Cotonity APIサーバーで受信
2. 在庫確認・予約作成
3. HubSpot APIへ非同期でデータ送信（キュー経由）
4. Contact作成/更新 → Appointment作成 → アソシエーション設定

非同期処理のため、フォーム送信から HubSpotへの反映まで最大2分かかることがあります。

フィールドマッピングの設定

CotonityのフォームフィールドとhubspotのContactプロパティのマッピングは、管理画面の「HubSpot設定」→「フィールドマッピング」から設定できます。

デフォルトのマッピング： - フォームの「姓」→ Contact の lastname - フォームの「名」→ Contact の firstname - フォームの「メールアドレス」→ Contact の email - フォームの「電話番号」→ Contact の phone

カスタムフォームフィールドを追加した場合、対応するHubSpotのカスタムプロパティを先に作成してからマッピングを設定してください。

連携の確認方法

連携が正常に動作しているか確認するには、テスト予約を行い以下を確認します。

1. HubSpot CRM→「コンタクト」で申込メールアドレスを検索
2. Contactが作成されているか確認
3. Contact詳細の「Appointment」タブで予約レコードを確認
4. 予約番号・開催日・参加人数が正しいか検証

問題が発生した場合、Cotonity管理画面の「同期ログ」でエラー詳細を確認できます。