摘要

本文档将详细介绍 Wati 中 REST API 操作可用的不同事件类型。您将了解每个事件的触发时机、可发送的数据以及如何正确使用它们——尤其是在收集反馈、表单数据或潜在客户信息时。

说明

基于事件的 REST API 操作在会话中发生特定事件时会自动运行。每种事件类型在发送数据（参数）方面都有不同的行为。

了解这些差异有助于您选择正确的事件并避免配置问题。

1. 赞成/反对事件

触发时机

当用户在聊天界面点击反馈按钮（👍 或 👎）时，将触发此事件。

参数行为

仅支持静态（固定）参数
无法传递动态用户数据

这意味着 API 请求中的所有值都必须是预定义的。

常见用例

跟踪用户满意度指标
收到负面反馈时发送 Slack 通知
将反馈事件记录到分析平台

⚠️ 重要提示：赞成/反对事件本身无法发送动态用户信息，例如电子邮件地址、姓名或对话内容。

结合赞成/反对事件与反馈表单

如果您需要详细的反馈或用户信息，可以将此事件与表单已提交事件结合使用。

工作原理

创建一个反馈类型的自定义表单
当用户点击 👍 或 👎 时，反馈表单会自动弹出
用户填写表单（例如，反馈原因或电子邮件）
两个事件可以同时触发：
- 赞成/反对事件 → 发送静态数据
- 表单已提交事件 → 发送动态表单数据

示例场景

💡 提示：要收集电子邮件、原因或评论，请务必使用自定义表单，并为表单已提交事件创建单独的 REST API 操作。

2. 表单已提交事件

触发时机

当用户在聊天界面完成并提交自定义表单时，将触发此事件。

参数行为

支持来自表单字段的动态参数
表单字段名称必须与 REST API 配置中使用的占位符完全匹配

设置方法

步骤 1：创建自定义表单

创建一个具有明确定义的字段名称的自定义表单。

示例：

表单字段名称	字段类型	描述
`email`	Email	用户的电子邮件地址
`first_name`	Text	用户的名字
`company`	Text	公司名称
`message`	Text	用户的消息

步骤 2：配置 REST API 操作

在 API 请求中使用占位符，其中后缀与表单字段名称匹配。

占位符可以包含前缀，例如 contact.、agent. 或 action.，但匹配仅基于后缀（最后一个 . 之后的部分）。

示例：

表单字段 email → {{email}} 或 {{contact.email}}
表单字段 first_name → {{first_name}} 或 {{contact.first_name}}
表单字段 company → {{company}} 或 {{contact.company}}

参数匹配规则

表单字段	占位符	匹配	原因
`email`	`{{email}}`	✅ 是	直接匹配
`email`	`{{contact.email}}`	✅ 是	后缀 `email` 匹配
`first_name`	`{{contact.first_name}}`	✅ 是	后缀 `first_name` 匹配
`first_name`	`{{agent.first_name}}`	✅ 是	后缀 `first_name` 匹配
`firstName`	`{{contact.first_name}}`	❌ 否	后缀不匹配（区分大小写）
`user_email`	`{{contact.email}}`	❌ 否	后缀不匹配 ( `user_email` ≠ `email`)

⚠️ 重要提示：占位符后缀必须与表单字段名称完全匹配，包括大小写。前缀不影响匹配。

示例流程

3. 潜在客户已捕获事件

触发时机

如果 AI 代理在聊天过程中收集了潜在客户信息，此事件将在对话结束 10 分钟后自动触发。

参数行为

使用固定请求正文结构
您无法自定义或修改发送的字段

固定请求正文结构

当此事件运行时，Wati 会自动发送以下负载：

{
  "agent_id": "agent_id",
  "data": {
    "conversation_id": "conversation_id",
    "details": "Lead details",
    "email": "[email protected]",
    "first_name": "John",
    "last_name": "Doe",
    "lead_level": "Hot",
    "lead_score": 100,
    "lead_summary": "Lead summary",
    "max_score": 100
  },
  "event": "lead_captured"
}

字段描述

字段	描述
`agent_id`	AI 代理的 ID
`conversation_id`	唯一对话标识符
`details`	收集的潜在客户信息
`email`	用户的电子邮件（如果可用）
`first_name`	用户的名字
`last_name`	用户的姓氏
`lead_level`	潜在客户质量（Hot、Warm、Cold）
`lead_score`	数字潜在客户分数
`lead_summary`	AI 生成的潜在客户摘要
`max_score`	最高可能分数

注意：您无需为潜在客户已捕获事件定义 request_body。任何自定义请求正文配置都将被忽略。

常见用例

自动在 Salesforce 或 HubSpot 中创建潜在客户
将潜在客户数据发送到营销自动化工具
在您的 CRM 中触发后续工作流

快速参考：事件类型比较

功能	赞成/反对	表单已提交	潜在客户已捕获
动态参数	❌ 否	✅ 是	❌ 固定结构
自定义请求正文	✅ 是（仅静态）	✅ 是	❌ 否
需要表单设置	❌ 否	✅ 是	❌ 否
触发时机	立即	立即	对话结束 10 分钟后
需要用户操作	点击反馈	提交表单	无（自动）

选择正确的事件类型

使用赞成/反对进行简单的反馈跟踪
当您需要动态用户输入时，使用表单已提交
使用潜在客户已捕获进行对话后自动潜在客户交接

选择正确的事件可确保您的 REST API 操作可靠运行并发送您期望的数据。

理解 WhatsApp 板消息类型和指南

如何设置 REST API 操作

如何排查 REST API 操作

如何使用离线同步将潜在客户数据同步到 Google 表格

如何使用 WABA 和电话号码 Webhook 事件

可用事件类型：详细指南

摘要

说明

1. 赞成/反对事件

触发时机

参数行为

常见用例

结合赞成/反对事件与反馈表单

工作原理

示例场景

2. 表单已提交事件

触发时机

参数行为

设置方法

步骤 1：创建自定义表单

步骤 2：配置 REST API 操作

示例流程

3. 潜在客户已捕获事件

触发时机

参数行为

固定请求正文结构

字段描述

常见用例

快速参考：事件类型比较

选择正确的事件类型