跳转到主要内容

如何修复 Wati - Zoho 集成问题

本周更新

摘要

在 Zoho CRM 中发送 WhatsApp 消息遇到问题?本指南可帮助您解决常见的 API 配置错误,包括错误的端点设置、令牌问题和脚本问题。按照以下步骤让您的集成顺利运行。

说明

常见问题及解决方案

1. API 端点或令牌不正确

症状:消息无法发送,并且出现身份验证错误。

如何修复

  • 在 Zoho CRM 中,转到 设置市场已安装的应用Wati 插件

  • 更新以下字段:

    • API 端点 URL:从 Wati 帐户的 API 文档 部分获取

    • Bearer 令牌:从 Wati 的 API 设置 中复制

  • 点击 保存

2. 工作流函数配置错误

对于单参数模板:

headerValue = Map();
headerValue.put("Authorization", "Bearer your_token_here"); // Replace with actual token

raw_data = {
"template_name": template_name,
"broadcast_name": "zoho_auto_" + template_name,
"parameters": [
{
"name": "name",
"value": name
}
]
}; // Valid JSON format

// Format phone number (remove spaces/special characters)
number = number.replaceAll("[\\s+()\\-]", "");

// Invoke API
resp = invokeurl
[
url: "https://your-endpoint.wati.io/api/v1/sendTemplateMessage/91" + number + "?SourceType=ZOHO"
type: POST
parameters: raw_data.toText()
headers: headerValue
content-type: "application/json"
];

info resp;

对于多参数:

parameters: [
    {
        "name": "name",
        "value": name
    },
    {
        "name": "phone",
        "value": phone
    },
    {
        "name": "address",
        "value": address
    }
]

关键修复:

  • ##{{your-bearer-token}}##{{your-wati-api-endpoint}} 替换为实际值

  • 更新 URL 中的国家代码(如有需要替换 91

  • 确保参数之间有正确的逗号分隔

3. 字段映射不正确

症状:消息已发送但包含错误数据。

检查

  • 验证脚本中的所有字段是否与 Zoho CRM 字段名完全匹配

  • 对于联系人/潜在客户:

    • 电话字段必须包含国家代码

    • 自定义字段需要精确的 API 名称

常见问题解答(FAQ)

常规问题

1. 本指南的目的是什么?

本指南可帮助您排除使用 Wati 集成从 Zoho CRM 发送 WhatsApp 消息时的常见问题并修复这些问题。

2. Zoho CRM 和 Wati 集成的最常见问题是什么?

最常见的问题包括:

  • API 端点或令牌配置不正确

  • 工作流函数配置错误

  • Zoho CRM 中的字段映射不正确

API 配置

3. 如何在 Zoho CRM 中修复 API 端点或令牌不正确的问题?

转到 Zoho CRM → 设置 → 市场 → 已安装的应用 → Wati 插件。使用 Wati 帐户中的值更新 API 端点 URL 和 Bearer 令牌。点击保存。

4. 在 Wati 中如何找到我的 API 端点和 Bearer 令牌?

您可以在 Wati 帐户中找到这些详细信息:

  • API 端点 URL:在 API 文档部分可用

  • Bearer 令牌:在 API 设置中可用

参考指南“如何在 Wati 中找到您的 API 端点和 Bearer 令牌”以获取逐步说明。

工作流函数配置

5. 如果我的工作流函数不工作,我应该检查什么?

确保:

  • Authorization 头包含您的正确 Bearer 令牌

  • API URL 包含正确的端点和国家代码

  • 电话号码已正确格式化(没有空格或特殊字符)

  • 参数正确结构化,特别是多个参数

6. 如何在脚本中正确格式化电话号码?

在脚本中使用以下行删除空格和特殊字符:number = number.replaceAll("[\\s+()-]","");此外,确保 API URL 中正确包含国家代码(如印度的 91)。

7. 如何在工作流函数中发送多个参数?

使用以下结构:

parameters: [
    {
        "name": "name",
        "value": name
    },
    {
        "name": "phone",
        "value": phone
    },
    {
        "name": "address",
        "value": address
    }
]

确保每个参数之间有正确的逗号分隔。

字段映射

8. 如果消息已发送但显示错误数据,我该怎么办?

验证:

  • 脚本中的字段名与 Zoho CRM 中的字段名完全匹配

  • 电话字段包含正确的国家代码

  • 自定义字段使用 Zoho CRM 中的精确 API 名称

9. 我可以在哪里学习更多关于配置函数和参数的知识?

您可以在指南中链接的帮助文章中找到关于理解函数、参数和字段映射的详细说明。

这是否解答了您的问题?