操作指南 · 业务配置与系统设置
业务短信通道与模板
先判断短信场景和合规边界,再建立通道、模板、测试号码、回执与失败处理。
适用版本:2.1.94 及以上 · 适用端:PC · 2026-08-24 验证
先区分短信类型
验证码、订单通知、服务跟进和营销短信的资质、模板与退订规则不同。先在第三方平台确认企业资质、短信签名和每个模板已经审核通过,再在 ZenTea 建立对应场景。保存模板只完成系统配置,不会自动触发发送。
上线顺序
- 在“系统管理 → 业务配置 → 业务短信 → 通道配置”选择当前版本支持的通道;自定义网关必须使用可访问的公网 HTTPS 地址。
- 填写通道凭证、短信签名和供应商模板编号,密钥类字段保存后不会回显。
- 在“场景与模板”分别建立验证码、订单创建、发货、完成、跟进或营销模板。
- 使用企业内部测试号码触发真实发送,核对模板变量、第三方消息号和最终回执。
- 测试成功后再逐步开放正式场景,不使用真实客户名单批量联调。
回执与重试
发送记录会经历待发送、已提交、送达或失败等状态,具体结果以第三方回执为准。自定义网关回调需要满足页面约定的签名和时间窗;网络超时不等于第三方没有接收,重试前先按消息号查询。重试次数受系统限制,也不能绕过供应商限流、余额不足或模板拒绝。
营销短信边界
营销短信必须尊重退订名单和发送时段,并使用审核通过的营销模板。验证码和必要交易通知应使用独立场景,不能借交易通知规避营销退订,也不能把营销内容混入验证码模板。
快速排查
| 现象 | 先检查什么 |
|---|---|
| 保存模板后没有短信 | 是否真正触发了对应业务场景或发送任务 |
| 通道无法启用 | 当前版本是否支持该通道,HTTPS 地址和必填凭证是否完整 |
| 第三方提示模板不存在 | 账号环境、签名和供应商模板编号是否一致 |
| 页面显示已提交但手机没收到 | 查看最终回执、第三方消息号、运营商拦截和手机号状态 |
| 失败记录不能重试 | 是否达到上限,或原因为资质、余额、限流等不可重试错误 |
| 营销短信被跳过 | 手机号是否退订,模板和账号是否具有营销资质 |
需要逐字段配置自定义网关时,继续查看《业务短信通道、模板与发送排查》。