短信记录
📨 短信记录使用文档
📌 一、功能概述
🔗 二、页面入口
📂 三、短信记录整体功能架构
| 功能模块 | 功能概述 |
|---|---|
| 🔍 多条件筛选组件 | 支持手机号、场景、短信类型、送达状态、时间范围组合查询，快速定位目标下发数据 |
| 📋 短信明细列表 | 分页展示每条短信完整下发信息，包含号码、模板、内容、条数、状态、批次等核心字段 |
| 📄 详情溯源查看 | 单条记录点击详情，调取原始下发params参数、运营商飞鸽回执报文，用于故障排查 |
| 📊 下发数据对账 | 统计区间内下发总量、成功/失败条数，支撑业务运营对账、绩效数据统计 |
| ❌ 异常故障排查 | 通过状态码识别拦截、空号、拒收等失败原因，快速定位短信下发异常问题 |
📋 四、顶部筛选栏字段说明
| 筛选条件 | 输入规范说明 |
|---|---|
| 手机号 | 支持完整11位号码查询，也可输入末尾4位尾号模糊匹配 |
| 场景 | 下拉筛选业务归属场景，默认全部，可单独筛选指定业务线短信 |
| 类型 | 区分通知/营销短信类型，按需筛选对应类别下发记录 |
| 状态 | 按运营商回执状态筛选：成功、失败、待回执，默认展示全部 |
| 时间范围 | 选择下发起始、结束日期，限定查询日志时间区间 |
| 查询按钮 | 填入筛选条件后点击，加载匹配的短信下发明细列表 |
| 重置按钮 | 一键清空所有筛选条件，恢复默认全部查询状态 |
📑 五、短信列表字段释义
| 列表字段 | 字段详细说明 |
|---|---|
| 手机号 | 接收短信的目标用户手机号码 |
| 场景 | 下发短信归属的业务场景标识 |
| 类型 | 短信分类：通知 / 营销 |
| 模板 | 下发使用的短信模板名称 |
| 内容 | 实际发送至用户手机的完整短信正文（含签名、引流短链） |
| 条数 | 当前这条短信拆分计费条数，单条70字内为1条，超长自动拆分多条 |
| 状态 | 运营商回执最终结果：送达成功 / 下发失败 / 待回执 |
| 状态码 | 运营商回执错误编码，用于定位拦截、空号、拒收、违规等失败原因 |
| 发送时间 | 系统发起短信下发请求的精确时间 |
| 批次号 | 批量下发任务唯一批次标识，同批次任务可通过批次号统一筛选 |
| 操作 | 提供【详情】按钮，查看原始下发参数与运营商完整回执报文 |
📈 六、标准查询溯源作业流程
根据排查需求填写手机号、业务场景、短信类型、下发时间区间，精准缩小查询范围。
步骤二：执行列表查询
配置完成筛选参数后点击【查询】，加载对应时间段、业务的短信下发明细。
步骤三：查看 短信整体状态
浏览列表状态字段，区分成功送达与失败拦截短信，统计区间下发总量。
步骤四：异常记录深度溯源
针对失败短信，点击对应行【详情】，调取原始下发参数与运营商回执报文。
步骤五：故障定位处理
根据回执状态码、回执文案，定位拦截、空号、违规等问题，调整模板或重新下发。
步骤六：数据对账统计
导出/统计区间成功送达条数，完成业务短信运营数据对账。
💡 七、运维最佳实践规范
| 规范条目 | 详细说明 |
|---|---|
| 精准筛选减少数据加载 | 查询长周期全量日志时，优先限定手机号、场景缩小范围，避免列表加载缓慢 |
| 失败记录优先查看状态码 | 短信下发失败不直接重发，先通过状态码判断拦截原因，规避重复违规下发 |
| 批次号批量对账 | 批量营销下发任务，使用批次号筛选统一对账，快速核算批量送达率 |
| 定期核对送达数据 | 每日通过短信记录统计通知、营销短信送达量，监控下发拦截波动 |
| 异常回执留存备查 | 违规、高频拦截的短信详情回执截图留存，用于运营商合规核查 |
| 按时间分段查询 | 跨月份、超7天大范围查询时，拆分时间 区间分段检索，提升页面响应速度 |
❓ 八、常见问题排查
| 常见问题 | 排查解决方法 |
|---|---|
| 查询后列表暂无数据 | 核对筛选手机号尾号、时间区间、场景/类型是否匹配，重置条件重新查询；确认该时间段无短信下发任务 |
| 短信状态显示下发失败 | 点击详情查看运营商状态码与回执文案，区分空号、用户拒收、内容违规、通道拦截等问题 |
| 部分短信长期显示待回执 | 运营商回执同步存在延迟，等待5-30分钟后刷新页面重新查询状态 |
| 无法通过手机号模糊检索 | 确认输入尾号数字无误，切换完整手机号查询，部分通道仅支持全号精准匹配 |
| 详情页面看不到原始params参数 | 短信下发时间过久，超日志存储周期，仅保留基础下发明细，无原始报文 |
| 同一批次送达率偏低 | 通过批次号筛选全批次记录，查看批量失败状态码，核查模板文案、签名合规性 |
修改于 2026-06-30 06:30:25