HubSpot App ガイド

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

前提条件

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

App を追加する

1. OOMOL Console にサインインします。
2. Connectables を開くか、直接 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 にサインインします。
2. 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 ツール

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 にサインインします。
2. 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 認可トークンを削除または無効化します。
• 一部のログ、サポート記録、セキュリティ記録、請求関連記録は、プライバシーポリシー に記載のとおり保持される場合があります。

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
• サポートページ: https://oomol.com/ja/support/

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