向指定手机号码发起单向呼叫,将文本模板内容转化为语音播放给被叫方。使用前需要在阿里大于管理中心添加去电显示号码与文本转语音模板。
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
called_num | String | 必须 | 13700000000 | 被叫号码,支持国内手机号与固话号码,格式如下057188773344,13911112222,4001112222,95500 | |
called_show_num | String | 必须 | 4001112222 | 被叫号显,传入的显示号码必须是阿里大于“管理中心-号码管理”中申请或购买的号码 | |
tts_code | String | 必须 | TTS_10001 | TTS模板ID,传入的模板必须是在阿里大于“管理中心-语音TTS模板管理”中的可用模板 | |
extend | String | 可选 | 12345 | 公共回传参数,在“消息返回”中会透传回该参数;举例:用户可以传入自己下级的会员ID,在消息返回时,该会员ID会包含在内,用户可以根据该会员ID识别是哪位会员使用了你的应用 | |
tts_param | Json | 可选 | {"AckNum":"123456"} | 文本转语音(TTS)模板变量,传参规则{"key":"value"},key的名字须和TTS模板中的变量名一致,多个变量之间以逗号隔开,示例:{"name":"xiaoming","code":"1234"} |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
result | BizResult | 接口返回参数 | |
|
1 2 3 4 5 6 7 8 9 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret); AlibabaAliqinFcTtsNumSinglecallRequest req = new AlibabaAliqinFcTtsNumSinglecallRequest(); req.setCalledNum( "13700000000" ); req.setCalledShowNum( "4001112222" ); req.setTtsCode( "TTS_10001" ); req.setExtend( "12345" ); req.setTtsParamString( "{\"AckNum\":\"123456\"}" ); AlibabaAliqinFcTtsNumSinglecallResponse rsp = client.execute(req); System.out.println(rsp.getBody()); |
1 2 3 4 5 6 7 8 | < alibaba_aliqin_fc_tts_num_singlecall_response > < result > < model >134523^4351232</ model > < msg >成功</ msg > < success >false</ success > < err_code >0</ err_code > </ result > </ alibaba_aliqin_fc_tts_num_singlecall_response > |
1 2 3 4 5 6 | < error_response > < code >50</ code > < msg >Remote service error</ msg > < sub_code >isv.invalid-parameter</ sub_code > < sub_msg >非法参数</ sub_msg > </ error_response > |
错误码 | 错误描述 | 解决方案 |
---|---|---|
isv.OUT_OF_SERVICE | 业务停机 | 请登录阿里大鱼充值 |
isv.PRODUCT_UNSUBSCRIBE | 未开通产品服务 | 请登录阿里大鱼开通相应产品服务 |
isv.ACCOUNT_NOT_EXISTS | 账户信息不存在 | 请登录阿里大鱼完成入驻 |
isv.ACCOUNT_ABNORMAL | 账户信息异常 | 请联系技术支持 |
isv.MOBILE_NUMBER_ILLEGAL | 手机号码格式不合法 | 请使用合法的手机号码 |
isv.TTS_TEMPLATE_ILLEGAL | 文本转语音模板不合法 | 请使用合法的文本转语音模板。登录www.alidayu.com查看已审核通过的文本转语音模板。 |
isv.DISPLAY_NUMBER_ILLEGAL | 号显不合法 | 请使用合法的号显。登录www.alidayu.com查询已审核通过的号码 |
isv.TEMPLATE_MISSING_PARAMETERS | 文本转语音模板参数缺失 | 登录www.alidayu.com查询文本转语音模板,检查模板参数是否漏传。 |
isv.INVALID_PARAMETERS | 参数异常 | 请检查入参是否合法 |
isv.60004 | - | - |
isv.BLACK_KEY_CONTROL_LIMIT | 模板变量中存在黑名单关键字。如:阿里大鱼 | 黑名单关键字禁止在模板变量中使用,若业务确实需要使用,建议将关键字放到模板中,进行审核。 |
isv.PARAM_NOT_SUPPORT_URL | 变量不支持url参数 | 变量不支持url参数 |
isv.BUSINESS_LIMIT_CONTROL | 触发业务流控 | 触发业务流控 |
isv.PARAM_LENGTH_LIMIT | 参数长度受限 | 调整模板变量参数长度 |
isp.SYSTEM_ERROR | 系统错误 | 系统错误 |