跳到导航
集成设置指南CRM

HighLevel

通过 webhook 工具将来电者保存为 HighLevel 联系人。

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

设置

1

创建私有集成令牌

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

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

2

查找位置 ID

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

3

创建 webhook 工具

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

字段值
名称save_highlevel_contact
说明”知道来电者的姓名和电话号码后，将其作为联系人保存到我们的 CRM。每次新客户或回访客户来电时都使用此工具。“
方法POST
URLhttps://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。选择 启用。

4

测试

通过提供姓名和电话号码的来电，测试接待员。联系人会显示在 HighLevel 的 联系人 下。使用相同号码再次来电：HighLevel 会更新该联系人，而不是新增联系人。

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

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

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