三大快递外卖语音通知场景:
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