用途:把主流 CPaaS 提供商的发送调用、状态分支、Webhook 接收器、退订名单、模板与租户结构逐项映射到 Sent v3,并给出可校验的迁移顺序与回退条件。
主要能力:
- 渠道回退改写:绝不照搬有序渠道数组(会按收件人-渠道对计费),应省略 channel 或发送 ["sent"] 以启用自动路由。
- 状态语义对齐:介绍 QUEUED、ROUTED、SENT、DELIVERED、READ、FAILED、FILTERED、BLOCKED、SCHEDULED 的含义;FILTERED 为策略拦截,不可重试;BLOCKED 需先修复账户。数字错误码需重写为字符串 error.code 族。
- Webhook 校验:Sent 使用 x-webhook-signature: v1,{base64},对 {x-webhook-id}.{x-webhook-timestamp}.{raw_body} 做 HMAC-SHA256;签名密钥为 whsec_ 去掉前缀后 base64 解码,常数时间比较,时间戳超过 300 秒拒绝。各提供商的签名方案需重写实现。
- 退订名单:Sent 在平台层执行同意,存为联系人 opt_out 且跨渠道生效;默认关键词为 STOP、CANCEL、UNSUBSCRIBE、QUIT、END、START、UNSTOP、SUBSCRIBE、HELP、INFO,仅整段文本等于关键词时匹配。
- 模板与租户:位置占位符改为命名参数;子账户、Messaging Service、Application 等映射为 Sender Profile,凭据使用 profile 范围密钥或组织密钥加 x-profile-id。
使用方式:先用 scripts/inventory_scan.py 扫描本地仓库,找出所有发送点、Webhook 处理、状态分支、模板、退订名单与凭据;再按 references/provider-mapping.md 映射,并行搭建 Sent,用 "sandbox": true 验证一致性,小流量灰度并对比送达率、延迟与单条成本,按消息类别分批切换,最后在下线前保留一个完整账单周期并撤销旧凭据。迁移顺序、校验门与回滚触发条件见 references/cutover-playbook.md。
限制与边界:本技能只负责提供商映射与逐行迁移规划;Sent 客户端与弹性逻辑、渠道语义、接收器构建、WhatsApp 入驻、美国活动注册分别交给 sent-integration-starter、sent-routing-strategist、sent-webhook-engineer、waba-embedded-signup、sms-10dlc-registration。202 仅表示受理,不代表已送达;401 重试会导致凭据锁定;双跑时缺少 Idempotency-Key 会重复发送。实际收费、价格与更多平台细节资料未提供。