HubSpot 应用指南

最后更新于 2026 年 6 月 10 日

OOMOL 支持你连接一次 HubSpot，然后把经过授权的 HubSpot CRM 工具提供给你已经在使用的 AI Agent 和可复用 Skills。本文说明如何添加 HubSpot 应用、OOMOL 会使用哪些权限、可以用它完成什么、常见问题如何排查，以及如何移除应用。

前置条件

• 一个 OOMOL 账号。
• 一个允许授权第三方应用的 HubSpot 账号。
• 可以访问 OOMOL Console。
• 在 HubSpot 中拥有授权 CRM object 和 CRM schema scopes 的权限。
• 如果你要测试搜索、读取或更新工具，需要准备测试联系人、公司和交易记录。
• 如果你的 HubSpot 组织限制第三方应用，可能需要 HubSpot 管理员先允许 OOMOL 应用。

添加应用

1. 登录 OOMOL Console。
2. 打开 连接服务，或直接访问 Connections。
3. 搜索 HubSpot。
4. 选择 HubSpot，然后点击 Connect。
5. OOMOL 会跳转到 HubSpot。如有提示，请登录 HubSpot。
6. 检查 HubSpot 授权页面，包括请求的 CRM 权限。
7. 选择你要连接的 HubSpot 账号。
8. 点击 Connect app，或 HubSpot 页面中显示的等效授权操作。
9. HubSpot 跳回 OOMOL 后，确认 HubSpot 已显示为已连接。

如果任一步骤失败，请查看常见问题排查。

授权后，OOMOL 会保存调用 HubSpot 工具所需的连接信息。之后，你就可以在 OOMOL 支持的 Agent、可复用 Skills 和工作流中使用 HubSpot 工具。

使用方式

HubSpot 工具需要先连接 HubSpot 账号后才能使用。OOMOL 中展示的具体工具列表可能随 connector 更新而变化；当前 HubSpot connector 支持读取 CRM 属性定义，以及搜索、读取、创建、更新 contacts、companies 和 deals。

通过 oo-cli 使用 HubSpot 工具

如果你要在支持的 AI Agent 环境中使用已连接的 HubSpot 工具，请在登录 OOMOL 后安装并配置 oo-cli。

1. 登录 OOMOL Console。
2. 打开 oo-cli 安装页面。
3. 按照页面中的说明操作。该页面会提供一键复制的提示词，用于在支持的 AI Agent 环境中安装并配置 oo-cli。
4. 完成 oo-cli 配置，并在 OOMOL 中连接 HubSpot 后，就可以让 Agent 使用已连接的 HubSpot CRM 工具处理 demo CRM data。

具体 prompt 可以根据 Agent 环境调整。例如，你可以让 Agent 创建 demo contact、按 email 搜索该 contact、更新 job title 等可编辑字段，或列出 HubSpot CRM properties。

使用的权限

OOMOL 使用这些 HubSpot scopes，让已授权的 HubSpot 用户可以把 HubSpot 作为一个 App 连接到 OOMOL，然后把经过授权的 CRM 工具提供给 Agent 和可复用 Skills。

Required scopes：

支持的 HubSpot 工具

搜索和读取 CRM 记录

使用场景：让 Agent 在客户电话、交接、研究任务或后续跟进前，找到正确的 HubSpot contact、company 或 deal。

前置条件：

• 已在 OOMOL 中连接 HubSpot。
• 已连接的 HubSpot 账号有权限读取请求的 CRM object。
• Agent 或工作流已经获得搜索关键词、筛选条件、record ID 或唯一属性值。

工具行为：

• 搜索或读取已连接 HubSpot 账号可访问的 contacts、companies 和 deals。
• 在可用时返回工具输入请求的 HubSpot 字段。
• 只读操作不会创建、更新或删除记录。

创建 CRM 记录

使用场景：让 Agent 根据用户提供的信息创建 HubSpot contact、company 或 deal，例如新的客户、账号或机会。

前置条件：

• 已在 OOMOL 中连接 HubSpot。
• 已连接的 HubSpot 账号有权限创建请求的 CRM object。
• Agent 或工作流已经获得新记录所需的属性。
• 如果包含关联关系，关联记录必须有效，并且对已连接账号可用。

工具行为：

• 根据输入创建 HubSpot contact、company 或 deal。
• 返回 HubSpot 提供的记录信息，例如 record ID 和选定属性。
• 不会凭空编造缺失的 CRM 值。必填值必须由用户、工作流或已连接数据源提供。

更新 CRM 记录

使用场景：当用户要求修改某个 contact、company 或 deal 字段时，让 Agent 保持 HubSpot 记录最新。

前置条件：

• 已在 OOMOL 中连接 HubSpot。
• 已连接的 HubSpot 账号有权限更新请求的 CRM object。
• Agent 或工作流可以通过 HubSpot record ID 或自定义唯一属性定位目标记录。
• 更新后的值符合 HubSpot 属性定义。

工具行为：

• 根据输入更新支持的 HubSpot contact、company 或 deal 属性。
• 返回 HubSpot 提供的更新结果。
• 不会删除记录。

测试应用

你可以使用任意允许授权第三方应用的 HubSpot 账号测试 HubSpot 应用。建议使用 demo contacts、companies 和 deals，这样可以安全测试搜索、创建和更新动作。

示例测试 prompts

• Create a HubSpot contact named Demo Contact with email demo-contact@example.com.
• Search HubSpot contacts for demo-contact@example.com.
• Get the HubSpot contact with email demo-contact@example.com.
• Update the HubSpot contact with email demo-contact@example.com and set the job title to Demo Buyer.
• Search HubSpot companies for Demo Company.
• Create a HubSpot company named Demo Company.
• Search HubSpot deals for Demo Deal.
• Create a HubSpot deal named Demo Deal with sample test values.
• Update the Demo Deal amount or close date.
• List HubSpot contact properties.
• Get the HubSpot contact property definition for email.

测试时请只使用 demo data，不要在测试 prompt 中使用真实客户数据。

常见问题排查

无法添加 HubSpot 应用

• 确认你登录的是正确的 OOMOL 账号。
• 确认你正在登录想要连接的 HubSpot 账号。
• 确认 HubSpot 账号允许请求的 CRM scopes。
• 如果 HubSpot 账号属于某个组织，请询问 HubSpot 管理员：第三方应用是否需要审批。
• 如果 OOMOL 中已有失败或不完整的 HubSpot 连接，先断开它，再重新连接。
• 如果问题仍然存在，请联系 OOMOL 支持，并附上 OOMOL 账号邮箱、HubSpot 账号或 portal ID、尝试连接的时间、错误信息或截图。

HubSpot 工具找不到记录

• 确认已连接的 HubSpot 账号有权限访问请求的 contact、company 或 deal。
• 确认工作流使用了正确的 record ID、唯一属性、搜索关键词或筛选条件。
• 检查该记录是否存在于已连接到 OOMOL 的 HubSpot 账号中。
• 如果你最近调整过 HubSpot 权限，请在 OOMOL 中重新连接 HubSpot，以刷新授权状态。

HubSpot 工具无法创建记录

• 确认已连接的 HubSpot 账号可以直接在 HubSpot 中创建请求的 contact、company 或 deal。
• 检查是否包含所有 HubSpot 必填属性。
• 检查提供的值是否符合 HubSpot 属性定义。
• 如果包含关联关系，确认关联记录和 association types 有效。

HubSpot 工具无法更新记录

• 确认已连接的 HubSpot 账号有权限更新请求的记录。
• 确认工作流使用了正确的 HubSpot record ID 或自定义唯一属性。
• 检查更新字段和值是否符合 HubSpot 要求。
• 如果某个属性在 HubSpot 中是只读或受限属性，请从更新请求中移除它，或直接在 HubSpot 中更新。

移除应用

你可以从 OOMOL 或 HubSpot 任一侧移除 HubSpot 应用。如果你不再希望 OOMOL 访问 HubSpot，建议两边都移除。

从 OOMOL 移除 HubSpot

1. 登录 OOMOL Console。
2. 打开 Connections。
3. 在已连接应用中找到 HubSpot。
4. 打开 HubSpot 连接详情。
5. 选择 Disconnect、Remove，或 OOMOL 界面中显示的等效移除操作。
6. 确认移除。

从 HubSpot 移除 OOMOL

1. 登录 HubSpot。
2. 打开 Settings。
3. 打开 Integrations，然后进入 Connected Apps。
4. 找到 OOMOL。
5. 选择 uninstall、disconnect 或 remove app 的操作。
6. 确认移除。

移除后的影响

• 移除或取消授权 HubSpot 连接后，OOMOL 将无法再为你的账号使用 HubSpot 工具。
• 依赖 HubSpot 的工作流、Agent 或 Skills 可能会失败，直到你重新连接 HubSpot。
• 移除前已创建或更新的 HubSpot 记录会保留在 HubSpot 中，除非你在 HubSpot 中修改或删除这些记录。
• 移除应用不会删除你的 OOMOL 账号。

数据处理

OOMOL 只会在 HubSpot 用户授权应用，并且用户或已批准的 Agent 动作需要使用 HubSpot 时访问 HubSpot 数据。OOMOL 只会为了提供通过 OOMOL 支持的 Agent、可复用 Skills 和工作流请求的 HubSpot 工具而使用 HubSpot 数据。

• HubSpot OAuth tokens 会被加密存储。
• HubSpot OAuth tokens 不会暴露给 AI Agents、prompts、项目文件或最终用户。
• 当 HubSpot 工具被调用时，OOMOL 可能会处理 HubSpot contacts、companies、deals 和 CRM property metadata。
• HubSpot 数据只会在必要时存储在用户可见的工具结果、使用记录、执行历史或运营记录中。
• 存储的数据会静态加密，并通过 TLS/SSL 传输。
• OOMOL 不会出售你的 HubSpot 数据。
• OOMOL 不会将 HubSpot 数据用于广告。
• OOMOL 不会使用客户私有内容训练 AI 模型。
• 当你移除或取消授权 HubSpot 应用后，OOMOL 会停止使用已撤销的 HubSpot 授权，并按照正常连接移除流程删除或失效化已保存的 HubSpot 授权 token。
• 某些日志、支持记录、安全记录或账单相关记录可能会按照隐私政策中的说明保留。

FAQ

OOMOL 会持续同步 HubSpot 数据吗？

不会。OOMOL 不会在后台持续同步或复制 HubSpot 数据。只有当已授权用户或已批准的 Agent 动作调用 HubSpot 工具时，OOMOL 才会访问 HubSpot 数据。

连接后 Agent 会自动使用 HubSpot 吗？

连接 HubSpot 会让 HubSpot 工具在 OOMOL 中可用，但是否调用工具仍取决于你选择的 Agent、工作流、Skill 和权限。基于账号的服务仍然需要你的授权。

OOMOL 可以删除 HubSpot 记录吗？

本文描述的当前 HubSpot connector 支持搜索、读取、创建和更新 contacts、companies 和 deals，不包含删除记录的工具。

可以连接多个 HubSpot 账号吗？

请在 OOMOL Console 中查看你的账号或 workspace 当前支持的连接选项。如果你需要处理多个 HubSpot 账号，可以联系支持团队。

是否需要付费 HubSpot 账号？

大多数 OOMOL HubSpot 工具需要一个可以授权请求的 CRM scopes 的 HubSpot 账号。部分 HubSpot 功能、对象访问、属性访问或管理员控制可能取决于你的 HubSpot 套餐或组织设置。

联系支持

如果你在添加、使用、测试或移除 HubSpot 应用时需要帮助，请联系 OOMOL 支持：

• 邮箱：support@oomol.com
• 支持页面：https://oomol.com/zh-cn/support/

请附上你的 OOMOL 账号邮箱、相关 HubSpot 账号或 portal ID、你正在执行的操作，以及错误信息或截图。