摘要
想要在 Wati 中自动将收到的聊天分配给正确的销售负责人吗？本指南将向您展示如何检查用户是否已存在于 Zoho CRM 中，并将他们的聊天分配给正确的销售负责人（Lead Owner）。如果用户是新用户，您可以向他们发送欢迎消息。此设置有助于确保更快的响应速度和更好的客户体验。
注意：此功能需要 Wati 的 Pro 或 Business 计划。
说明
解决方案概览
您将在 Wati 中设置一个聊天机器人，当用户开始对话时，它会执行以下操作：
使用电话号码检查用户是否存在于 Zoho CRM 中。
如果用户存在：
从 Zoho 获取销售负责人。
在 Wati 中将聊天分配给该销售负责人。
如果用户不存在：
发送欢迎消息。
如果 Zoho API 令牌已过期：
刷新令牌并重试。
如何设置聊天机器人并分配对话
1. 默认聊天机器人设置
配置聊天机器人，以便在用户开始新对话时自动启动。
2. 检查存储的访问令牌
系统会检查联系人的自定义属性（Custom Attributes）中是否已保存（API 调用所需的）访问令牌。
如果令牌存在 → 在步骤 3（API 调用）中使用它。
如果没有 → 继续获取新令牌（后文有说明）。
3. 在 Zoho CRM 中搜索销售线索（Lead）
向 Zoho CRM 的“搜索记录（Search Records）”端点进行 API 调用。
传入用户的电话号码，以检查他们是否为现有的销售线索。
4. 处理 API 响应
状态码 | 含义 | 应采取的操作 |
200 (成功) | 销售线索存在，响应中包含销售负责人姓名。 | 使用“设置条件 (Set a Condition)” + “分配坐席 (Assign Agent)”将聊天路由给销售负责人。 |
204 (无内容) | 此电话号码没有对应的销售线索（新用户）。 | 将其视为新线索并继续执行默认聊天机器人流程。 |
401 (未授权) | 访问令牌已过期。 |
|
使用 刷新访问令牌端点 获取新令牌。
在自定义属性中更新新令牌。
使用新令牌重试步骤 3（API 调用）。
设置聊天机器人的步骤
1. 下载聊天机器人模板
下载即用型聊天机器人模板：Check Zoho Lead Owner and Assign Chat.json
此模板包含将 Wati 与 Zoho CRM 连接所需的流程。
2. 将模板导入 Wati
进入 Wati 账户中的 自动化 (Automation) > 聊天机器人 (Chatbots)。
点击 导入 JSON (Import JSON)。
上传下载的聊天机器人模板。
3. 更新您的 Zoho API 详细信息
在聊天机器人流程的第一个 webhook 节点中：
更新您的 Zoho API 端点 (Endpoint)。
添加您的 访问令牌 (Access Token)。
4. 生成 Zoho CRM 访问令牌（如需要）
如果您已有 Zoho CRM 的访问令牌，请跳至步骤 5。
生成新的访问令牌：
访问 Zoho API 控制台：api-console.zoho.com
创建一个 Self Client 以获取您的：
client_idclient_secretcode
使用以下命令生成您的访问令牌：
curl --location --request POST 'https://accounts.zoho.com/oauth/v2/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=authorization_code' \
--data-urlencode 'client_id=<Enter Client ID>' \
--data-urlencode 'client_secret=<Enter Client Secret>' \
--data-urlencode 'code=<Enter Code>'
您的令牌看起来会像这样：Zoho-oauthtoken 1000.xxxxxxxxxxx.xxxxxxxxxxxx
5. 将访问令牌添加到第二个 Webhook 节点
在第二个 webhook 节点中：
转到 自定义标头 (Customize Headers)。
在 Authorization 字段中添加您的 Zoho CRM 访问令牌。
6. 了解聊天机器人逻辑的工作原理
聊天机器人使用 Zoho 的 API 根据电话号码搜索用户。
情况 1：用户存在于 Zoho 中（状态码：200）
API 将返回销售负责人。
使用 设置条件 (Set a Condition) 节点检查销售负责人是否与 Wati 中的坐席名称匹配。
如果匹配，使用 分配坐席 (Assign Agent) 节点将聊天分配给该坐席。
情况 2：用户不存在于 Zoho 中（状态码：204）
将此用户视为新用户。
向他们发送欢迎消息。
情况 3：访问令牌已过期（状态码：401）
使用另一个 webhook 节点刷新令牌。
使用您的
client_id、client_secret和refresh_token进行 API 调用：
curl --location --request POST 'https://accounts.zoho.com/oauth/v2/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=refresh_token' \
--data-urlencode 'client_id=<Enter Client ID>' \
--data-urlencode 'client_secret=<Enter Client Secret>' \
--data-urlencode 'refresh_token=<Enter Refresh Token>'
将新令牌保存在 Wati 中的虚拟联系人中（例如
22222222）。聊天机器人将在后续运行中使用此令牌。
结论
此设置可帮助您：
自动将聊天分配给正确的销售负责人。
通过更快的响应提供更好的客户体验。
通过欢迎消息顺利处理新用户。
使您的 Zoho 令牌管理实现自动化。
常见问题 (FAQs)
常规
1. 此聊天机器人设置有什么作用？
聊天机器人使用用户的电话号码检查用户是否存在于 Zoho CRM 中。如果用户存在，它会获取销售负责人并将聊天分配给 Wati 中的相应坐席。如果用户不存在，则发送欢迎消息。如果 Zoho CRM 访问令牌已过期，它会刷新令牌并重试 API 调用。
2. 哪些 Wati 计划支持此功能？
此功能需要 Wati 的 Pro 或 Business 计划。
聊天机器人与 Zoho CRM 集成
3. 聊天机器人如何检查用户是否存在于 Zoho CRM 中？
聊天机器人向 Zoho CRM 的搜索记录 (Search Records)端点进行 API 调用，并使用用户的电话号码搜索现有的销售线索。
4. 当 Zoho CRM API 返回状态码 200 时会发生什么？
状态码 200 意味着销售线索存在，响应中包含销售负责人的姓名。聊天机器人使用设置条件 (Set a Condition)检查销售负责人是否与 Wati 中的坐席名称匹配。如果匹配，分配坐席 (Assign Agent)节点会将聊天分配给该坐席。
5. 当 Zoho CRM API 返回状态码 204 时会发生什么？
状态码 204 意味着该用户的电话号码没有对应的销售线索。聊天机器人将用户视为新线索，并继续执行默认的聊天机器人流程，包括发送欢迎消息。
6. 当 Zoho CRM API 返回状态码 401 时会发生什么？
状态码 401 意味着 Zoho CRM 访问令牌已过期。聊天机器人使用刷新访问令牌端点 (Refresh Access Token Endpoint)获取新令牌，更新自定义属性中的令牌，并使用新令牌重试 Zoho CRM API 调用。
访问令牌配置
7. 我如何为聊天机器人生成 Zoho CRM 访问令牌？
转到 api-console.zoho.com 处的 Zoho API 控制台，创建一个 Self Client 以获取 client_id、client_secret 和 code。然后使用 Zoho 的 OAuth 令牌端点（配合 grant_type=authorization_code、客户端 ID、客户端密码和代码）来生成访问令牌。
8. 我在哪里添加聊天机器人中的 Zoho CRM 访问令牌？
在第一个 webhook 节点中，更新 Zoho API 端点并添加访问令牌。在第二个 webhook 节点中，转到自定义标头 (Customize Headers)，并在 Authorization 字段中添加 Zoho CRM 访问令牌。
9. 聊天机器人如何刷新和存储过期的 Zoho CRM 访问令牌？
当 Zoho CRM API 返回状态码 401 时，聊天机器人会使用另一个 webhook 节点，通过 client_id、client_secret 和 refresh_token 刷新令牌。新令牌将保存在 Wati 中的虚拟联系人中（例如 22222222），并在后续聊天机器人运行中使用。