5.1.5 短信群发接囗V4.0

概述

该接口为 企业账户级短信发送接口，适用于我司企业账户中购买企业短信套餐，请注意与 5.1.1 短信发送V1.0 及 5.1.3短信群发V3.0 做区别；

调用形式

https://xtapi.uincall.com/api/sms/sendMsgV4.action

调用方式

POST Content-Type”, “application/x-www-form-urlencoded

传入参数

序号	名称	是否必填	说明
1	appver	是	应用版本值：1
2	user	是	登录用户名
3	secret	是	计算sercert请阅读1 2 3(不能直接拿3获取到的token直接赋值给当前接口的secret进行调用）
4	timestamp	是	当前时间，服务端会验证时间有效性，如果与服务端时间差大于 10 分钟则请求无效。
5	account	是	企业号码
6	corpId	是	企业ID
7	data	是	发送的短信内容，JSONArray格式，数量和模板中变量个数匹配，且变量内容只能包含中文，数字,英文短横杠（-），逗号（,），顿号（、）,句号（.），冒号（:），点（•），井号（#）,波浪号（~），中文双引号（“”），加号（+），最多支持5个变量。示例：短信模板为：您的账户余额：{0}元,如有疑问，请联系客服人员。客服电话{1} data:[“1010.20”,”029-86145678”]平台会自动和模板匹配，生成短信：您的账户余额：1010.20元,如有疑问，请联系客服人员。客服电话029-86145678 。
8	mobile	是	接收短信的手机号码多个手机号码，英文逗号分隔，上限1000个。
9	templateId	是	模板编号客户提供短信模板到优音工作人员，工作人员在管理平台审核通过后，提供给客户该编号。
10	reply	否	短信回复推送（上行短信）。取值：1:接受。0：不接受。回执路径需要提供给优音工作人员。
11	replyurl	否	短信回复推送地址
12	tag	否	自定义标签，当请求传入此参数时则回执报告时也会携带此参数，长度不超过64

回应参数

序号	名称	是否必填	说明
1	errcode	是	0为成功，其它为失败。
2	errmsg	是	结果解释。
3	serviceSn	是	短信的流水号
4	data	是	json对象
4.1	smsWords	否	data中参数，单条短信字数
4.2	smsNum	否	data中参数，发送条数，仅供参考
5	msg	是	短信内容

使用样例

调用：

https://xtapi.uincall.com/api/sms/sendMsgV4.action

post 数据：
appver=1&timestamp=20261010141200&secret=21961622f03b7365844c70a858d143bc&user=400xxxxxxx_dev&account=400xxxxxxx&mobile=186xxxx0001&templateId=bddf879a-70e2-4076-a9e3-9e9c8c68b287&corpId=33769358-xxxx-xxxx-xxxx-xxxxbb76f89b

响应：

{
    "errcode": 0,
    "msg": "【北京思比邻通讯】欢迎使用优音通讯服务",
    "result": "",
    "total": 0,
    "data": {
        "smsWords": 19,
        "smsNum": 1
    },
    "errmsg": "短信发送成功",
    "serviceSn": "84f8d874-748c-4d03-a108-2bcf164af9ef"
}

文档更新时间: 2026-10-10 14:27 作者：admin