Skip to main content
如需查看基于 Schema 生成的完整目录,请参阅所有示例。

概述

处理 WhatsApp 通话结束事件。

准备工作

  • 在您的应用程序中创建一个公开的 HTTPS 端点。
  • 为您需要的事件类型配置 YCloud Webhook 端点。
  • 安全存储端点签名密钥。
  • 确保事件处理具备幂等性。

工作原理

事件发生时,YCloud 会发送一个 HTTP POST 请求。验证签名后持久化记录该事件,返回 2xx 响应,并异步处理耗时任务。

请求

以下场景展示了发送到您 Webhook URL 的请求。请将事件 id 视为投递标识符,并使用 type 路由有效负载。

响应

接收事件后返回 2xx 状态码。
有关端点设置、签名验证和重试机制的更多信息,请参阅配置 Webhook。
商家或 WhatsApp 用户均可随时结束通话。当任一方结束通话时,您都会收到通话结束 Webhook:

通话已完成

请求

响应

在持久化接收事件后确认投递。

说明

通过 type 路由事件,通过 id 进行去重,并将耗时或容易失败的任务移交给异步处理器。

通话失败

请求

响应

在持久化接收事件后确认投递。

说明

通过 type 路由事件,通过 id 进行去重,并将耗时或容易失败的任务移交给异步处理器。