> For the complete documentation index, see [llms.txt](https://docs.immedio.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.immedio.io/company-settings/integrations/hubspot.md).

# HubSpot連携

HubSpotと連携することで、面談予約時のミーティング作成やコンタクトの自動作成/更新、データ同期を行う機能です。

## HubSpot連携とは

HubSpot連携とは、immedioとHubSpotを接続し、面談予約時のミーティング作成やコンタクトの自動作成/更新、データ同期を行う機能です。これにより、HubSpotでの顧客管理とimmedioでの面談管理を一元化できます。

## HubSpot連携でできること

| 機能          | 説明                                                              |
| ----------- | --------------------------------------------------------------- |
| ミーティング作成    | 面談予約時にHubSpotにミーティングオブジェクトを自動作成し、コンタクトと関連付ける（別途面談タイプごとの連携設定が必要） |
| コンタクトの作成/更新 | immedioプロパティとHubSpotプロパティのマッピングによるコンタクトの自動作成/更新                 |
| データ同期       | HubSpotオブジェクトの項目を定期同期し、フローチャートルーターで利用                           |

## HubSpot連携の設定方法

HubSpot連携は2段階の設定が必要です：

1. 企業全体でのHubSpot接続設定
2. 面談タイプごとの連携設定

### 1. 企業全体でのHubSpot接続設定

#### 必要な権限

**HubSpot側の権限**

* スーパー管理者権限またはアプリマーケットプレイスのアクセス権限

**immedio側の権限**

* オーナーまたはマネージャーの権限

#### 接続手順

1. 管理画面から「企業設定」→「外部ツール連携」を選択します
2. 「HubSpot連携」セクションで「HubSpotと連携する」ボタンをクリックします
3. HubSpotの認証画面が表示されるので、HubSpotアカウントでログインします
   * **接続時の警告について**

     immedioのHubSpotアプリはHubSpotによる認可を得ていないため、「まだ確認されていないアプリを接続しようとしています」という警告が表示されます。こちらの認可を得る予定は今のところないため、非表示にはできません。無視して進めていただくようお願いします。「アプリを接続」をクリックして接続を完了してください。
4. 以下の権限を許可します（詳細は[許可する権限（スコープ）](#deal-read-scope)を参照）：
   * 会社の読み取り権限
   * コンタクトの読み取り権限
   * コンタクトの書き込み権限
   * オーナーの読み取り権限
5. 認証が完了すると、連携設定が有効になります

#### 許可する権限（スコープ） <a href="#deal-read-scope" id="deal-read-scope"></a>

連携時には以下の権限を許可します。基本の権限は常に付与され、任意の権限は連携ボタンの上にある「連携で追加する権限（スコープ・任意）」から、機能に応じて選択して連携できます。

| 権限         | スコープ                         | 区分       | 用途                                                                                                                  |
| ---------- | ---------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
| 会社の読み取り    | `crm.objects.companies.read` | 基本（常に付与） | 会社（Company）の同期や、コンタクト新規作成時の会社の自動紐づけに使用します                                                                           |
| コンタクトの読み取り | `crm.objects.contacts.read`  | 基本（常に付与） | コンタクトの同期や照合に使用します                                                                                                   |
| コンタクトの書き込み | `crm.objects.contacts.write` | 基本（常に付与） | コンタクトの自動作成/更新に使用します                                                                                                 |
| オーナーの読み取り  | `crm.objects.owners.read`    | 基本（常に付与） | 担当者（オーナー）情報の参照に使用します                                                                                                |
| 取引の読み取り    | `crm.objects.deals.read`     | 任意       | [HubSpotを参照した保有商談上限数](/user-group-management/users/detail.md#hubspot-deal-limit)で、担当者が抱える進行中の取引（Deal）数を参照するために使用します |

**注意事項**

* 任意の権限を必要とする機能を利用する場合は、連携時に該当のスコープを選択してから連携してください。
* すでにHubSpot連携済みの場合でも、追加の権限を付与するには「HubSpot連携を解除する」で一度連携を解除し、該当のスコープを選択して再度連携する必要があります。

#### 接続解除手順

1. 管理画面から「企業設定」→「外部ツール連携」を選択します
2. 「HubSpot連携」セクションで「HubSpot連携を解除する」ボタンをクリックします
3. 確認ダイアログで「OK」をクリックします

**設定の保持について**

HubSpot連携を解除しても、各面談タイプで設定したHubSpot連携の設定内容は保持されます。再度HubSpot連携を有効にした際は、以前の設定状態で利用を再開できます。

### 2. 面談タイプごとの連携設定

企業全体でHubSpot連携を有効にした後、各面談タイプでHubSpot連携の有効/無効を個別に設定できます。

詳細な設定方法については、[CRM連携設定](/meeting-settings/reservation-settings/crm-settings.md)のページを参照してください。

#### 設定のポイント

* 面談タイプごとに個別にHubSpot連携の有効/無効を設定可能
* ミーティングのタイトルと内容は面談予約通知の設定から自動取得

## 権限設定

**HubSpot側の権限**

* HubSpot接続・解除: スーパー管理者権限またはアプリマーケットプレイスのアクセス権限

**immedio側の権限**

* HubSpot接続・解除: オーナーまたはマネージャーの権限

## 同期項目設定 <a href="#sync-settings" id="sync-settings"></a>

HubSpotから定期的に同期する項目を設定する機能です。同期された項目はフローチャートルーター内で使用できます。

### 同期項目設定とは

HubSpotのオブジェクトから指定した項目を定期的に同期し、immedio内で利用可能にする機能です。オブジェクトは以下の2種類から選択できます：

* コンタクト（Contact）
* 会社（Company）

同期されたデータは、主にフローチャートルーター上での突合に利用します。

#### 設定項目

| 項目              | 説明                              |
| --------------- | ------------------------------- |
| 「会社」で取得する項目名    | HubSpotの会社オブジェクトから取得するプロパティ名    |
| 「コンタクト」で取得する項目名 | HubSpotのコンタクトオブジェクトから取得するプロパティ名 |

#### 設定方法

フローチャートルーター上での突合に利用したいオブジェクトの欄に、利用する項目名を入力します。

これは、HubSpotの設定画面で「プロパティ」を検索し、該当のオブジェクトのプロパティ一覧から確認できます（「内部名」の列に表示されているアルファベットの文字列）。

取得してきた項目を入力して保存します。

同期テストを行なって、項目が正しいか確認して下さい。エラーが出たら、項目名を正しく取得しているか確認してください。

#### 注意事項

* ここで設定された項目は定期的に同期され、フローチャートルーター内で使用することができます
* 項目名はHubSpotの内部名（英数字）を指定してください

### 同期操作

#### 同期テスト

設定した項目がHubSpotに存在するかチェックする機能です。必ずこちらでテストを行なって下さい。

**同期テストの手順**

1. 各オブジェクトの項目名入力欄で、取得したい項目名を入力
2. エンターキーを押して項目を追加
3. 保存をする
4. 「HubSpotと同期テストをする」ボタンをクリック

**注意点**

* 項目の存在確認のみ実行します。immedioのデータベースには反映されません。反映したい場合は、手動同期を実行ください
* 必ず保存を行なってから実行してください。保存を行わないと項目が反映されません

#### 自動同期

毎日深夜に、指定された項目を使ってデータ同期を自動実行しています。 急いで確認したい場合（フローチャートルーターの動作確認をしたい場合など）は手動同期をご利用ください。

#### 手動同期

HubSpotとの同期を手動で実行する機能です。

* 「HubSpotと同期をする」ボタンをクリックして実行できます
* 2時間に1度のみ実行可能です
* 同期中や最後の同期から2時間以内は実行不可となります

### 注意事項

* 手動同期は2時間に1度しか実行できません
* 同期中、もしくは最後の同期から2時間以内は同期ができません

## コンタクトの作成/更新 <a href="#contact-write" id="contact-write"></a>

### コンタクトの作成/更新とは

コンタクトの作成/更新とは、immedioのプロパティとHubSpotのプロパティを対応付け（マッピング）し、フォーム送信や予約、アンケート回答などのタイミングでHubSpotにコンタクトを自動作成/更新する機能です。これにより、Zapier等の外部ツールを使わずに、immedioからHubSpotへ直接コンタクトを作成できます。同じメールアドレスのコンタクトがHubSpot上に既に存在する場合は、新規作成ではなく既存コンタクトの更新を行います。

### コンタクトの作成/更新でできること

| 機能              | 説明                                                                                  |
| --------------- | ----------------------------------------------------------------------------------- |
| 作成/更新連携の有効化/無効化 | コンタクトの自動作成/更新を有効または無効にする                                                            |
| プロパティマッピングの設定   | immedioのプロパティとHubSpotのプロパティの対応付けを設定する                                               |
| 更新種別の設定         | マッピング項目ごとに、既存コンタクト更新時の上書きルールを設定する                                                   |
| マッピングの追加・削除     | 固定マッピング以外のカスタムマッピングを自由に追加・削除する                                                      |
| 会社の自動紐づけ        | コンタクト新規作成時に、メールアドレスのドメインでHubSpot上の会社（Companies）を検索し、自動的に紐づける（既存コンタクトの更新時は紐づけを行いません） |

### 設定方法

1. HubSpot連携設定画面で「コンタクトの作成/更新」タブを選択
2. 「コンタクトを作成/更新する」にチェックを入れる
3. マッピングテーブルで、必要なプロパティマッピングと更新種別を設定する
4. 「保存する」ボタンをクリック

### 設定項目

| 項目            | 説明                   | 設定値      |
| ------------- | -------------------- | -------- |
| コンタクトを作成/更新する | コンタクト自動作成/更新機能の有効/無効 | チェックボックス |

### マッピング設定 <a href="#contact-write-mapping" id="contact-write-mapping"></a>

マッピングテーブルでは、immedioのプロパティとHubSpotのプロパティを1対1で対応付けます。各マッピング項目には「更新種別」を設定でき、既存コンタクトの更新時にどのように値を反映するかを制御できます。

#### マッピングテーブルの項目

| 項目           | 説明                |
| ------------ | ----------------- |
| immedioプロパティ | immedio側のプロパティ    |
| HubSpotプロパティ | HubSpot側のプロパティ    |
| 更新種別         | 既存コンタクト更新時の上書きルール |
| 操作           | カスタムマッピングの削除ボタン   |

#### 固定マッピング

以下のプロパティは固定マッピングとして常に表示され、変更できません。

| immedioプロパティ | HubSpotプロパティ        | 説明                      |
| ------------ | ------------------- | ----------------------- |
| email        | email               | メールアドレスのマッピングです。変更できません |
| person\_name | lastname, firstname | 氏名のマッピングです。変更できません      |

#### カスタムマッピング

固定マッピング以外のプロパティマッピングは自由に追加・削除できます。

* **追加**: マッピングテーブル下部の「＋（追加）」ボタンをクリックすると、新しいマッピング行が追加されます
* **削除**: 各行の操作列にあるゴミ箱ボタンをクリックすると、該当のマッピング行が削除されます

#### 更新種別 <a href="#update-type" id="update-type"></a>

更新種別は、同じメールアドレスのコンタクトがHubSpot上に既に存在する場合に、各マッピング項目の値をどのように反映するかを制御する設定です。マッピングテーブルの「更新種別」列見出しにあるヘルプアイコンからも各種別の説明を確認できます。

| 更新種別        | 説明                                                 |
| ----------- | -------------------------------------------------- |
| 上書き(未入力含む)  | フォーム・アンケートで該当項目が未入力の場合はHubSpotの項目を空で上書きします         |
| 上書き(入力済みのみ) | フォーム・アンケートで該当項目が入力済みである場合のみHubSpotの項目を上書きします       |
| 上書きしない      | HubSpotに既に値がある項目は上書きしません。空の項目にはフォーム・アンケートの値を書き込みます |

カスタムマッピングのデフォルトの更新種別は「上書き(未入力含む)」です。固定マッピング項目（email、person\_name）の更新種別は常に「上書きしない」で固定されており、変更できません。カスタムマッピングでHubSpotのlastname・firstnameプロパティを選択した場合も、更新種別は「上書きしない」固定になります。

**更新種別と項目値の組み合わせ表**

凡例：○＝書き込む（上書き実行） / ー＝何もしない（HubSpot項目側の値を保持）

「immedio側＝値あり」とは、フォーム・アンケートで該当項目に入力があることを指します。

| immedio側 | HubSpot項目側 | 上書き(未入力含む)        | 上書き(入力済みのみ)           | 上書きしない                |
| -------- | ---------- | ----------------- | --------------------- | --------------------- |
| 値あり      | 値あり        | ○ immedio側の値で上書き  | ○ immedio側の値で上書き      | ー 保持（HubSpot項目側の値を維持） |
| 値あり      | 空          | ○ immedio側の値で書き込む | ○ immedio側の値で書き込む     | ○ immedio側の値で書き込む     |
| 空        | 値あり        | ○ 空で上書き           | ー 保持（immedio側の値が空のため） | ー 保持（HubSpot項目側の値を維持） |
| 空        | 空          | ー 変化なし            | ー 何もしない               | ー 何もしない               |

**更新対象の範囲について**

更新種別の判定は、そのフォーム送信またはアンケート回答に含まれる項目のみを対象とします。マッピングが設定されていても、そのフォームやアンケートに該当の項目が含まれていない場合は、更新種別の設定にかかわらずHubSpot上のその項目は更新されません。

例：フォームで「従業員数」を回答した後、面談前アンケートに「従業員数」の項目がない場合、アンケート回答時にHubSpot上の「従業員数」は更新されません（更新種別が「上書き(未入力含む)」であっても同様です）。

#### immedioプロパティ

「マッピング・ルーター」→「プロパティ設定」で登録されているプロパティが選択肢として表示されます。固定マッピング対象のプロパティ（email、person\_name）は選択肢に含まれません。

詳細については、[プロパティ設定](/company-settings/mapping-router/property-settings.md)を参照してください。

#### HubSpotプロパティ

HubSpotに登録されているコンタクトプロパティのうち、値を設定可能なプロパティが選択肢として表示されます。固定マッピングで使用しているプロパティ（email）は選択肢から除外されます。

HubSpotプロパティの選択肢は「ラベル (内部名)」の形式で表示されます。HubSpot側でカスタムプロパティを追加した場合、選択肢に反映されます。

#### マッピングの重複制限

* 同じimmedioプロパティを複数のマッピングに設定することはできません。一度選択されたimmedioプロパティは、他の行の選択肢から除外されます
* 同じHubSpotプロパティを複数のimmedioプロパティに紐付けることはできません。一度選択されたHubSpotプロパティは、他の行の選択肢から除外されます

### コンタクトの作成/更新の動作仕様

* リード登録時（再CVを含む）またはアンケート回答時に、コンタクトの自動作成/更新が実行されます
* 同じメールアドレスのコンタクトがHubSpot上に既に存在する場合は、更新種別の設定に従って既存コンタクトを更新します
* 同じメールアドレスのコンタクトが存在しない場合は、新規作成します
* コンタクトの作成/更新が失敗しても、予約やimmedioのリード登録、各種アンケート回答自体は正常に完了します
* カスタムマッピングでHubSpotのlastname・firstnameに値が設定されている場合は、その値が優先されます。どちらも設定されていない場合は、person\_nameを最初の半角スペースで分割し、姓（lastname）と名（firstname）にそれぞれ登録します。半角スペースがない場合は、person\_name全体が姓（lastname）に登録されます
* コンタクト新規作成時は、メールアドレスのドメインでHubSpotの会社（Companies）を検索します（会社名での検索は行いません）。1件のみ一致した場合はコンタクトと会社を紐づけます。0件または2件以上の場合は紐づけを行いません

#### 作成/更新が実行されるタイミング

* リード登録時（再CVを含む）
* 各種アンケート回答時（面談前アンケート、離脱前アンケート、キャンセル前アンケート、ミーティングチェックイン）

### タイムラグについて <a href="#contact-write-timelag" id="contact-write-timelag"></a>

リード登録時のコンタクトの作成/更新は、フローチャートルーター経由（問い合わせフォームや資料請求フォームのCVを起点とするもの）の場合のみ7分のタイムラグがあります。\
これにより、問い合わせフォームや資料請求フォーム経由でHubSpot側のコンタクトが作成されるまでの時間を確保し、重複によるコンタクト作成の失敗を防ぎます。\
immedio経由で作成されたHubSpot上のコンタクトに対して、アンケート回答内容を反映することも可能です。

#### 仕様

* タイムラグ:
  * リード登録時の作成/更新: フローチャートルーター経由は7分（固定）、それ以外（Web接客、AI接客、日程調整URLなど）は即時
  * アンケート回答時の更新: 流入経路に関係なく7分（固定）
* 設定変更: 不可
* 適用タイミング:
  * リード登録時: フローチャートルーター経由の場合はリード登録から7分後、それ以外の経路ではリード登録の直後にコンタクトの作成/更新処理が実行されます
  * アンケート回答時（面談前・離脱前・キャンセル前アンケート）: 流入経路に関係なく、回答から7分後にコンタクトの更新処理が実行されます

#### 注意事項

* タイムラグは固定値のため、変更することはできません

### 権限

この設定はオーナーまたはマネージャー権限を持つユーザーのみが編集できます。それ以外のユーザーは設定内容の閲覧のみ可能です。

### 注意事項

* コンタクトの作成/更新連携を無効にしても、設定済みのマッピング内容は保持されます。再度有効にした際は、以前の設定状態で利用を再開できます
* マッピングを保存する際は、すべての行でimmedioプロパティとHubSpotプロパティの両方を選択してください。未入力の行があると保存できません
* マッピング先のHubSpotプロパティの型（テキスト、数値、日付など）と、immedioプロパティの値の型が合わない場合、コンタクトの作成/更新が失敗します（予約やimmedioのリード登録、アンケート回答には影響しません）。マッピングを設定する際は、HubSpotプロパティの型をよく確認してください。例えば以下の点にご注意ください：

  * 数値型のプロパティには、数値として解釈できる値を設定してください
  * 日付型のプロパティには、`2025-01-15`（YYYY-MM-DD）形式の日付を設定してください
  * 日時型のプロパティには、`2025-01-15T15:30`（ISO 8601）形式の日時を設定してください

  HubSpotプロパティの型は、HubSpotの設定画面から「プロパティー」→ 該当のプロパティを選択し、「フィールドタイプ」の欄で確認できます。

  HubSpotプロパティの型の種類については、[HubSpot公式ヘルプ: HubSpotのプロパティー](https://knowledge.hubspot.com/ja/crm-setup/manage-your-properties)を参照してください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.immedio.io/company-settings/integrations/hubspot.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.