快递外卖语音通知-语音通知API

三大快递外卖语音通知场景:

图片.png

1:快递外卖语音验证码通知:

用于发送验证码类短信,常见使用场景:账号注册、登录验证、找回密码、安全提醒等场景

2:快递外卖语音系统通知:

用于向注册用户发送产品、服务通知短信,常见使用场景:产品维护、状态提醒、价格调整、故障告警等场景

3:快递外卖语音会员营销:

用于向有订购关系的会员/注册用户发送会员营销类短信,常见使用场景:促销活动通知、新业务宣传、新品上线、会员关怀等场景

公共参数

参数名 类型 描述信息 必填
Action string 对应的 API 指令名称,当前 API 为 SendUVMSMessage Yes
PublicKey string 用户公钥,可从 控制台 获取 Yes
Signature string 根据公钥及 API 指令生成的用户签名,参见 签名算法 Yes

请求参数

参数名 类型 描述信息 必填
ProjectId string 项目ID。不填写为默认项目,子帐号必须填写。 请参考GetProjectList接口 No
CalledNumber string 被叫号码,采用 E.164 标准,格式为+[国家代码][用户号码]。
例如:+8613512345678, 其中前面有一个+号 ,86为国家码,13512345678为手机号
Yes
TemplateId string 模板 ID,在控制台审核通过的模板 ID。 Yes
TemplateParams.N string 模板可变参数,以数组的方式填写,举例,TemplateParams.0,TemplateParams.1,… 若模板中无可变参数,则该项可不填写;若模板中有可变参数,则该项为必填项,参数个数需与变量个数保持一致,否则无法发送; No
FromNumber string 主叫号码,号码随机时不填。专属号码时传入已购买的号码,仅支持一个号码,在控制台查看已购买的号码。 No
UserId string 自定义的业务标识ID,字符串( 长度不能超过32 位),不支持 单引号、表情包符号等特殊字符 No
GroupType int 号码组类型,1-随机组,2-专属组。如不填写则根据主叫号码判断,若主叫号码为空,则为随机组,若不为空,则为专属组。 No
DispatchRule int 调度规则,0-默认(归属地优先),1-随机。当不指定外显号码(主叫号码为空)时生效。如不填写,默认为归属地优先。 No

响应字段

字段名 类型 描述信息 必填
RetCode int 返回状态码,为 0 则为成功返回,非 0 为失败 Yes
Action string 操作指令名称 Yes
Message string 返回错误消息,当 RetCode 非 0 时提供详细的描述信息 No
ReqUuid string 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 ReqUuid。 Yes
SessionNo string 本次提交发送语音的唯一ID,可根据该值查询本次发送详情 No
UserId string 本次提交的自定义业务标识ID,仅当发送时传入有效的UserId,才返回该字段。 No

请求示例

https://api.ucloud.cn/?Action=&Region=cn-zj &Zone=cn-zj-01 
&ProjectId=JMliDugq &CalledNumber=+8613512345678 
&TemplateId=xxxxxxxxx &TemplateParams.0=123456 &UserId=ucloud 
&FromNumber=IIiUKXds &GroupType=1 &DispatchRule=0 &GroupType=1 
&DispatchRule=0

响应示例

{ "Action": "SendUVMSMessageResponse", "Message": "Send success", "ReqUuid": 
"278fab0f-f0dc-4de6-a308-77f07ea276b4", "RetCode": 0, "SessionNo": 
"17ad00c9-8186-4e5a-8f64-c50a2c84cf0a", "Test": "SdZdBQda", "UserId": "ucloud" 
}

原创文章,作者:网友投稿,如若转载,请注明出处:https://www.cloudads.cn/archives/4230.html

发表评论

登录后才能评论