> ## Documentation Index
> Fetch the complete documentation index at: https://docs.timothe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot CRM 連携

> HubSpot CRM と連携してコンタクトやセッションデータを同期する方法

セッションデータを [HubSpot CRM](https://www.hubspot.jp) に自動同期します。セッション終了時に、訪問者のメールアドレスをもとにコンタクトを作成し、セッション内容をノートとして記録します。

## 前提条件

* HubSpot アカウント

## サービスキーの作成

1. HubSpot の **設定** > **連携** > **非公開アプリ** を開く
2. **非公開アプリを作成** をクリック
3. 以下のスコープを付与:
   * `crm.objects.contacts.read`
   * `crm.objects.contacts.write`
4. アプリを作成し、**アクセストークン**（`pat-na2-` で始まる文字列）をコピー

<Info>
  サービスキーは `pat-na2-` で始まる形式である必要があります。
</Info>

## 設定

ダッシュボードの **インテグレーション** から新規作成し、タイプ「HubSpot」を選択します。

| 項目                        | 説明                                                  |
| ------------------------- | --------------------------------------------------- |
| Service Key               | HubSpot のアクセストークン（`pat-na2-...`）                    |
| Contact Property Mappings | ユーザーコンテキストのキーと HubSpot コンタクトプロパティ（内部名）の対応（任意・複数設定可） |

## 同期される内容

* **コンタクト** — セッション中に取得したメールアドレスで HubSpot のコンタクトを検索し、存在しなければ新規作成
* **ノート** — セッションの内容をコンタクトに紐づくノートとして作成
* **コンタクトプロパティ** — Contact Property Mappings を設定している場合、セッションのユーザーコンテキストの値をコンタクトプロパティに書き込み。HubSpot 側のプロパティが空の場合のみ書き込まれ、既存の値は上書きされません。ユーザーコンテキストに値がないキーはスキップされます