> 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/immedio-box/integrations/hubspot.md).

# HubSpot連携設定

HubSpot連携を設定する画面です。

immedio BoxとHubSpotを連携することで、以下のことができます。

* 資料・動画の閲覧をトリガーにHubSpot上のタスクを自動作成する
* 通知の送付先をHubSpotのコンタクト・会社の担当者にする
* 通知に含めるHubSpotのコンタクト項目をカスタマイズする
* 資料・動画の閲覧をHubSpotにページビューとして記録する

「外部連携」ページの「HubSpot連携」セクションで設定します。

## HubSpotと連携

「連携する」をクリックするとHubSpotの認証画面に遷移します。連携するHubSpotアカウントを選択してログインすると連携が完了します。

連携が完了すると、ファイル開封時などの通知にHubSpot上の以下の情報が含まれるようになります。

* 会社名
* 氏名
* 電話番号
* レコード担当者
* レコードURL

## ページ到達時やファイル離脱時にタスクを作成する

資料と動画、それぞれ以下のトリガーでHubSpot上のタスク作成が設定できます。

* 資料：ページ到達、ページ滞在、コンテンツ離脱
* 動画：コンテンツ離脱

ワークフロー設定画面でアクションとして「HubSpot ToDoを作成する」を選択し、トリガーと所有者を設定します。

タスクの所有者は以下の2つから選択できます。

| 選択肢              | 説明                            |
| ---------------- | ----------------------------- |
| 資料の作成者           | immedio Box上の資料オーナーをタスク所有者にする |
| HubSpotコンタクトの所有者 | HubSpot上のコンタクト所有者をタスク所有者にする   |

URLにオーナー指定のパラメーターが含まれている場合は、そこで指名されたオーナーが優先されます。

### タスクに含まれる情報

HubSpotに作成されるタスクには以下の情報が含まれます。

| 項目  | 内容                              |
| --- | ------------------------------- |
| 件名  | リードのアクション内容（例：「○○さんが資料名を閉じました」） |
| 説明  | 資料名、メールアドレス、ページ情報、滞在時間、閲覧履歴URL  |
| 期限日 | タスク作成日                          |
| 担当者 | 資料の作成者またはHubSpotコンタクトの所有者       |

## 通知の送付先をHubSpotのコンタクト・会社の担当者にする

各種通知はデフォルトでimmedio Box上の資料のオーナーに届きますが、通知の宛先をHubSpotのコンタクト・会社の担当者に設定できます。

### テナント全体のデフォルトとして設定する

「テナント管理」ページから「デフォルトの通知先」に遷移し、HubSpotのコンタクト担当者または会社担当者を選択します。

### ファイル単位で設定する

ワークフロー編集時に通知先ユーザーの選択肢からHubSpotのコンタクト・会社担当者を選択します。デフォルト設定をしている場合、追加で設定する必要はありません。

## 通知に含めるHubSpotの項目をカスタマイズする

「外部連携」ページの「HubSpot連携」セクションで「HubSpot通知項目設定」を「使用する」に変更すると、メール・Slack通知に含めるHubSpotのコンタクト項目を指定できます。

デフォルトでは、閲覧者のメールアドレスがHubSpot上に存在した場合、コンタクトの社名・氏名・電話番号・所有者・レコードURLが通知に含まれます。通知項目を変更したい場合にこの設定を使います。

「コンタクトのプロパティを取得する」を押すとHubSpotからプロパティ一覧を取得でき、通知に含めたい項目を選択して保存します。

## HubSpotのトラッキングコードを追加する

immedio BoxにHubSpotのトラッキングコードを追加することで、資料の閲覧時にページビューをHubSpotに記録できます。

### 設定手順

1. HubSpotで「設定」＞「アカウント管理」＞「トラッキングコード」＞「高度なトラッキング」に遷移し、immedio Boxで使用するドメイン（`box.immedio.io` またはカスタムドメイン）を追加します
2. 「外部連携」ページの「HubSpot連携」セクションで「HubSpotトラッキングコードを有効にする」にチェックを入れて保存します

有効にすると、以下の行為がHubSpot側に連携されます。

* メールアドレス取得フォームの送信
* ファイルの閲覧

### フォーム名の設定

immedio Boxのフォームは、HubSpot上では「HubSpot以外のフォーム」として登録されるため、HubSpotからの通知メールで「Unidentified Form」と表示される場合があります。フォーム名を変更するにはHubSpotの管理画面で以下の手順を実行します。

1. HubSpotの管理画面で「マーケティング」＞「フォーム」に移動します
2. 対象のフォームを見つけて「アクション」から「名前を変更」を選択します
3. 新しいフォーム名を入力して保存します

### 注意事項

トラッキングコードが有効な状態でフォームから新規メールアドレスが送信されると、HubSpot上でマーケティングコンタクトとして登録されます。必ず[プライバシーポリシー](/immedio-box/setup/policies.md)を設定した上でご利用ください。


---

# 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/immedio-box/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.