关于 sent-analytics
sent-analytics 是用于 Sent 数据分析的技能，面向需要查询消息量、可达率和联系人总数的操作人员。它区分时间范围指标、全时段比率与当前快照，并说明号码查询不代表同意或发送许可。
主要功能
- 01查询消息发送量及分桶数据
- 02查看全时段可达率
- 03查看当前联系人总数
- 04查询号码能力与路由信号
- 05区分分析与消息级诊断
适用场景
- 01按日期和时区查看消息量
- 02检查全时段消息可达率
- 03查看当前联系人规模
- 04评估号码能力信号而不推断许可
MCP 相关
作为技能，它指导 MCP 客户端使用 `numbers.lookup` 和 `dashboard` 工具，并说明授权范围、敏感信息处理及查询限制。
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/sent-analytics确认已加载。
附带文件agents/openai.yaml
详细介绍
已发送数据分析
使用 numbers.lookup、dashboard.messages_sent、dashboard.deliverability 和 dashboard.contacts 进行数据分析和付费外部号码查询。numbers.lookup 会改变状态且不具备幂等性，即使它不会发送消息。
建立上下文
使用客户端管理的 OAuth 2.1/PKCE。绝不请求或泄露令牌、API 密钥、授权标头、客户端 ID 或密钥。如果客户端会显示当前组织和 Sender Profile，请确认它们。
尽量减少敏感输出：掩盖电话号码，尽可能汇总，并省略回答问题不需要的联系人、KYC、账户和消息正文数据。
组织授权可以通过工具架构中的可选 profileId 选择一个自有 Sender Profile；省略该字段则以已认证账户身份操作。使用 sender_profiles.list 或 sender_profiles.get 验证所有权，并在预检读取、变更操作和后续读取中使用同一选择器。Profile 授权无法使用此选择器。若要切换到其他组织或授权范围外的 Profile，请重新授权。绝不编造范围字段或请求凭据。
查询号码
使用 numbers.lookup 获取所提供号码的可用能力、格式、类型或路由信息。查询结果描述的是号码能力，并不能证明用户已选择接收消息、已同意、拥有该号码、身份属实或允许向其发送消息。如果结果可能用于规划触达，请始终说明这一区别。每个已认证账户范围每天按 UTC 时间计算，可付费查询 1000 次；所有操作 Profile 共用该额度，并于 00:00 UTC 重置。遵守配额错误提示；不要轮换 Profile，也不要循环重试。临时配额检查失败可能会放行查询，但这并不意味着查询免费。
查询仪表板指标
- 为
dashboard.messages_sent确定日期范围、时区和聚合粒度。该指标统计受支持的预设或自定义时间窗口内已送达或已读的出站 SMS 和 WhatsApp 消息，支持 15 分钟、每小时或每日分桶；不要将其描述为所有已排队发送的消息或 RCS 流量。 dashboard.deliverability返回全时段出站百分比：(SENT + DELIVERED + READ) / (all except FILTERED and BLOCKED)。它不是限定日期范围、仅统计送达的成功率。不要编造日期筛选条件，也不要声称这个单值指标反映了上周的对比情况。dashboard.contacts返回当前联系人总数。单次快照无法证明联系人数量的增长、活动情况或历史趋势。- 比较时应确保组织、操作 Profile、支持的时间窗口、时区、渠道覆盖范围和粒度相同。说明工具的实际统计范围：数量指标按日期范围和时区统计，送达率为全时段，联系人数量为快照值。
根据证据标注处理状态和送达状态；绝不要将已接受等同于已送达。对于不受支持的历史对比，请使用导出的消息级证据或其他有文档说明的数据源。
选择汇总分析或问题诊断
使用此技能查询仪表板总量、比率和趋势。如果请求涉及消息级送达记录、漏斗流失、错误代码聚类或根因诊断，请使用 messaging-performance-analyzer。送达率仪表板可以帮助发现变化，但仅凭它无法证明实际运营原因。