翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# HubSpot 統合
<a name="hubspot-integration"></a>

自然言語を使用して Amazon Quick から直接 HubSpot CRM データにアクセスします。HubSpot アクションコネクタを使用すると、Amazon Quick を離れることなく、連絡先、会社、取引、チケットを取得して一覧表示できます。

HubSpot は Amazon Quick の組み込みコネクタとして使用できます。この統合を設定するには、次の 2 つのステップを実行します。まず、必要なアクセス権を持つ HubSpot アカウントを準備します。次に、Amazon Quick でコネクタを作成し、HubSpot 認証情報を使用して認証します。

このコネクタは、カスタム OAuth アプリ認証をサポートしています。Amazon Quick がサポートする認証方法の詳細については、「」を参照してください[認証方法](quick-action-auth.md)。

## 前提条件
<a name="hubspot-integration-prerequisites"></a>

統合を設定する前に、次のリソースとアクセス権があることを確認してください。
+ 管理者ロールを持つアクティブな HubSpot アカウント。
+ HubSpot アカウントの連絡先、会社、取引、チケットを含む CRM データにアクセスするためのアクセス許可。
+ で説明されている要件を満たすサブスクリプション[コンソールで統合を設定する](integration-console-setup-process.md)。

## HubSpot アカウントの検証
<a name="hubspot-account-setup"></a>

Amazon Quick を設定する前に、HubSpot アカウントが次の要件を満たしていることを確認します。
+ HubSpot アカウントがアクティブであり、[HubSpot ウェブサイトの HubSpot サインインページにサインイン](https://app.hubspot.com/login)できます。 HubSpot 
+ 連絡先、会社、取引、チケットなど、アクセスする CRM データには、アカウントからアクセスできます。

## HubSpot アカウントの設定
<a name="hubspot-configure-account"></a>

Amazon Quick のカスタム OAuth アプリ認証方法には、HubSpot 開発者設定で設定された MCP 認証アプリが必要です。

### MCP 認証アプリを設定するには
<a name="hubspot-configure-oauth"></a>

1. HubSpot アカウントにサインインします。

1. Development に移動し****、次に **MCP Auth Apps** に移動します。

1. **MCP 認証アプリの作成**を選択します。

1. **MCP 認証アプリの作成**ウィンドウで、次のフィールドに入力します。
   + **名前** – アプリの名前を入力します。
   + **説明** – 簡単な説明を入力します。
   + **リダイレクト URL** – と入力します`https://{{region}}.quicksight.aws.amazon.com/sn/oauthcallback`。{{region}} を などの AWS リージョンに置き換えます`us-east-1`。

1. **[作成]** を選択します。HubSpot はアプリを作成し、クライアント ID とクライアントシークレットを生成します。
**重要**  
クライアントシークレットとクライアント ID を記録します。

カスタム OAuth アプリ認証方法で Amazon Quick でアクションコネクタを設定すると、クライアント ID とクライアントシークレットがクライアント ID とクライアントシークレットとして機能します。

詳細については、[HubSpot ウェブサイトの「HubSpot MCP サーバー](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server)」を参照してください。 HubSpot 

## Amazon Quick での統合の設定
<a name="hubspot-integration-setup"></a>

HubSpot アカウントアクセスを確認したら、Amazon Quick でコネクタを作成します。

1. Amazon Quick コンソールで、**コネクタ**を選択します。

1. **チームの作成**タブを選択します。

1. 使用可能なオプションから **HubSpot** を選択します。

1. **HubSpot** ダイアログで、次のフィールドに入力します。
   + **名前** – HubSpot コネクタのわかりやすい名前。
   + **説明 (オプション)** – **説明を選択して追加**し、このコネクタの使用方法に関するメモを追加します。
   + **接続タイプ** – **パブリックネットワーク**を選択します。

1. **カスタム OAuth アプリ**認証方法では、次のフィールドに入力します。
   + **ベース URL** – このフィールドは として自動入力されます`https://mcp.hubspot.com`。
   + **クライアント ID** – HubSpot MCP 認証アプリからクライアント ID を入力します。
   + **クライアントシーク**レット – HubSpot MCP 認証アプリからクライアントシークレットを入力します。
   + **トークン URL** – このフィールドは として自動入力されます`https://api.hubapi.com/oauth/v1/token`。
   + **認可 URL** – このフィールドは として自動入力されます`https://app.hubspot.com/oauth/authorize`。
   + **リダイレクト URL** – このフィールドは として自動入力されます`https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback`。

1. Next を選択し****、HubSpot のアクションを確認してから、もう一度 **Next** を選択します。

1. コネクタにアクセスできるユーザーを指定します。
   + チームと共有するには、チーム名またはグループ E メールを入力します。
   + 非公開にするには、 フィールドを空白のままにします。
   + すべてのユーザーと共有するには、**組織内のすべてのユーザーを切り替えます**。

1. **[公開]** を選択します。

コネクタは、ステータスが **Connected** の **Available** パネルに表示されます。

## 使用可能なアクションの使用
<a name="hubspot-integration-actions"></a>

コネクタを設定したら、次の読み取り専用アクションを使用して HubSpot CRM データにアクセスできます。


**HubSpot で使用可能なアクション**  

| [アクション] | 説明 | 
| --- | --- | 
| CRM オブジェクトの取得 | 1 つのリクエストで同じオブジェクトタイプの複数の CRM オブジェクトを取得します。 | 
| プロパティの取得 | CRM オブジェクトのプロパティを取得します。 | 
| ユーザーの詳細を取得する | ユーザーの詳細を取得します。 | 
| CRM オブジェクトの検索 | CRM オブジェクト全体を検索します。 | 
| 検索所有者 | 所有者間で検索します。 | 
| 検索プロパティ | プロパティ間で検索します。 | 

**注記**  
このコネクタは読み取り専用アクションをサポートしています。使用できるアクションは、HubSpot アプリで設定されたスコープによって異なります。

## トラブルシューティング
<a name="hubspot-integration-troubleshooting"></a>

コネクタを編集、共有、または削除するには、「」を参照してください[既存の統合の管理](integration-workflows.md#managing-existing-integrations)。

### 認証の問題の解決
<a name="hubspot-troubleshooting-auth"></a>
+ **サインインが失敗**する – HubSpot アカウントがアクティブであり、[HubSpot ウェブサイトの HubSpot サインインページ](https://app.hubspot.com/login)にサインインできることを確認します。 HubSpot 組織がシングルサインオン (SSO) を使用している場合は、ID プロバイダーが正しく設定されていることを確認します。
+ **アクセス拒否** – HubSpot ユーザーに CRM データにアクセスする権限を持つ管理者ロールがあることを確認します。アプリのクライアント ID とクライアントシークレットが正しく、必要な読み取りスコープが設定されていることを確認します。