View a markdown version of this page

HubSpot 整合 - Amazon Quick
先决条件验证您的 HubSpot 账户配置您的 HubSpot 账户在 Amazon Quick 中设置集成使用可用操作问题排查

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

HubSpot 整合

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

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

此连接器支持自定义 OAuth 应用程序身份验证。有关 Amazon Quick 支持的身份验证方法的信息，请参阅身份验证方法。

先决条件

在设置集成之前，请确认您拥有以下资源和访问权限。

  • 具有管理员角色的活跃 HubSpot 账户。

  • 访问 CRM 数据的权限，包括您 HubSpot 账户中的联系人、公司、交易和门票。

  • 符合中所述要求的订阅在控制台中设置集成。

验证您的 HubSpot 账户

在配置 Amazon Quick 之前，请确认您的 HubSpot 账户符合以下要求。

  • 您的 HubSpot 帐户已激活，您可以登录 HubSpot 网站上的HubSpot 登录页面。

  • 您的账户可以访问您要访问的 CRM 数据，包括联系人、公司、交易和门票。

配置您的 HubSpot 账户

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

配置 MCP 身份验证应用程序

  1. 登录您的 HubSpot 账户。

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

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

  4. 在创建 MCP 身份验证应用程序窗口中，填写以下字段：

    • 名称-输入应用程序的名称。

    • 描述-输入简短描述。

    • 重定向网址-输入https://region.quicksight.aws.amazon.com/sn/oauthcallback。例如region，用您 AWS 所在的地区替换us-east-1。

  5. 选择 “创建”。 HubSpot 创建应用程序并生成客户端 ID 和客户端密钥。

    重要

    记录客户机密钥和客户端 ID。

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

有关更多信息，请参阅 HubSpot 网站上的 HubSpot MCP 服务器。

在 Amazon Quick 中设置集成

验证 HubSpot 账户访问权限后，在 Amazon Quick 中创建连接器。

  1. 在 Amazon Quick 控制台中，选择连接器。

  2. 选择 “为你的团队创建” 选项卡。

  3. HubSpot从可用选项中进行选择。

  4. 在HubSpot对话框中，输入以下字段：

    • 名称- HubSpot 连接器的描述性名称。

    • 描述（可选）-选择 + 添加描述以添加有关如何使用此连接器的注释。

    • 连接类型-选择公共网络。

  5. 对于自定义 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

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

  7. 指定谁可以访问连接器：

    • 要与团队共享，请输入团队名称或群组电子邮件。

    • 要将其保密，请将该字段留空。

    • 要与所有用户共享，请切换组织中的所有人。

  8. 选择发布。

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

使用可用操作

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

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

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

问题排查

要编辑、共享或删除您的连接器，请参阅管理现有集成。

解决身份验证问题

  • Sign-in 失败 — 验证您的 HubSpot 帐户是否处于活动状态，并且可以登录 HubSpot 网站上的HubSpot 登录页面。如果您的组织使用单点登录 (SSO)，请确认您的身份提供商配置正确。

  • 访问被拒绝-确认您的 HubSpot 用户具有管理员角色，有权访问 CRM 数据。验证您的应用程序中的客户端 ID 和客户端密钥是否正确，并配置了所需的读取范围。