摘要
Wati 的 Chatbot Builder (聊天机器人构建器) 中的 Webhooks 允许你在聊天机器人和外部应用程序之间发送和接收实时数据，使用 GET 或 POST API 请求。此功能支持动态聊天机器人交互，例如获取用户详情、验证数据或与第三方服务集成。
注意：Webhook (Webhook) 功能仅在 Pro & Business (专业版和商业版) 计划中可用。 如果你使用的是标准计划，你可以创建和保存带有 Webhooks 的聊天机器人，但需要升级才能在 Keyword Action (关键词操作) 或 Default Action (默认操作) 工作流程中使用它们。
说明
高级聊天机器人构建器仅在 Pro 和 Business 计划中可用。
在聊天机器人构建器中使用 Webhooks
1. 将 Webhook 添加到你的聊天机器人
打开 Wati Chatbot Builder (Wati 聊天机器人构建器)。
将 Webhook (Webhook) 图标拖放到聊天机器人工作流程中。
将其连接到相关的聊天机器人步骤。
2. 配置 Webhook 节点
URL & Method (网址和方法)
选择 request method (请求方法)：
GET或POST。输入外部 API 的 URL endpoint (网址端点)。
使用 Variables (变量) 按钮插入变量，使 URL 动态化。
示例：https://webhook-wa-testing.clare.ai/123456789?name=##{{name}}![](https://brainfish-storage-prod.s3-accelerate.amazonaws.com/uploads/8e891fb2-b8da-40b6-8609-c45377c7118c/3e6b6f07-c5ff-4b63-b18f-b881dd533bdd/SCR-20250304-qcus.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAUPPN5IL3QLQZLDSU%2F20251203%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20251203T050551Z&X-Amz-Expires=3000&X-Amz-Signature=fadf7374dd24de3800f0d21096ec52e22c61a8ced2d283de071d936ae80ed172&X-Amz-SignedHeaders=host&response-content-disposition=attachment"=844x330")
自定义 headers (页眉)
Headers 允许你包含请求中的额外信息，例如内容类型或授权信息。
Headers 是 optional (可选) 的，默认情况下已 off (关闭)。
它们必须遵循 key-value (键值) 格式。
示例：
Key (键) = Content-Type
Value (值) = application/json
自定义 body (正文)
请求主体是你包含发送到外部 API 的数据的位置。
Body 是 optional (可选) 的，默认情况下已 off (关闭)。
启用后，Body 必须始终采用 JSON 格式。
设置你的测试变量
手动定义测试变量，以在设置 Webhook 时模拟 API 响应。
3. 测试 Webhook 请求
单击 Test the request (测试请求)，以检查 API 调用是否按预期工作。
4. 将 API 响应保存为变量
你可以捕获来自 API 响应的值，并将其存储在 变量 或 custom attributes (自定义属性) 中。
如果 API 返回包含 key-value (键值) 对的 JSON，你可以提取并保存特定的值。
示例：存储 API 响应中的“result”: “success”：
{ "result": "success" }
在对象内存储值
使用格式：
objectKey.keyName。示例：要存储来自以下响应的
QuoteId，请使用Result.QuoteId。
{
"Result": {
"QuoteId": "xxxxx",
"QuoteNumber": "xxxxxx",
"PolicyNumber": null
},
"MessageValidation": null,
"QuoteReferrals": null
}在对象数组中存储值
要提取和存储来自对象数组中的值，请使用格式：
$.[0].objectKey.keyName[0].value
示例：要捕获 current_status 的值，请使用：
$.[0].tracking_data.shipment_track[0].current_status
示例 JSON：
[
{
"tracking_data": {
"track_status": 1,
"shipment_track": [
{
"id": 1278937320,
"current_status": "Delivered"
}
]
}
}
]
5. 使用响应路由
响应路由允许你根据响应状态代码拆分聊天机器人操作。
你可以定义不同的聊天机器人流程，具体取决于 API 响应。
通过集成 Webhooks，你可以使用外部数据增强聊天机器人功能，自动化工作流程并以动态方式改善用户交互。
常见问题解答 (FAQs)
通用问题
1. Wati 的聊天机器人构建器中的 Webhooks 是什么？
Webhooks 允许你的聊天机器人使用 GET 或 POST API 请求从外部应用程序发送或接收实时数据。 这有助于你创建动态和个性化的聊天机器人响应。
2. 哪些计划支持 Webhook 功能？
Webhooks 在专业版和商业版计划中完全可用。 标准计划的用户可以创建并保存带有 Webhooks 的聊天机器人，但必须升级才能在关键词操作或默认操作工作流程中使用它们。
3. 如何将 Webhook 添加到我的聊天机器人？
打开聊天机器人构建器，将 Webhook 图标拖动到你的工作流程中，并将其连接到你希望 API 调用发生之处的聊天机器人步骤。
4. 我可以为 Webhook 请求使用哪些方法和网址？
你可以使用 GET 或 POST 请求。 输入所需的 API 端点，并在网址中插入变量，以传递动态用户数据。
5. Headers 和请求主体是否需要？
不需要，两者都是可选的。 仅当 API 需要额外信息（例如授权或内容类型）时才添加 headers。 仅当需要向外部 API 发送 JSON 数据时，才启用主体。
测试和响应处理
6. 如何测试我的 Webhook 是否有效？
使用 Test the request (测试请求) 选项，以在设置过程中确认 API 调用是否按预期工作。
7. 我可以存储 API 响应中的值吗？
是的，你可以将返回的值存储在变量或自定义属性中。 这适用于简单的响应、嵌套的 JSON 对象和数组。
8. 如何从嵌套对象或数组中提取值？
对于对象，使用点符号（例如：Result.QuoteId），对于列表，使用数组格式。
9. 什么是响应路由？
响应路由允许你根据 API 状态代码定义不同的聊天机器人流程，以便聊天机器人可以以不同的方式响应成功的或失败的 API 调用。