在使用 Coexistence 的号码上将 WhatsApp 连接到 Zoho CRM

WhatsApp 消息如何变成 Zoho CRM 记录？

Meta 会把该号码上的每条消息发送到您设置的 Webhook 目标，这里是 n8n 的 Webhook 节点。工作流从 JSON 负载中取出发送者的号码，并以该号码作为 phone 参数调用 Zoho 的搜索端点，先搜索 Leads，再搜索 Contacts。Zoho 会检查模块中的每个电话字段，因此无论匹配的是 Mobile 还是 Phone 都算命中，您不必猜测销售人员用了哪个字段。

如果没有返回结果，n8n 的 Zoho CRM 节点会用 WhatsApp 个人资料名称和号码创建一个 Lead。无论哪种情况，工作流此时都有了记录 id，并通过 POST /Notes 把消息写成该记录的备注。备注只需要 Note_Content 和一个指明模块与记录的 Parent_Id。

{
  "data": [
    {
      "Note_Title": "WhatsApp, inbound",
      "Note_Content": "do you have anything friday?",
      "Parent_Id": {
        "module": { "api_name": "Leads" },
        "id": "4876876000000624001"
      }
    }
  ]
}

n8n 凭据需要哪些 Zoho 权限？

需要对您搜索和写入的模块具有读取和创建权限，另外还需要 Notes 的创建权限。Zoho 将备注范围命名为 ZohoCRM.modules.notes.CREATE，并要求同时具备父模块的创建范围。因此，如果凭据能创建 Lead，却从未获得备注范围，最后一步就会因授权错误而失败。

n8n 的 Zoho CRM 节点涵盖 Leads、Contacts、Accounts、Deals 和若干销售单据，支持 create、upsert、get、get all、update 和 delete。Notes 不在其资源之列，所以备注要通过 HTTP Request 节点发送。n8n 允许该节点复用您已连接的 Zoho 凭据，因此只需管理一份 OAuth 授权，而不是两份。

请把 API 域名设置为您的 Zoho 数据中心。在 EU 区域创建的凭据应调用 zohoapis.eu，而不是 zohoapis.com。

Zoho CRM 能承受多少条消息？

Zoho 按滚动 24 小时的额度来计量 API，额度取决于版本和用户数量。Free 版为 5,000。Standard 为 50,000 加每位用户 250，Professional 为 50,000 加每位用户 500，Enterprise 为 50,000 加每位用户 1,000，各版本均设有上限。

每条入站消息需要一次搜索和一次备注写入，首次发信的人还要多一次 Lead 创建。对小型企业的号码来说，这完全在付费版本的额度之内。最先遇到的上限通常是并发数：Free 允许 5 个同时调用，Standard 允许 10 个，所以群发后的集中回复可能会排队。如果看到 Zoho 返回限额错误，请把 n8n 工作流设置为一次只处理一个执行。

从手机发出的回复会进入 Zoho CRM 吗？

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

请为工作流增加一个处理回显的分支，并将它们记为标题为外发的备注。这样，销售人员在 Zoho 中打开该 Lead 时，就能看到对话的双方内容，无需再把截图粘贴到 CRM 中。

工作流自己通过 Cloud API 发送的消息，例如交易阶段变更后发送的已批准模板，最好在发送时记录，因为工作流此时已经掌握文本和记录 id。

常见错误

• 只授予凭据 Lead 相关范围，却没有授予 ZohoCRM.modules.notes.CREATE。搜索和创建 Lead 都正常，但每条备注都会失败。
• 用位于其他 Zoho 数据中心的账户调用 zohoapis.com。请使用账户所在区域的 API 域名。
• 只搜索 Leads。已转化的客户属于 Contacts，每位来信的客户都会变成一个重复的新 Lead。

常见问题

继续阅读