关闭
立即体验

立即体验

立即体验
服务类型:
手机号:
验证:
短信内容:

【中昱维信】您的验证码是:****。请不要把验证码泄露给其他人。

您的验证码是:****。

【中昱维信】假日来袭,福利送不停!您有两张代金券已到账,
请注意查收。

发彩信 找维信!


发彩信 找维信!

彩信内容承载量大,形式丰富,是政府企业手机报
和会员维护的优选媒体,支持:
●图文彩信 ●音频彩信
●视频彩信 ●国际彩信
8年专业服务,品质保证,咨询热线:400-68-10658

彩信群发接口文档

1120 2018-10-25 13:55:54 中昱维信

本文档仅使用于中昱维信彩信群发接口。PDF文档请点击下载

1.接口概览

1.1彩信群发介绍

中昱维信彩信群发专用接口,拥有专业的技术和稳定的平台,优质的通道资源,7*24 小时服务监控等优势

1.2彩信组成

创建彩信

用户群发彩信时首先需要调用接口创建彩信,创建彩信需要将发送的彩信标题,彩信内容,以及平台生成的AppId,AppKey提交至接口,接口完成处理之后返回创建的彩信ID。

发送彩信

发送彩信时需要将已经创建好的彩信ID,和需要发送的手机号码,和平台生成的AppID,AppKey,发送时间提交至接口

1.3 功能介绍

本文档主要提供给中昱维信平台的用户对接接口的使用说明,开发者可以利用中昱维信提供的HTTP 接口,调用中昱维信的创建彩信,群发彩信服务。

2.开始接入

2.1 接入说明

彩信服务属于收费功能,用户可按照自己的使用量自助购买短信条数。创建彩信时,提交的内容大小不能超过100KB,建议在60K左右。发送彩信时单次向接口提交的手机号码不能超过2000。彩信群发接口分为创建彩信和发送彩信。

注册登录中昱维信短彩信平台,可查看彩信群发接口接入指南、状态码参考、demo示例以及常见问题。(注:如需直接使用,可查看:彩信群发平台使用指南

群发彩信接口平台内容

中昱维信短彩信平台还可进行在线彩信群发接口测试,位置在左侧栏目列表中的“常用工具”---“功能&接口测试”

群发彩信接口在线测试

2.2接入流程

用户接入中昱维信彩信群发一共需要 5 个步骤,具体步骤如下

开始使用

中昱维信彩信群发首先要在中昱维信官网注册账号,官网右上角登录/注册。

完成企业实名认证

完成了注册之后登录平台   打开系统设置==》账户资料,上传相应的企业资质

充值彩信群发产品

平台支持线下和线上充值选择产品然后进行充值

获取账号

从平台获取注册账号的AppID和AppKey

菜单栏>验证码栏目>用户设置>(右上角)用户信息

请求地址

https://vip.veesing.com/mmsApi/commit

使用接口创建彩信

创建彩信请求地址是客户接口程序调用的时候请求的url地址,采用的是http post接口。请求应答过程中使用的中文编码格式为UTF-8。

参数名称

含义

参数值

必填

appId

平台自动生成的唯一账户标识

2RYN7CQHL1M*****

appkey

平台自动生成的唯一账户标识

WVNA4A0*****

content

提交彩信内容(内容格式请看下方说明)

title

彩信标题

UTF-8编码标题

提交彩信内容格式要求

包括类型,文字和图片,图片格式为base64,文字信息格式为gb2312,帧与帧之间用;分隔。每个资源内部包含多个类型信息,分别是:播放时间,类型 | 内容(按字节码base64编码), 类型 | 内容(按字节码base64编码),每一帧资源类型和内容之间以 | 隔开,每一个帧可以有多个资源类型和内容,同一帧之间用半角逗号(,)分隔。

完整创建彩信POSTDATA案例

appKey:**************&appId:**********&customerid:1&content=3,txt|zsSxvg==,jpg|4AAQSkZJRgABAgAAZABk;3,gif|ExghIhcXGRcXIiQdIB8fIB0kJCssLywrJDk5Pj45OUFBQ

正确返回参数实例

注意:taskid即为用户创建的彩信ID

{

 "returnStatus": "2000",

"message": "创建成功",

"remainpoint": null,

"taskId": "55",

"successCounts": "1"

}

 错误返回参数实例

{

"returnStatus": "4005",

"message": "缺少参数",

"remainpoint": null,

"taskId": null,

"successCounts": "0"

}

使用接口发送彩信

创建彩信请求地址是客户接口程序调用的时候请求的url地址,采用的是http post接口,地址是:https://vip.veesing.com/mmsApi/send

参数名称

含义

参数值

必填

appId

平台自动生成的唯一账户标识

2RYN7CQHL1M*****

appKey

平台自动生成的唯一账户标识

WVNA4A0*****

sentid

返回的彩信taskID

456

sendtime

发送时间

定时发送时间 如2013-05-15 00:00:00 若不填写表示立即发送

sendto

手机号码

下发信息的手机号码,可以是多个手机号,手机号之间用逗号分隔

 

 

 

 

 

 

 

 

 

 

 

 

 

 

统一返回参数

3000

发送成功,彩信等待发送

4012

数组格式错误

2001

单次提交号码不能超过2000

4011

余额不足,请充值

2002

身份认证信息有误,请检查APPIDAPPKEY

2000

创建成功

4005

参数不合法

4013

用户资质未通过或者正在通过中

4010

账户被锁定

4200

未进行企业认证,只能发送系统默认模板

4080

定时时间必须大于当前时间30分钟以上

4081

定时时间不正确 例:2017-4-5 15:34:00

4014

Sentid(模板ID)有误

正确返回参数实例

{

    "returnStatus": "2000",

    "message": "创建成功",

    "remainpoint": null,

    "taskId": "55",

    "successCounts": "1"

}

错误返回参数实例

{

    "returnStatus": "4005",

    "message": "缺少参数",

    "remainpoint": null,

    "taskId": null,

    "successCounts": "0"

}

2.3彩信群发回执推送

用户如需获取彩信群发对的回执推送请在系统配置里面添加接收推送的服务器地址

3.审核说明

企业审核

依据《中华人民共和国网络安全法》相关要求,平台账号必须完成真实身份信息认证后,才可正常使用相关服务,感谢您的理解和支持!用户正式使用本平台所有服务之前,需要先提供企业营业执照(正本或副本)的复印件加盖公章(公章需彩色),然后在【首页】-【账户资料】里面完成实名认证。

彩信内容

依据《中国人民共和国网络安全法》相关要求,用户使用必须遵循国家相关法律法规,不得发送违法信息,平台所有彩信内容必须严格遵守法律法规,如含有违规信息的彩信,企业会被永久禁封,敬请谅解。

4.常见问题

彩信发送提交之后为什么没收到?

每一条彩信都需要经过后台通道排队,具体情况视当时彩信通道情况为准,约为30分钟之内可完成发送;彩信提交至运营商通道后,如果运营商通道拥挤,则会有延迟。

彩信图片应该怎么设置?

彩信图片最小的标准是176*143px(像素),随着智能手机的普及,在彩信体积不超出的前提下彩信的宽度可以扩展至大于250像素小于400像素的区间。

会员短信群发有内容限制吗?

有内容限制,未经用户允许的纯营销短信禁止发送,另外运营商规定的教育、金融、医疗、房产都是四大类不可以发送。但是部分有正规资质的企业需要向会员发送通知信息的,可以向运营商申请专享通道,具体申请方式、需要提供的材料等等请向在线客服咨询。

5.联系我们

联系电话 : 400-68-10658

E-mail : service@veesing.com

代理加盟 : 18019467159

地址 : 上海市浦东新区金科路2966号1幢211室

客服热线:400-68-10658