短信服务-自定义连接流配置

概述

专属集成平台提供自定义连接流功能，支持企业将第三方短信网关服务快速集成到平台中，实现短信发送功能的灵活定制与扩展。通过连接流配置，可以无缝对接主流运营商或第三方短信服务提供商的API接口，满足企业在登录验证、通知提醒等场景中的短信发送需求。

适用对象：系统管理员、平台运维人员 前置条件：已获取第三方短信网关的账号、密码、接口地址等接入凭证 技术复杂度：中等

图1：短信服务集成架构示意图

配置流程

1. Webhook连接流配置

1.1 创建短信连接流模板

登录专属集成平台平台管理控制台

导航至**"连接中心 > 场景模版"**菜单

在模板列表中，根据实际需求选择以下预置模板：

【中国联通Http短信】模板

【浙江移动Http短信】模板

点击**"立即使用"**按钮，进入配置页面

图2：场景模板选择界面

图3：模板详情与配置入口

图4：创建连接流配置界面

1.2 【中国联通Http短信】配置参数说明

选择中国联通模板后，需要配置以下核心参数：

参数名称	说明	获取方式
API接口地址	联通短信网关服务器URL	由运营商提供
用户ID(userid)	短信平台账号标识	联通短信平台开户后获取
时间戳(timestamp)	请求时间戳，格式为yyyyMMddHHmmss	系统自动生成
签名(sign)	请求安全签名，MD5(userid+timestamp+密码)	根据算法动态生成
签名密码	用于生成签名的密钥	由运营商提供
短信签名	短信内容前的企业标识，如【科技】	需报备审核通过

图5：联通短信参数配置界面

图6：联通短信高级配置项

1.3 【浙江移动Http短信】配置参数说明

选择浙江移动模板后，需要配置以下核心参数：

参数名称	说明	获取方式
API接口地址	移动短信网关服务器URL	由运营商提供
企业编码(eccode)	企业在移动短信平台的唯一标识	开户后由移动提供
业务代码(businesscode)	短信业务类型标识	申请业务时获取
签名密钥(secretkey)	用于生成签名的密钥	由运营商提供
短信签名	短信内容前的企业标识	需在移动平台备案
模板ID(templateid)	预设短信模板编号	在移动平台申请

图7：移动短信基础参数配置

图8：移动短信高级参数配置

图9：API接口测试界面

1.4 启用自定义连接流

完成连接流配置后，点击**"保存"**按钮

在连接流列表页面，找到刚创建的连接流，点击**"上线"按钮（如配置无误，可点击"强制上线"**）

导航至**"品牌设置 > 短信模版配置 > 第三方短信服务"**菜单

选择**"自定义连接流"**选项卡，并在下拉列表中选择已上线的连接流

图10：启用自定义连接流界面

技术参数说明

HTTP请求参数规范

短信发送API通常采用HTTP GET或POST方法，常见参数包括：

参数名	数据类型	是否必填	说明
mobile	String	是	手机号码，多个号码使用英文逗号分隔
content	String	是	短信内容，需包含已审核的签名
timestamp	String	是	请求时间戳，用于防重放攻击
sign	String	是	安全签名，不同运营商算法略有差异
extno	String	否	扩展号码，用于区分业务来源
sendTime	String	否	定时发送时间，格式为yyyyMMddHHmmss

响应结果处理

平台会解析短信网关返回的结果，常见响应格式如下：

{
  "code": "0",
  "message": "发送成功",
  "transactionId": "202309151023453721",
  "failPhones": []
}

响应状态处理逻辑：

成功状态：系统记录发送成功日志

失败状态：记录错误码和失败原因，可配置重试机制

异常状态：捕获网络异常并记录日志，提供问题排查入口

常见问题与解决方案

1. 未购买连接流模块的配置方法

问题：客户未采购连接流模块，如何配置短信服务？

解决方案：可联系技术支持团队，提供相关商务合同信息，由技术人员协助配置webhook地址，确保短信服务正常使用。

2. 含URL短信发送失败问题

问题：发送的短信内容中包含URL链接，使用「中国联通Http短信」模板发送失败。

解决方案：在HTTP节点中对短信内容进行URL编码处理：

var content = {{N1901925213942263809.value.content}};
var mobile = {{N1901925213942263809.value.mobile}};
const encodedContent = encodeURIComponent("【中国合格评定国家认可委员会】" + content);

return `http://xx.xx.xx.xx:xxxxx/xxxxx.aspx?userid=xxxx&action=send&timestamp=${time}&sign=${sign}&mobile=${mobile}&content=${encodedContent}&sendTime=&extno=`;

图11：URL编码处理示例

3. 短信发送频率限制问题

问题：系统提示"发送频率超过限制"错误。

解决方案：

检查运营商对单个手机号的发送频率限制（通常为1分钟1条，1小时5条，1天10条）

在连接流中添加频率控制逻辑

必要时联系运营商调整频率限制参数

最佳实践

短信内容规范

签名规范：

确保短信签名已在运营商平台完成备案

签名格式为【企业名称】，需放在短信正文开头

签名内容应与备案信息完全一致

内容规范：

避免使用敏感词汇

控制短信长度，建议不超过70个字符

验证码类短信明确说明有效期

发送策略优化

错峰发送：批量短信建议错峰发送，避免瞬时并发过高

重试机制：针对网络波动导致的发送失败，建立合理的重试策略

黑名单机制：建立短信黑名单机制，避免骚扰投诉

监控与告警

建议设置以下监控指标：

短信发送成功率告警（低于95%触发告警）

短信API接口可用性监控

短信发送量异常波动监控

短信服务-自定义连接流配置

概述#

配置流程#

1. Webhook连接流配置#

1.1 创建短信连接流模板#

1.2 【中国联通Http短信】配置参数说明#

1.3 【浙江移动Http短信】配置参数说明#

1.4 启用自定义连接流#

技术参数说明#

HTTP请求参数规范#

响应结果处理#

常见问题与解决方案#

1. 未购买连接流模块的配置方法#

2. 含URL短信发送失败问题#

3. 短信发送频率限制问题#

最佳实践#

短信内容规范#

发送策略优化#

监控与告警#

概述