通信接入
企业短信通道接入,需要准备什么?
企业接入短信通道,先提交用途、接收对象、签名正文、业务触发规则和系统接口资料。博士通短信通道的联调要同时核对请求受理、发送流水、状态回执、用户实际接收和异常处理。重复调用与延迟回执要有对应规则,才能把一条短信关联到真实业务任务。
先把不同用途的短信分开梳理
验证码、订单通知、预约提醒和会员沟通,目标不同,准备方式也不同:
● 验证码:服务于用户正在发生的操作(登录、注册、支付),讲究时效
● 订单通知:对应某个业务状态(已发货、已签收、已受理),由系统触发
● 预约提醒:关联具体的时间与地点,业务可能改期或取消
● 会员沟通:面向特定人群,接收对象与内容范围需要另外确认
准备需求时,建议把每一类消息的触发事件、内容变量、接收对象分别列清楚。这样才能判断通信资源、接口方式和运营流程是否匹配,而不是只给一个总发送量——总量相同的两家企业,接入方式可能完全不同。
接口资料里,要带上业务含义
接口对接不只是给出字段名称,还要说明每个字段从哪里来、什么时候有效。例如一条预约提醒,字段要能对应到具体的业务记录;否则一旦发送失败,查不到是哪一次预约出了问题。 建议按下面五项准备:
| 资料项 | 需要说明的内容 |
|---|---|
| 消息类型、签名与内容示例 | 验证码、通知还是会员沟通;签名是什么;正文示例与变量有哪些 |
| 预计日常量级与峰值时段 | 日常每月多少条;大促、节庆等高峰时段大概多少条 |
| 调用结果、可用状态及核对方式 | 需要哪些返回字段;状态如何回传给业务系统;如何核对 |
| 异常处理、重试规则与负责人 | 失败和状态未知怎么处理;重试条件与上限;双方对接人是谁 |
测试不只看接口返回,要看用户收到什么
接口受理成功只是发送链路中的一个节点。测试阶段还要确认:
● 用户收到的内容是否正确,变量是否完整替换
● 业务系统如何处理失败请求与重复请求
● 不同场景的关注点不同:验证码看时效,通知看内容准确,会员沟通看对象范围
各类场景的通过标准应在项目阶段明确,不宜只用一条固定消息测试后就认为全部业务可以上线。
上线前,先约定异常怎么处理
上线前需要分清:哪些异常由业务系统自己处理,哪些需要我们配合支持。出现重复发送时,要同时检查触发条件和重试逻辑,而不是默认靠增加发送次数解决。
上线后,可以按场景核对短信条数与实际业务量的对应关系——例如某天预约提醒发了 500 条、实际预约只有 480 单,多出的 20 条就说明触发环节需要排查。运行指标的观察方式与服务约定,我们会在项目中和你确认。
给接口负责人的联调清单
这一清单用于准备首次接入。已接入后如果状态回执出现异常,可另见排查指南;联调时建议把"接口已受理"与"用户已收到短信"作为两个结果分别记录,不要合并成一个。
| 检查项 | 填写或判断方法 | 验收依据 |
|---|---|---|
| 业务输入 | 用途、签名、正文、变量及业务编号 | 能对应到同一次业务触发 |
| 返回与回执 | 受理结果、发送流水、状态及时间 | 逐项确认字段含义与未知状态的处理方式 |
| 异常验证 | 重复调用、失败、延迟与状态冲突 | 重试不会造成重复的业务动作 |
常见问题
已有业务系统需要全部重做吗?
应先了解现有接口与流程,评估标准接入或定制对接范围,不预设必须替换系统。
报价前最少应说明哪些信息?
主要是四类:短信用途、发送覆盖范围、预计业务量,以及现有系统的对接需求。
