有关基于 Schema 生成的完整目录,请参阅所有示例。
功能概述
处理联系人创建事件。准备工作
- 在您的应用程序中创建一个公开的 HTTPS 端点。
- 为您所需的事件类型配置 YCloud Webhook 端点。
- 安全存储端点签名密钥。
- 确保事件处理具备幂等性。
工作原理
事件发生时,YCloud 会发送 HTTPPOST 请求。请验证签名、持久化记录事件、返回 2xx 响应,并异步处理耗时任务。
请求
以下场景展示了投递至您 Webhook URL 的请求。请将事件id 作为投递标识符,并使用 type 对有效载荷进行路由。
响应
接收事件后返回2xx 状态。
有关端点设置、签名验证及重试机制,请参阅配置 Webhook。
联系人创建示例
请求
响应
在持久化接收事件后确认投递。说明
- 完整联系人信息:
contactCreated对象包含创建时该联系人的所有可用信息。 - 自定义属性:
customAttributes字段包含与该联系人关联的任何自定义数据。 - 标签:
tags数组包含在创建期间分配给该联系人的所有标签。

