> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lovi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot

> 在此部分，您可以配置与 HubSpot 的集成，这是我们的战略合作伙伴之一。 此集成允许您连接账户、同步数据、自动化流程并集中对话管理，从而改善客户关系和运营效率。

<img src="https://mintcdn.com/lovi/hh1x_3QJZ36AKerB/images/HubspotConfig.png?fit=max&auto=format&n=hh1x_3QJZ36AKerB&q=85&s=adb9ea01fc3624179b31f8965a0cf2de" alt="HubSpot 配置" width="1916" height="962" data-path="images/HubspotConfig.png" />

如果 HubSpot 是您销售运营的大脑，Lovi 就是嘴巴。这个集成将两个世界结合在一起。

此模块不仅仅是一个开/关开关。在这里，您配置数据如何从您的聊天流向您的 CRM，对话如何推送到 HubSpot，以及您的 HubSpot 联系人列表如何触发 WhatsApp 消息。

***

### 🔌 1. HubSpot 配置

顶部的开关用于启用或禁用整个 HubSpot 集成。一旦您使用 HubSpot 账户进行认证，您将看到多个控制数据同步方式的选项。

#### A. 同步聊天（联系人同步）🔄

* **它做什么？** 这是您的自动助手。每当用户在 Lovi 中与您的 AI Agent 对话时，系统会在 HubSpot 中查找该联系人。
* **如果不存在：** 自动创建该联系人。
* **如果已存在：** 用对话中的任何新信息更新联系人。
* **好处：** 告别手动数据录入。您的 CRM 与机器人捕获的每个潜在客户保持实时同步。

#### B. 仅创建工单 🎫

当聊天同步不可用时的替代方案（例如在较低等级的套餐中）。启用此选项时：

* 聊天关闭时会在 HubSpot 中创建一个**工单**，但前提是在对话过程中已捕获所有必填属性。
* 没有"外部模式"——工单基于 AI Agent 在 Lovi 内部收集的数据创建。
* **何时使用：** 如果您的套餐不包含完整的聊天同步功能，这是将对话结果推送到 HubSpot 的方式。

***

### 📝 2. 属性

属性定义了 AI Agent 在对话中必须收集的数据，以便在 HubSpot 中创建联系人或工单。属性分为两类：

#### 必填属性 ✅

这些是**必需的**。只有当**所有**必填属性都已被捕获时，才会在 HubSpot 中创建或更新联系人或工单。

* 示例：**邮箱**、**电话号码**。
* 使用下拉菜单添加或删除必填属性。

#### 可选属性 ➕

如果在对话中**出现**，这些属性将被捕获，但它们永远不会阻止联系人或工单的创建。

* 示例：**名字**、**姓氏**、**地址**。
* 使用下拉菜单添加或删除可选属性。

***

### 🤖 3. AI Agents

选择将与此 HubSpot 集成关联的 AI Agent。

* 使用下拉菜单选择一个或多个 Agent（例如 `LOVI.ai WhatsApp`）。
* 只有由所选 Agent 处理的对话才会触发在 HubSpot 中创建联系人、创建工单或数据同步。
* 当您有多个 Agent 且只希望其中某些将数据同步到 HubSpot 时，此功能非常有用。

***

### 💬 4. 在实时聊天中显示表单

启用此开关后，集成的表单将直接显示在实时聊天界面中，以便人工客服可以手动填写。

* 此选项**独立于**集成模式（同步聊天或仅创建工单）。
* **使用场景：** 如果人工客服接管了对话，他们可以在实时聊天面板中直接查看并填写必填/可选属性字段，确保在对话同步到 HubSpot 之前不会遗漏任何数据。

***

### 🔗 5. 连接状态

在配置部分的底部，您将看到连接详情：

* **"账户已连接"** — 确认集成已激活。✅
* **子域名：** 与集成关联的 HubSpot 子域名（例如 `lovi.ai`）。
* **用户：** 授权连接的 HubSpot 用户邮箱。

要断开集成，请点击 **Desconectar HubSpot**（断开 HubSpot）按钮。

***

### 📋 6. 列表集成设置

这是最强大的部分。在这里，您**将 HubSpot 联系人列表与 Lovi 的 WhatsApp 渠道连接**，以发送定向通知。

目标是告诉系统：*"当我们使用这个 HubSpot 联系人列表时，使用这个 WhatsApp 号码和这个 template 发送消息。"*

#### 添加新列表

1. 点击 **+ Add list** 打开新列表配置表单。
2. **HubSpot 列表：** 输入您已在 HubSpot 中创建的列表名称（例如 `Lista De Prueba`）。将出现匹配结果的下拉菜单。
3. 选择列表并点击 **Apply**。
4. 应用列表后，将出现一个专用配置块。在这里您为这些联系人定义规则：

   * **WhatsApp 电话号码（线路）：** 选择消息将从中发送的电话号码。
   * **WhatsApp template：** 定义用于联系此列表的预批准 template（例如 `hello_world`）。
   * **变量：** 如果 template 包含变量，请将它们映射到相应的联系人属性。

#### 管理现有列表

每个已配置的列表显示其详情（线路、template、变量），并提供三个操作：

* **完成：** 将列表配置标记为已完成。绿色标记确认配置已就绪。
* **编辑：** 修改列表的电话号码、template 或变量映射。
* **删除：** 完全移除列表配置。

> **注意：** 对列表配置的更改只有在点击页面底部的 **Save configuration** 后才会保存。

***

### 💾 7. 保存配置

配置完开关、属性、Agent 和列表后，点击 **Save configuration** 以应用所有更改。

***

### 🎯 这实际上用于什么？

通过完成此设置，您将解锁两个超能力：

1. **入站：** 与机器人对话的每个人都会自动保存在 HubSpot 中（通过 `Sync Chat`），或者在聊天关闭时创建工单（通过 `Only Create Ticket`），具体取决于您的套餐和偏好。
2. **出站：** 您为使用 Lovi 的 WhatsApp 基础设施向 HubSpot 列表发起活动或自动化奠定基础，确保每个细分群体从正确的号码收到正确的消息。

**您的 CRM 和您的 AI 现在是最好的朋友！🤝**