如需查看完整的基于 Schema 生成的目录,请参阅所有示例。
功能简介
处理 WhatsApp 呼叫连接事件。准备工作
- 在您的应用程序中创建一个公开的 HTTPS 端点。
- 为您需要的事件类型配置 YCloud Webhook 端点。
- 安全存储端点签名密钥。
- 确保事件处理具备幂等性。
工作原理
事件发生时,YCloud 会发送 HTTPPOST 请求。验证签名,持久化记录事件,返回 2xx 响应,并异步处理耗时任务。
请求
以下场景展示了发送到您的 Webhook URL 的请求。将事件id 作为投递标识符,并使用 type 路由有效载荷。
响应
接收事件后返回2xx 状态码。
有关端点设置、签名验证和重试机制,请参阅配置 Webhook。
用户发起的呼叫连接
当 WhatsApp 用户呼叫您的商家时,将触发包含 SDP Offer 的呼叫连接 Webhook:请求
响应
持久化接收事件后确认投递。说明
按type 路由事件,通过 id 进行去重,并将耗时或容易失败的任务移至异步处理器。
商家发起的呼叫连接
当商家向 WhatsApp 用户发起新呼叫时,将触发包含 SDP Answer 的呼叫连接 Webhook:请求
响应
持久化接收事件后确认投递。说明
按type 路由事件,通过 id 进行去重,并将耗时或容易失败的任务移至异步处理器。
