在 Coexistence 号码上将 WhatsApp 连接到 GoHighLevel 联系人

WhatsApp 消息如何到达 HighLevel 联系人？

Meta 会把号码上的每条消息发送到您设置的 Webhook 目标，这里是 n8n 的 Webhook 节点。工作流将发送者的号码和 WhatsApp 个人资料名称交给 n8n 的 HighLevel 节点，其联系人资源提供创建或更新操作，因此新发送者会成为联系人，已有的发送者则会被找到而不是重复创建。

拿到联系人 id 后，由 HTTP Request 节点把消息正文发送到 /contacts/{contactId}/notes。备注会出现在联系人记录上，任何人打开记录都能看到客户写了什么。当消息需要跟进时，HighLevel 节点还可以直接在联系人上创建任务，或在销售管道中创建商机，这两项它都原生支持。

团队全程仍可继续在 WhatsApp Business 应用中回复。

工作流应该使用哪种令牌？

使用 Private Integration 令牌。HighLevel 的 API v2 可通过 OAuth 或这类令牌访问，而旧的 v1 API 密钥已终止支持。Private Integration 令牌在子账户的设置中创建，权限范围取决于您勾选的项目，并像任何访问令牌一样放在 Authorization 标头中发送。

它不会自动刷新，这很适合自动化：在有人轮换之前，它会一直有效。当您轮换时，HighLevel 会让新旧令牌同时有效 7 天，您可以在这段时间内把新令牌粘贴到 n8n，之后旧令牌才会失效。

只勾选工作流需要的权限范围：联系人、备注，以及（如果用到）商机和任务。如果在设置中找不到 Private Integrations，HighLevel 说明需要先在 Labs 中启用。

一个工作流如何服务多个客户子账户？

按接收号码进行路由。Meta 发送的每个 Webhook 都包含接收消息的商业号码的 phone_number_id。让所有客户的号码都指向同一个 n8n Webhook，维护一张小表，把每个 phone_number_id 对应到该客户的子账户及其令牌，并在每次运行开始时查出令牌。

这样所有客户只需维护一个工作流，对代理机构而言尤其重要。匹配逻辑或备注格式的一次修复，会同时对所有人生效。

速率限制按每个应用在每个子账户内计算，所以客户之间不会占用彼此的额度：每个子账户各有每 10 秒 100 个请求和每天 200,000 个请求的额度。

在手机上输入的回复会同步到 HighLevel 吗？

可以。在 Coexistence 号码上，WhatsApp Business 应用仍可继续使用，当有人从应用中回复时，Meta 会把这条发出消息的回显发送到同一个 Webhook 目标，字段为 smb_message_echoes。

为这些回显添加一个分支，并将它们写为标记为已发送的备注。这样联系人记录就按顺序保存了客户的消息和商家的回复，这正是客户打开 CRM 时期望看到的内容。

当工作流本身通过 Cloud API 发送消息时，例如预约成功后发送已获批准的消息模板，请在发送的同时写入备注。工作流已经掌握文本和联系人 id。

常见错误

• 使用 v1 API 密钥。HighLevel 的 v1 API 已终止支持，API v2 需要 Private Integration 令牌或 OAuth。
• 在 7 天重叠期内没有更新 n8n 就轮换了 Private Integration 令牌。旧令牌失效后，所有调用都会失败。
• 用某一个子账户的令牌写入所有客户的消息。请先把 phone_number_id 映射到正确的子账户，否则记录会落到错误的客户名下。

常见问题

继续阅读