> 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.

# HighLevel

HighLevel 也称为 GoHighLevel，其 API 使用 LeadConnector 名称。通过 [webhook 工具](/docs/zh/reception-ai/integrations/webhooks)，接待员可将每位来电者保存为 HighLevel 子账户中的联系人。如果来电者已是联系人，HighLevel 会更新现有记录，而不会创建重复记录。

## 设置

### 创建私有集成令牌

在 HighLevel 子账户中，打开 **设置** → **私有集成**，然后选择 **创建新集成**。为其命名，仅选择查看和编辑联系人的权限范围，然后创建。请立即复制令牌：HighLevel 只会显示一次。

如果设置中没有 **私有集成**，请让代理管理员授予访问权限。

### 查找位置 ID

在同一子账户中打开 **设置** → **业务资料**，然后复制 **位置 ID**。

### 创建 webhook 工具

在 Reception.ai 中，前往 **集成**，选择 **添加集成**，然后选择 **Webhook 工具**。

| 字段         | 值                                                                                                                                                                                                                                                   |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **名称**     | `save_highlevel_contact`                                                                                                                                                                                                                            |
| **说明**     | "知道来电者的姓名和电话号码后，将其作为联系人保存到我们的 CRM。每次新客户或回访客户来电时都使用此工具。"                                                                                                                                                                                             |
| **方法**     | POST                                                                                                                                                                                                                                                |
| **URL**    | `https://services.leadconnectorhq.com/contacts/upsert`                                                                                                                                                                                              |
| **请求标头**   | `Authorization`：`Bearer ` 后接令牌  `Version`：`2021-07-28`                                                                                                                                                                                              |
| **正文参数**   | `locationId`（字符串，必填）：「始终使用精确值 `LOCATION_ID`。」  `firstName`（字符串，必填）：「来电者的名字。」  `lastName`（字符串）：「来电者的姓氏，如有提供。」  `phone`（字符串，必填）：「来电者的国际格式电话号码，例如 +14155550123。」  `email`（字符串）：「来电者的邮箱地址，如有提供。」  `source`（字符串，必填）：「始终使用精确值 `Reception.ai phone call`。」 |
| **分配给智能体** | **接待员**                                                                                                                                                                                                                                             |

将 `LOCATION_ID` 替换为复制的 ID。选择 **启用**。

### 测试

通过提供姓名和电话号码的来电，[测试接待员](/docs/zh/reception-ai/receptionist/testing)。联系人会显示在 HighLevel 的 **联系人** 下。使用相同号码再次来电：HighLevel 会更新该联系人，而不是新增联系人。

> **Warning**
>
> 该令牌可读取和更改联系人。请勿将其放入共享文档；如果泄露，请在 HighLevel 中删除
> 私有集成。

HighLevel 会根据子账户的 **允许重复联系人** 设置，判断来电者是否已是联系人。如果该设置同时匹配邮箱和电话号码，将按设置中列出的顺序进行检查。

> **Tip**
>
> 如需在通话后执行更多操作，例如创建商机或提醒团队，请创建一个以 **入站 Webhook** 触发器
> 开始的 HighLevel workflow。将第二个 webhook 工具指向该 workflow 的 URL，并附上所需字段，然后在 workflow 中映射这些字段。请将
> workflow URL 视为机密。HighLevel 将入站 Webhook 列为高级触发器，因此请查看套餐
> 是否有使用费用。

## 限制

* HighLevel 的 MCP 服务器需要通过 OAuth 登录，Reception.ai 不支持，因此请使用 webhook 工具。
* 标签和自定义字段在 HighLevel 的 API 中属于列表，而 webhook 工具发送的是扁平值。请改用 workflow 设置它们。
* 添加备注或任务时，URL 中需要联系人的 ID，webhook 工具无法在通话期间填入。请为此使用 **入站 Webhook** workflow。

## 故障排除

| 问题               | 检查项                                                                  |
| ---------------- | -------------------------------------------------------------------- |
| HighLevel 返回 401 | `Authorization` 标头必须为 `Bearer ` 后接令牌，且 `Bearer` 后需有一个空格。             |
| HighLevel 返回 403 | 令牌需要联系人权限范围，且 `locationId` 必须是创建该令牌的子账户。                             |
| HighLevel 拒绝版本号  | `Version` 标头必须严格为 `2021-07-28`。如果 HighLevel 的 API 文档列出了更新的必填值，请使用该值。 |
| 回访来电者出现重复记录      | 检查 **允许重复联系人** 设置，并确保电话号码以相同的国际格式保存。                                 |
| 联系人没有姓名          | 在工具说明中告诉接待员，保存前先询问来电者姓名。                                             |