联系人退订创建 Webhook 示例

如需查看基于 Schema 生成的完整目录，请参阅所有示例。

功能概述

处理联系人退订创建事件。

准备工作

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

工作原理

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

请求

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

响应

接收事件后返回 2xx 状态。

HTTP/1.1 200 OK

有关终端节点设置、签名验证和重试行为，请参阅配置 Webhook。

在用户退订您发送的 WhatsApp 消息时触发。Webhook 有效负载包含用户的手机号码信息以及退订时间。

联系人退订创建示例

请求

{
  "id": "evt_68f8886903683f3481f9707b",
  "type": "contact.unsubscribe.created",
  "apiVersion": "v2",
  "createTime": "2025-10-22T07:31:53.872Z",
  "unsubscriberChanged": {
    "id": "68f888692abba5779b565928",
    "phoneNumber": "+8615166662222",
    "source": "API",
    "updateTime": "2025-10-22T07:31:53.864Z"
  }
}

响应

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

HTTP/1.1 200 OK

说明

unsubscriberChanged 对象包含用户的手机号码信息和退订时间。

开始使用

指南

接口

Webhooks

联系人退订创建 Webhook 示例

功能概述

准备工作

工作原理

请求

响应

联系人退订创建示例

请求

响应

说明

​功能概述

​准备工作

​工作原理

​请求

​响应

​联系人退订创建示例

​请求

​响应

​说明

功能概述

准备工作

工作原理

请求

响应

联系人退订创建示例

请求

响应

说明