---
author: OOMOL
author_url: https://oomol.com/ja/about/
title: HubSpot App ガイド
description: OOMOL で HubSpot App を追加、使用、トラブルシュート、削除する方法。
lang: ja
canonical_url: https://oomol.com/ja/docs/hubspot/
markdown_url: https://oomol.com/ja/docs/hubspot.md
---

# HubSpot App ガイド

OOMOL では HubSpot を一度接続するだけで、認可済みの HubSpot CRM ツールを、すでに使っている AI エージェントや再利用可能な Skills から利用できます。このガイドでは、HubSpot App の追加方法、OOMOL が使用する権限、利用できる操作、よくある問題の解決方法、App の削除方法を説明します。

## 前提条件

- OOMOL アカウント。
- 第三者 App の認可が許可されている HubSpot アカウント。
- [https://console.oomol.com/](https://console.oomol.com/) の OOMOL Console へのアクセス。
- CRM オブジェクトと CRM スキーマの scopes を持つ App を認可する HubSpot 権限。
- 検索、読み取り、更新ツールを試す場合は、テスト用の contact、company、deal レコード。
- HubSpot 組織が第三者 App を制限している場合、認可する前に HubSpot 管理者が OOMOL App を許可する必要があります。

## App を追加する

1. [OOMOL Console](https://console.oomol.com/) にサインインします。
2. **Connectables** を開くか、直接 [Connections](https://console.oomol.com/connections) に移動します。
3. **HubSpot** を検索します。
4. **HubSpot** を選択し、**Connect** を選びます。
5. OOMOL が HubSpot にリダイレクトします。求められた場合は HubSpot にサインインします。
6. 要求された CRM 権限を含め、HubSpot の認可画面を確認します。
7. 接続する HubSpot アカウントを選択します。
8. **Connect app** または HubSpot が表示する同等の認可アクションを選択します。
9. HubSpot から OOMOL に戻った後、OOMOL の connections で HubSpot が接続済みとして表示されることを確認します。

いずれかの手順が失敗した場合は、[トラブルシューティング](#トラブルシューティング) を参照してください。

認可後、OOMOL は HubSpot ツールをお客様に代わって呼び出すために必要な接続を保存します。その後、OOMOL 対応エージェント、再利用可能な Skills、workflows から HubSpot ツールを使用できます。

## 使い方

HubSpot ツールは、HubSpot アカウントを接続した後にのみ利用できます。OOMOL に表示される正確なツール一覧はコネクタの更新により変わる場合がありますが、現在の HubSpot コネクタは CRM プロパティ定義の読み取りと、contacts、companies、deals の検索、読み取り、作成、更新をサポートしています。

### oo-cli で HubSpot ツールを使う

接続済み HubSpot ツールを対応 AI エージェント環境で利用できるようにするには、OOMOL にサインインした後で `oo-cli` をインストールして設定します。

1. [OOMOL Console](https://console.oomol.com/) にサインインします。
2. [oo-cli インストールページ](https://console.oomol.com/install-oo-cli) を開きます。
3. そのページの手順に従います。対応 AI エージェント環境に `oo-cli` をインストールして設定するためのワンクリックコピー用プロンプトが用意されています。
4. `oo-cli` の設定が完了し、HubSpot が OOMOL に接続されたら、デモ CRM データを使って接続済み HubSpot CRM ツールを使用するようエージェントに依頼します。

具体的なエージェントプロンプトは環境によって異なります。たとえば、デモ contact を作成し、その contact をメールアドレスで検索し、職種などの編集可能なフィールドを更新し、HubSpot CRM プロパティを一覧表示するよう依頼できます。

### 使用する権限

OOMOL は以下の HubSpot scopes を使用し、認可済みの HubSpot ユーザーが HubSpot を OOMOL の App として接続し、承認済み CRM ツールをエージェントと再利用可能な Skills で利用できるようにします。

必須 scopes:

| HubSpot scope | 使用するツール | OOMOL が使用する理由 |
| --- | --- | --- |
| `oauth` | HubSpot OAuth connection | HubSpot OAuth 認可フローを完了し、OOMOL 内で認可済み HubSpot 接続を維持するため。 |
| `crm.objects.contacts.read` | Search Contacts, Get Contact | ユーザーまたは承認済みエージェントアクションが contact 情報を求めたとき、HubSpot contact レコードを検索および読み取るため。 |
| `crm.objects.contacts.write` | Create Contact, Update Contact | ユーザーまたは承認済みエージェントアクションが必要な contact 詳細を提供したとき、HubSpot contact レコードを作成または更新するため。 |
| `crm.objects.companies.read` | Search Companies, Get Company | ユーザーまたは承認済みエージェントアクションが company 情報を求めたとき、HubSpot company レコードを検索および読み取るため。 |
| `crm.objects.companies.write` | Create Company, Update Company | ユーザーまたは承認済みエージェントアクションが必要な company 詳細を提供したとき、HubSpot company レコードを作成または更新するため。 |
| `crm.objects.deals.read` | Search Deals, Get Deal | ユーザーまたは承認済みエージェントアクションが deal 情報を求めたとき、HubSpot deal レコードを検索および読み取るため。 |
| `crm.objects.deals.write` | Create Deal, Update Deal | ユーザーまたは承認済みエージェントアクションが必要な deal 詳細を提供したとき、HubSpot deal レコードを作成または更新するため。 |
| `crm.schemas.contacts.read` | List Properties, Get Property | ツールが有効な HubSpot contact フィールドを使えるように、contact プロパティ定義を読み取るため。 |
| `crm.schemas.companies.read` | List Properties, Get Property | ツールが有効な HubSpot company フィールドを使えるように、company プロパティ定義を読み取るため。 |
| `crm.schemas.deals.read` | List Properties, Get Property | ツールが有効な HubSpot deal フィールドを使えるように、deal プロパティ定義を読み取るため。 |

### 対応 HubSpot ツール

| ツール | 対応機能 | 主な用途 | 前提条件 |
| --- | --- | --- | --- |
| List Properties | contacts、companies、deals のプロパティ定義を一覧表示します。 | フィルタ、レコード作成、フィールド更新の前に、利用可能な CRM フィールドをエージェントが理解するため。 | HubSpot が OOMOL に接続され、接続済みアカウントが CRM プロパティスキーマにアクセスできること。 |
| Get Property | contacts の `email` プロパティなど、1 つのプロパティ定義を読み取ります。 | 検索、作成、更新で使用する前に特定の CRM フィールドを確認するため。 | HubSpot が OOMOL に接続され、要求されたプロパティが存在すること。 |
| Search Contacts | キーワード、フィルタ、並び替え、返却フィールドを指定して contacts を検索します。 | 通話、引き継ぎ、サポートタスク、フォローアップの前に適切な人物を見つけるため。 | HubSpot が OOMOL に接続され、接続済みアカウントが contacts を読み取れること。 |
| Get Contact | HubSpot レコード ID またはカスタム一意プロパティで 1 つの contact を読み取ります。 | 次のステップの前に contact 詳細をエージェント workflow に取り込むため。 | HubSpot が OOMOL に接続され、要求された contact が接続済みアカウントから利用できること。 |
| Create Contact | 指定されたプロパティと任意の associations で contact を作成します。 | ユーザーがエージェントに提供した情報から新しい lead、customer、stakeholder を保存するため。 | HubSpot が OOMOL に接続され、ユーザーが必要な contact 詳細を持っていること。 |
| Update Contact | レコード ID またはカスタム一意プロパティで contact プロパティを更新します。 | 通話、メール、調査タスク、workflow ステップの後に contact レコードを最新に保つため。 | HubSpot が OOMOL に接続され、contact を特定でき、ユーザーが更新内容を承認していること。 |
| Search Companies | キーワード、フィルタ、並び替え、返却フィールドを指定して companies を検索します。 | 調査、アウトリーチ、フォローアップの準備前に account 情報を見つけるため。 | HubSpot が OOMOL に接続され、接続済みアカウントが companies を読み取れること。 |
| Get Company | HubSpot レコード ID またはカスタム一意プロパティで 1 つの company を読み取ります。 | メモ、計画、更新を作成する前に account 詳細をエージェント workflow に取り込むため。 | HubSpot が OOMOL に接続され、要求された company が接続済みアカウントから利用できること。 |
| Create Company | 指定されたプロパティと任意の associations で company を作成します。 | ユーザー提供の会社情報から新しい account を追加するため。 | HubSpot が OOMOL に接続され、ユーザーが必要な company 詳細を持っていること。 |
| Update Company | レコード ID またはカスタム一意プロパティで company プロパティを更新します。 | 調査、営業作業、運用レビューの後に account 詳細を最新に保つため。 | HubSpot が OOMOL に接続され、company を特定でき、ユーザーが更新内容を承認していること。 |
| Search Deals | キーワード、フィルタ、並び替え、返却フィールドを指定して deals を検索します。 | パイプラインレビュー、予測、フォローアップの前に適切な opportunity を見つけるため。 | HubSpot が OOMOL に接続され、接続済みアカウントが deals を読み取れること。 |
| Get Deal | HubSpot レコード ID またはカスタム一意プロパティで 1 つの deal を読み取ります。 | 要約または更新の前に opportunity 詳細をエージェント workflow に取り込むため。 | HubSpot が OOMOL に接続され、要求された deal が接続済みアカウントから利用できること。 |
| Create Deal | 指定されたプロパティと任意の associations で deal を作成します。 | ユーザー提供の営業情報から新しい opportunity を追加するため。 | HubSpot が OOMOL に接続され、ユーザーが必要な deal 詳細を持っていること。 |
| Update Deal | レコード ID またはカスタム一意プロパティで deal プロパティを更新します。 | 顧客対応や内部レビューの後に pipeline 詳細を最新に保つため。 | HubSpot が OOMOL に接続され、deal を特定でき、ユーザーが更新内容を承認していること。 |

### CRM レコードを検索して読む

用途: 通話、引き継ぎ、調査タスク、フォローアップの前に、エージェントが適切な HubSpot contact、company、deal を見つけられるようにします。

前提条件:

- HubSpot が OOMOL に接続されている。
- 接続済み HubSpot アカウントに、要求された CRM オブジェクトを読み取る権限がある。
- エージェントまたは workflow に検索キーワード、フィルタ、レコード ID、または一意プロパティ値がある。

ツールが行うこと:

- 接続済み HubSpot アカウントで利用可能な contacts、companies、deals を検索または読み取ります。
- 利用可能な場合、ツール入力で要求された HubSpot フィールドを返します。
- 読み取り専用アクション中にレコードを作成、更新、削除しません。

### CRM レコードを作成する

用途: 新しい customer、account、opportunity など、ユーザーが提供した情報から HubSpot contact、company、deal をエージェントが作成できるようにします。

前提条件:

- HubSpot が OOMOL に接続されている。
- 接続済み HubSpot アカウントに、要求された CRM オブジェクトを作成する権限がある。
- エージェントまたは workflow に新しいレコードの必須プロパティがある。
- associations を含める場合、関連レコードが有効で接続済みアカウントから利用できる。

ツールが行うこと:

- 提供された入力に基づいて HubSpot contact、company、deal を作成します。
- レコード ID や選択されたプロパティなど、HubSpot が利用可能にするレコード情報を返します。
- 不足している CRM 値を作りません。必須値はユーザー、workflow、または接続済みデータソースから提供される必要があります。

### CRM レコードを更新する

用途: ユーザーが contact、company、deal のフィールド変更を依頼したときに、エージェントが HubSpot レコードを最新に保てるようにします。

前提条件:

- HubSpot が OOMOL に接続されている。
- 接続済み HubSpot アカウントに、要求された CRM オブジェクトを更新する権限がある。
- エージェントまたは workflow が HubSpot レコード ID またはカスタム一意プロパティで対象レコードを特定できる。
- 更新値が HubSpot プロパティ定義に対して有効である。

ツールが行うこと:

- 提供された入力に基づいて、対応する HubSpot contact、company、deal プロパティを更新します。
- HubSpot が利用可能にする更新結果を返します。
- レコードを削除しません。

## App をテストする

認可が許可されている任意の HubSpot アカウントで HubSpot App をテストできます。検索、作成、更新アクションを安全に試すため、デモ contacts、companies、deals を使用してください。

### テストプロンプト例

- `Demo Contact` という名前で、メールアドレスが `demo-contact@example.com` の HubSpot contact を作成して。
- `demo-contact@example.com` で HubSpot contacts を検索して。
- メールアドレス `demo-contact@example.com` の HubSpot contact を取得して。
- メールアドレス `demo-contact@example.com` の HubSpot contact を更新し、job title を `Demo Buyer` に設定して。
- `Demo Company` で HubSpot companies を検索して。
- `Demo Company` という名前の HubSpot company を作成して。
- `Demo Deal` で HubSpot deals を検索して。
- テスト値を使って `Demo Deal` という名前の HubSpot deal を作成して。
- `Demo Deal` の金額または close date を更新して。
- HubSpot contact properties を一覧表示して。
- `email` の HubSpot contact property 定義を取得して。

テスト中はデモデータのみを使用してください。テストプロンプトに実際の顧客データを使用しないでください。

## トラブルシューティング

### HubSpot App を追加できない

- 正しい OOMOL アカウントにサインインしていることを確認します。
- 接続したい HubSpot アカウントにサインインしていることを確認します。
- HubSpot アカウントが要求された CRM scopes を許可していることを確認します。
- HubSpot アカウントが組織に属している場合、第三者 App に承認が必要かどうか HubSpot 管理者に確認します。
- OOMOL で失敗または途中状態の HubSpot 接続を切断し、もう一度接続してみます。
- 問題が続く場合は、OOMOL サポートに連絡し、OOMOL アカウントのメール、HubSpot アカウントまたは portal ID、試行時刻、エラーメッセージまたはスクリーンショットを含めてください。

### HubSpot ツールがレコードを見つけられない

- 接続済み HubSpot アカウントが、要求された contact、company、deal にアクセスできることを確認します。
- workflow が正しいレコード ID、一意プロパティ、検索キーワード、フィルタを使用していることを確認します。
- レコードが OOMOL に接続された HubSpot アカウントに存在するか確認します。
- HubSpot 権限を最近変更した場合は、認可状態を更新するために HubSpot を OOMOL で再接続します。

### HubSpot ツールがレコードを作成できない

- 接続済み HubSpot アカウントが、要求された contact、company、deal を HubSpot で直接作成できることを確認します。
- 必須の HubSpot プロパティがすべて含まれていることを確認します。
- 指定された値が HubSpot プロパティ定義に対して有効であることを確認します。
- associations が含まれている場合、関連レコードと association types が有効であることを確認します。

### HubSpot ツールがレコードを更新できない

- 接続済み HubSpot アカウントに、要求されたレコードを更新する権限があることを確認します。
- workflow が正しい HubSpot レコード ID またはカスタム一意プロパティを使用していることを確認します。
- 更新フィールドと値が HubSpot に対して有効であることを確認します。
- プロパティが HubSpot で読み取り専用または制限付きの場合、更新リクエストから削除するか、HubSpot で直接更新します。

## App を削除する

HubSpot App は OOMOL または HubSpot のどちらからでも削除できます。OOMOL に HubSpot へのアクセスを許可し続けたくない場合は、両方から削除することを推奨します。

### OOMOL から HubSpot を削除する

1. [OOMOL Console](https://console.oomol.com/) にサインインします。
2. [Connections](https://console.oomol.com/connections) を開きます。
3. 接続済み Apps から **HubSpot** を探します。
4. HubSpot 接続の詳細を開きます。
5. **Disconnect**、**Remove**、または OOMOL に表示される同等の削除アクションを選択します。
6. 削除を確認します。

### HubSpot から OOMOL を削除する

1. HubSpot にサインインします。
2. **Settings** を開きます。
3. **Integrations** を開き、次に **Connected Apps** を開きます。
4. **OOMOL** を探します。
5. App をアンインストール、切断、削除するアクションを選択します。
6. 削除を確認します。

## 削除後に起きること

- HubSpot 接続が削除または認可解除されると、OOMOL はそのアカウントで HubSpot ツールを使用できなくなります。
- HubSpot に依存する workflows、agents、Skills は、HubSpot を再接続するまで失敗する場合があります。
- 削除前に作成または更新された既存の HubSpot レコードは、HubSpot 内で変更または削除しない限り HubSpot に残ります。
- App を削除しても OOMOL アカウントは削除されません。

## データの取り扱い

OOMOL は、HubSpot ユーザーが App を認可し、ユーザーまたは承認済みエージェントアクションが HubSpot を必要とする場合にのみ HubSpot データへアクセスします。OOMOL は、OOMOL 対応エージェント、再利用可能な Skills、workflows を通じて要求された HubSpot ツールを提供する目的でのみ HubSpot データを使用します。

- HubSpot OAuth トークンは暗号化して保存されます。
- HubSpot OAuth トークンは AI エージェント、プロンプト、プロジェクトファイル、エンドユーザーに公開されません。
- HubSpot ツールが呼び出されたとき、OOMOL は HubSpot の contact、company、deal、CRM プロパティメタデータを処理する場合があります。
- HubSpot データは、ユーザーに表示されるツール結果、利用記録、実行履歴、運用記録に必要な範囲でのみ保存される場合があります。
- 保存データは保存時に暗号化され、TLS/SSL で送信されます。
- OOMOL は HubSpot データを販売しません。
- OOMOL は HubSpot データを広告に使用しません。
- OOMOL は非公開の顧客コンテンツを AI モデルのトレーニングに使用しません。
- HubSpot App を削除または認可解除すると、OOMOL は取り消された HubSpot 認可の使用を停止します。OOMOL は通常の接続削除プロセスに従って、保存された HubSpot 認可トークンを削除または無効化します。
- 一部のログ、サポート記録、セキュリティ記録、請求関連記録は、[プライバシーポリシー](/ja/privacy/) に記載のとおり保持される場合があります。

## FAQ

### OOMOL は HubSpot データを継続的に同期しますか？

いいえ。OOMOL は HubSpot データをバックグラウンドで継続的に同期または複製しません。HubSpot データは、認可済みユーザーまたは承認済みエージェントアクションが HubSpot ツールを呼び出したときにアクセスされます。

### 接続後、エージェントは HubSpot を自動的に使えますか？

HubSpot を接続すると OOMOL で HubSpot ツールが利用可能になりますが、ツールの利用は選択した agent、workflow、Skill、権限に依存します。アカウントベースのサービスでは引き続きお客様の認可が必要です。

### OOMOL は HubSpot レコードを削除できますか？

このガイドで説明している現在の HubSpot コネクタは、contacts、companies、deals の検索、読み取り、作成、更新をサポートしています。レコード削除ツールは含まれていません。

### 複数の HubSpot アカウントを接続できますか？

OOMOL Console で、お客様のアカウントまたは workspace で現在利用できる接続オプションを確認してください。複数の HubSpot アカウントについて支援が必要な場合は、サポートに連絡してください。

### 有料 HubSpot アカウントは必要ですか？

ほとんどの OOMOL HubSpot ツールでは、要求された CRM scopes を認可できる HubSpot アカウントが必要です。一部の HubSpot 機能、オブジェクトアクセス、プロパティアクセス、管理者制御は、HubSpot プランまたは組織設定に依存する場合があります。

## サポートに連絡する

HubSpot App の追加、使用、テスト、削除について支援が必要な場合は、OOMOL サポートに連絡してください。

- Email: [support@oomol.com](mailto:support@oomol.com)
- サポートページ: [https://oomol.com/ja/support/](https://oomol.com/ja/support/)

OOMOL アカウントのメール、関連する場合は接続済み HubSpot アカウントまたは portal ID、実行しようとしたアクション、エラーメッセージまたはスクリーンショットを含めてください。