本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

使用自然语言直接从 Amazon Quick 访问您的 HubSpot CRM 数据。使用 HubSpot 操作连接器，您无需离开 Amazon Quick 即可检索和列出联系人、公司、交易和票证。

HubSpot 可作为内置连接器在 Amazon Quick 中使用。要设置此集成，请完成以下两个步骤。首先，为您的 HubSpot账户准备好所需的访问权限。然后，在 Amazon Quick 中创建连接器并使用您的 HubSpot 凭证进行身份验证。

此连接器支持自定义 OAuth 应用程序身份验证。有关 Amazon Quick 支持的身份验证方法的信息，请参阅[身份验证方法](quick-action-auth.md)。

## 先决条件
<a name="hubspot-integration-prerequisites"></a>

在设置集成之前，请确认您拥有以下资源和访问权限。
+ 具有管理员角色的活跃 HubSpot 账户。
+ 访问 CRM 数据的权限，包括您 HubSpot 账户中的联系人、公司、交易和门票。
+ 符合中所述要求的订阅[在控制台中设置集成](integration-console-setup-process.md)。

## 验证您的 HubSpot 账户
<a name="hubspot-account-setup"></a>

在配置 Amazon Quick 之前，请确认您的 HubSpot 账户符合以下要求。
+ 您的 HubSpot 帐户已激活，您可以登录 HubSpot 网站上的[HubSpot 登录页面](https://app.hubspot.com/login)。
+ 您的账户可以访问您要访问的 CRM 数据，包括联系人、公司、交易和门票。

## 配置您的 HubSpot 账户
<a name="hubspot-configure-account"></a>

Amazon Quick 中的自定义 OAuth 应用程序身份验证方法需要在您的开发者设置中配置 MCP 身份验证应用程序。 HubSpot 

### 配置 MCP 身份验证应用程序
<a name="hubspot-configure-oauth"></a>

1. 登录您的 HubSpot 账户。

1. 导航到 “**开发**”，然后导航到 “**MCP 身份验证应用程序”。**

1. 选择**创建 MCP 身份验证应用程序。**

1. 在**创建 MCP 身份验证应用程序**窗口中，填写以下字段：
   + **名称**-输入应用程序的名称。
   + **描述**-输入简短描述。
   + **重定向网址**-输入`https://{{region}}.quicksight.aws.amazon.com/sn/oauthcallback`。例如{{region}}，用您 AWS 所在的地区替换`us-east-1`。

1. 选择 “**创建**”。 HubSpot 创建应用程序并生成客户端 ID 和客户端密钥。
**重要**  
记录客户机密钥和客户端 ID。

当您在 Amazon Quick 中使用自定义 OAuth 应用程序身份验证方法配置操作连接器时，客户端 ID 和客户端密钥将用作客户端 ID 和客户端密钥。

有关更多信息，请参阅 HubSpot 网站上的 [HubSpot MCP 服务器](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server)。

## 在 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 Auth 应用程序中的客户端密钥。
   + **令牌 URL** — 此字段自动填充为。`https://api.hubapi.com/oauth/v1/token`
   + **授权网址**-此字段自动填充为。`https://app.hubspot.com/oauth/authorize`
   + **重定向 URL** — 此字段自动填充为。`https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback`

1. 选择 “**下一步**”，查看其中的操作 HubSpot，然后再次选择 “**下一步**”。

1. 指定谁可以访问连接器：
   + 要与团队共享，请输入团队名称或群组电子邮件。
   + 要将其保密，请将该字段留空。
   + 要与所有用户共享，请切换**组织中的所有人**。

1. 选择**发布**。

连接器出现在 “**可用**” 面板中，状态为 “**已连接**”。

## 使用可用操作
<a name="hubspot-integration-actions"></a>

设置连接器后，您可以使用以下只读操作来访问您的 HubSpot CRM 数据。


**HubSpot 可用操作**  

| 处理建议 | 说明 | 
| --- | --- | 
| 获取 CRM 对象 | 在单个请求中获取多个相同对象类型的 CRM 对象。 | 
| 获取房产 | 获取 CRM 对象的属性。 | 
| 获取用户详细信息 | 获取用户详细信息。 | 
| 搜索 CRM 对象 | 在 CRM 对象之间进行搜索。 | 
| 搜索所有者 | 跨所有者搜索。 | 
| 搜索房产 | 跨属性搜索。 | 

**注意**  
此连接器支持只读操作。您可以使用的操作取决于您的 HubSpot 应用程序中配置的范围。

## 问题排查
<a name="hubspot-integration-troubleshooting"></a>

要编辑、共享或删除您的连接器，请参阅[管理现有集成](integration-workflows.md#managing-existing-integrations)。

### 解决身份验证问题
<a name="hubspot-troubleshooting-auth"></a>
+ **Sign-in 失败** — 验证您的 HubSpot 帐户是否处于活动状态，并且可以登录 HubSpot 网站上的[HubSpot 登录页面](https://app.hubspot.com/login)。如果您的组织使用单点登录 (SSO)，请确认您的身份提供商配置正确。
+ **访问被拒绝**-确认您的 HubSpot 用户具有管理员角色，有权访问 CRM 数据。验证您的应用程序中的客户端 ID 和客户端密钥是否正确，并配置了所需的读取范围。