使用 Zoho CRM Webhooks 发送 WhatsApp 消息
在 Zoho CRM 中，我们可以生成 Webhooks 来执行 API。此外，这些 Webhooks 可以与工作流规则一起使用，以实现自动化操作。在本文中，我们将看到如何使用 Zoho CRM Webhooks 和 WOZTELL API 发送 WhatsApp 消息。为此，我们可以按照以下步骤操作：
- 生成访问令牌
- 配置 Webhook
- 发送 文本消息
- 发送 模板消息
生成访问令牌
WOZTELL API 需要访问令牌来验证用户的身份。因此，在开始使用我们的 API 之前，我们必须生成一个令牌。为此，我们可以使用平台文档来生成令牌。
请记住，发送消息的 API 使用以下权限范围：bot:sendResponses, bot:admin
请注意，在 Zoho CRM 中的 Webhooks 需要生成一个短的访问令牌
点击 这里 直接访问生成令牌的文章。
配置 Webhook
在 Zoho CRM 中，我们可以通过以下步骤创建 Webhook：
1. 登录到您的 Zoho CRM 账户
2. 转到设置
3. 在“自动化”部分，点击“操作”
4. 点击 Webhooks 标签。
5. 点击配置 Webhook 按钮
6. 给 Webhook 起个名字并添加描述
7. 在方法中选择 POST 作为值
8. 在通知的 URL 中，我们必须放入 API 的 URL 和访问令牌。它看起来像这样：
请记得将 {woztell-access-token} 更改为您令牌的值。
9. 在授权类型部分，选择“通用”
10. 我们必须选择要配置该 Webhook 的 CRM 模块。在这个例子中是“潜在客户”。
11. 在 Header 部分，我们不配置任何内容。
12. 在 Body 部分，我们将选择 Raw 作为类型，JSON 作为格式。
13. 完成后，我们可以将包含要发送信息的 JSON 文件粘贴到出现的文本框中。
{
"channelId": "{woztell-platform-channel-id}",
"recipientId": "{whatsapp-phone}",
"response": [
{response-message-type}
]
}
以下是参数的说明：
|
channelId
|
Channel ID 用于标识消息将从哪个电话号码发送。我们可以按照此文章中的步骤获取 Channel ID。 |
|
recipientId
|
recipientID 指的是我们要发送消息的电话号码。如果我们需要在 Webhook 中使用 Zoho CRM 字段，可以输入 # 以显示可用字段。（例如：如果我们在潜在客户模块中选择“手机”字段，Zoho CRM 会添加文本 ${Leads.Mobile}，并且在 Webhook 触发时使用“手机”值）。
|
|
response
|
在 response 中，我们可以添加要发送的消息。正如在 Woztell 官方文档 中所示， 有一些可以发送的消息类型。
|
发送文本消息
完成前面的步骤后，要发送文本消息，我们必须在 JSON 中添加 response 参数，并使用在 API 文档 中指定的格式。在这种情况下，Webhook 的原始数据将是：
{
"channelId": "{woztell-platform-channel-id}",
"recipientId": "{whatsapp-phone}",
"response": [
{
"type": "TEXT",
"text": "Hello World!"
}
]
}
response 参数将是一个包含以下值的 JSON：
|
type
|
这个值将始终是 TEXT |
|
text
|
我们想要发送的消息内容。
|
发送模板消息
{
"channelId": "{woztell-platform-channel-id}",
"recipientId": "{whatsapp-phone}",
"response": [
{
"type": "TEMPLATE",
"elementName": "{whatsapp-template-name}",
"languageCode": "{whatsapp-template-language}",
"components": [
{components-json-value}
]
}
]
}
response 参数将是一个包含以下值的 JSON：
|
type
|
此值将始终为 TEMPLATE
|
|
elementName
|
这是模板创建时生成的唯一名称。我们可以从平台上的频道或 WhatsApp 管理员处获得此值 Facebook Business Manager。
|
|
languageCode
|
这是模板的语言代码。我们可以从 Woztell 平台上的频道或 WhatsApp 管理员处检查模板语言，或访问 Facebook Business Manager 获取更多信息。在本文中
|
|
components
|
模板的参数会根据模板是否包含头部、图片、音频、视频、参数、底部和/或按钮而有所不同。为此，以下是生成组件字段 JSON 的一些步骤。
|
生成模板的 JSON
您可以从平台轻松获取模板的 JSON，并通过 API 发送它。为此，只需按照以下步骤操作：
2. 在 资源 中查找并点击 响应。
3. 点击“新建响应”以生成新的响应。
4. 在此窗口中，我们将通过点击左侧标签选择可用的不同渠道选项来创建新的 WhatsApp 模板。
5. 在此菜单中，我们将通过使用“平台”按钮选择 WhatsApp 云平台。
6. 现在，在消息类型中，我们可以选择 WhatsApp 模板。
7. 然后，在模板中选择我们集成的 WABA，该平台中包含了电话号码，接着点击“更新消息模板”按钮。
8. 按下按钮后，我们必须选择模板（消息模板）。
9. 选择后，我们将语言策略选项保留为“确定性”，并选择所需的语言（语言）。
10. 根据模板，它将显示我们必须选择的参数。在我们的案例中，我们在正文中有一个参数和两个按钮。我们将它们填入所需的值。
11. 填写完所有模板数据后，点击“确认”按钮。
12. 现在模板已填写完毕，我们可以通过点击高级来获取 JSON 参数。
13. 在这个新部分，我们可以看到模板的完整 JSON，但我们只关心 components、elementName 和 languageCode 的值。我们可以复制这些参数的值，并将它们粘贴到我们的 Zoho CRM Webhook 中。它看起来像这样，包含所有数据：
14. 最后，我们可以将需要的变量添加到 Zoho CRM 的 Webhook 组件中。
完成后，我们可以将这个 Webhook 应用到 Zoho CRM 的工作流规则中。