SuperAPI AI 工具集

sent-routing-strategist

通用与其它

查看项目

更新于 10-16 08:46

技能介绍

用途:帮助判断一条 Sent 消息应以自动路由还是固定渠道送达收件人,并正确解读发送结果。

主要能力:澄清 channel 数组是广播列表而非偏好顺序,["whatsapp","sms"] 配两个收件人会生成四条消息、四次计费;不存在回退字段或有序偏好语法。自动路由才是回退机制:省略 channel 或传 ["sent"] 时平台选路,并在路由级失败时于最多三组“渠道加供应商”组合间重路由。固定渠道会把匹配限制在该渠道且绝不跨渠道;若该渠道无可用路由,消息以 FAILED 结束而非静默回退。渠道值仅限 sent、sms、whatsapp、rcs,其他值返回 400。

使用方式:需要“能送达即可”或“先试某渠道再回退”时,省略 channel 或传 ["sent"];合规、合同或内容要求指定渠道时才固定渠道。@POST /v3/messages 返回 202 与逐收件人的 message_id。自动路由下回显的逐收件人 channel 并非已解析路由,且不会更新;应通过 message.routed 事件、GET /v3/messages/{id} 的 channel、message.delivered 及 GET /v3/messages/{id}/activities 核对真实结果。

适用场景:诊断投递结果、判断终态。FAILED 表示某次路由尝试失败,自动路由仍可能再排一次;FILTERED 是策略门禁(同意阻断或路由拒绝),不可重试;BLOCKED 是账户前提(余额、入驻配额、未审批模板),修复后再发;SCHEDULED 表示被静默时段策略暂存,会自动回到流程。channel 为 auto 表示尚未尝试任何路由即结束。

限制与成本:仅当失败信号指向路由或运营商问题(该路由不可达、供应商不可用、超时、传输错误)才会重路由,其余保持 FAILED;重路由复用同一 message_id,并排除已尝试路由,上限为三组渠道与供应商组合,每次尝试都会重新过同意门禁。平台无固定渠道优先顺序。单请求收件人上限 1,000,多渠道路由数组会按收件人倍增消息与费用。RCS 目前仅文本加最多四个由模板按钮映射的建议按钮,且每条外发 RCS 都会附加 STOP 按钮,不应设计依赖富卡片、轮播或媒体的 RCS 固定流程。