用途：实现 Customer.io 报告 Webhook 的接收与事件处理，覆盖邮件送达、打开、点击、转化、退信、垃圾邮件投诉、退订、丢弃、延迟、失败等指标，并将事件可靠地流式写入数据仓库。
主要能力：校验 HMAC-SHA256 签名（请求头 x-cio-signature）；按 event_id 去重；按 metric 路由到退信、投诉、退订、互动、送达等处理器；对硬退信与投诉调用 suppress 抑制用户；用 identify 更新用户属性；将事件插入 BigQuery 等仓库。
使用方式：在 Customer.io 的 Data & Integrations > Integrations > Reporting Webhooks 添加端点 URL 并复制签名密钥到 CUSTOMERIO_WEBHOOK_SECRET。服务端需公开 HTTPS 端点，使用 Express 等框架；该路由必须使用原始 body 解析（express.raw），且置于 JSON 解析之前，否则签名校验失败。校验通过后立即返回 200，再异步处理以避免超时。生产环境去重建议用带 TTL 的 Redis 集合，而非内存 Set。
适用场景：邮件投递事件追踪、点击/打开分析、退信与投诉处理、退订管理、事件入仓分析。
限制：资料未提供具体价格、平台支持范围与性能指标；示例中的内存去重与重试策略仅为示意，生产需替换为持久化队列与有界退避，终态失败应进入受保护队列，经 schema 与同意检查后再重放。