> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# HubSpot

## 概述

将 ElevenLabs AI 智能体连接到 [HubSpot](https://www.hubspot.com/) CRM，即可管理联系人、公司和交易。通过此集成，智能体可创建和更新 CRM 记录、搜索现有数据，并自动化销售和营销工作流程。

## 功能

| 功能         | 支持情况          |
| ---------- | ------------- |
| 零留存模式（ZRM） | 不支持           |
| 工具中的附件     | 不支持 — 工具仅处理文本 |

## 设置

此集成使用 **HubSpot 私有应用**令牌进行身份验证。

#### 在 HubSpot 中创建私有应用

前往 [HubSpot 账号](https://developers.hubspot.com/docs/api/private-apps)中的 **开发** > **旧版应用**，然后点击 **创建旧版应用** > **私有**。授予智能体所需的 CRM 作用域（例如 `crm.objects.contacts.read`、`crm.objects.contacts.write`）。

#### 复制访问令牌

创建应用后，复制生成的访问令牌。令牌以 `pat-` 开头。

#### 在 ElevenLabs 中连接

在 ElevenLabs 集成设置中，将私有应用令牌粘贴到 **私有应用访问令牌** 字段。

> **Note**
>
> 此集成目前仅支持托管在美国的 HubSpot 账号（`api.hubapi.com`）。托管在欧盟的
> 账号（令牌以 `pat-eu1-` 开头）暂不支持。

## 演示视频

> **Note**
>
> 此演示使用旧版 webhook 工具。如果你使用原生 HubSpot 集成，工具会
> 自动配置 — 无需手动设置 webhook。

## 工作原理

#### 客户识别

智能体会询问来电者的识别信息，例如电子邮箱地址，然后搜索 CRM 以确认是否存在相应记录。

#### 了解通话意图

智能体会询问来电者的通话目的。此步骤可根据具体工作流程调整。

#### 获取历史互动记录

智能体使用识别阶段获取的联系人 ID，从 CRM 获取历史互动记录。

#### 创建工单

智能体会与来电者讨论问题，将其与历史互动记录关联，并为后续事项创建工单。

## 实用链接

* [HubSpot API 文档](https://developers.hubspot.com/docs/api/overview)
* [私有应用指南](https://developers.hubspot.com/docs/api/private-apps)
* [CRM API 参考文档](https://developers.hubspot.com/docs/api/crm/understanding-the-crm)