SuperAPI AI 工具集

messaging-performance-analyzer

数据与分析

查看项目

更新于 10-16 08:46

技能介绍

用途:把 Sent 消息的原始证据转化为“发生了什么变化、漏斗在哪漏水、先修什么”的诊断。当用户问消息为何失败、投递或已读率为何下降、回退是否生效、提供商是否在过滤流量、某次群发表现如何时使用。不用于注册 10DLC、设计 Sender Profile、接入 RCS 或编写 WhatsApp 模板,这些应交给相关技能。

主要能力:以 Sent 的 message_id 为主键建立分析队列,按渠道拆分后再汇总,区分投递(QUEUED、ROUTED、SENT、DELIVERED)与互动(WhatsApp/RCS 的 READ),并统计计数与比率、失败率相对基线的变化、精确错误码、首次出现时间、受影响模板/国家/Profile。

用法:先用 POST /v3/messages 发送获取 message_id,再用 GET /v3/messages/{id} 查最新状态、GET /v3/messages/{id}/activities 还原生命周期,并通过 GET /v3/webhooks、/event-types、/{id}/events、POST /{id}/test 核查 Webhook 配置与连通性。可用脚本:python scripts/analyze_mdr_funnel.py path/to/mdr.csv,支持 --threshold、--show-errors、--format json;退出码 0 表示无观察到的跃迁违规,2 表示输入无效或无可用队列,3 表示发现违规。

适用场景:短信/WhatsApp/RCS 的投递与失败排查、漏斗流失定位、Webhook 事件缺失诊断、渠道回退验证。

限制:不要用提供商 ID(如 wamid)作主键;不要用最新状态反推未观察到的中间状态;缺失分母记为 N/A 而非 0;不要凭小样本断定“运营商过滤”;轮换密钥仅在用户明确要求或怀疑凭据泄露时进行。缺失的收费、价格、平台支持等信息暂未提供。