如需查看基于架构生成的完整目录,请参阅所有示例。
概述
处理contact.deleted 和 contact.note.deleted 事件。
准备工作
- 在您的应用程序中创建一个公开的 HTTPS 终端节点。
- 为您所需的事件类型配置 YCloud Webhook 终端节点。
- 安全存储终端节点签名密钥。
- 确保事件处理具备幂等性。
工作原理
事件发生时,YCloud 会发送 HTTPPOST 请求。验证签名,持久化记录该事件,返回 2xx 响应,并异步处理耗时任务。
请求
以下场景展示了发送到您的 Webhook URL 的请求。将事件id 视为投递标识符,并使用 type 来路由有效载荷。
响应
在接收事件后返回2xx 状态。
有关终端节点设置、签名验证和重试机制的详细信息,请参阅配置 Webhook。
- Webhook 终端节点 URL 应由您的服务器提供,而非 YCloud。 请确保将该 URL 替换为您实际的 Webhook 终端节点 URL。
- 请确保您的 Webhook 终端节点正在侦听相应的事件类型。 另请参阅配置 Webhook、获取 Webhook 终端节点 API。
基础联系人删除示例
请求
响应
在持久化接收事件后确认接收。说明
- 最简信息:
contactDeleted对象仅包含基本信息:id、nickName、phoneNumber和updateTime。 - Null 值:如果联系人未设置昵称,则
nickName字段可能为null。 - 更新时间:
updateTime反映了联系人在删除前的最后修改时间。 - 联系人 ID:
id字段包含已删除联系人的唯一标识符以供参考。 - 电话号码:
phoneNumber始终存在并采用 E.164 格式。
联系人备注已删除
当联系人备注被删除时使用contact.note.deleted。
请求
响应
在持久化接收事件后确认接收。说明
使用contactNote.id 标识备注,使用 contactId 标识其所属的联系人。username 和 phoneNumber 用于描述联系人,可以为 null。有效载荷包含面向客户的备注快照,包括 content,不含内部操作员标识符。该事件在独立删除备注时发出。删除联系人不会针对每个级联删除的备注发出此事件。
