文档

API&SDK常见问题

更新时间:

您在使用语音服务API或SDK时,如果遇到疑问后可以参考以下常见问题及处理建议。

语音服务SDK是否支持Android终端?

当前语音服务SDK不支持Android和iOS终端编译。

语音服务VoiceReport接口返回后会再次推送吗?

一个通话结束推送后,只要您有一台服务器接收到消息,就不会再次推送。

dyvmsapi.aliyuncs.com连接失败怎么办?

dyvmsapi.aliyuncs.com为语音服务接口地址,属于公网域名,请您检查网络设置。

语音服务呼叫回了408处理超时是什么原因?

错误码408一般为被叫侧长时间未接起导致的或者被叫服务器问题。

语音服务外呼拨号返回487是什么情况?

请您登录语音服务控制台,在业务统计 > 语音记录查询页面查看失败原因。如果无结果请提供对应的主被叫及时间,转人工服务进行核实。

语音发送模板接口返回成功但是呼叫记录显示占线?

接口返回成功仅代表接口调用结果,不代表通话结果。通话详情可以登录语音服务控制台,在业务统计 > 语音记录查询页面查询。

调用API报错isv.BLACK_KEY_CONTROL_LIMIT提示模板变量中存在黑名单关键字?

isv.BLACK_KEY_CONTROL_LIMIT提示模板变量中存在黑名单关键字,您的入参有异常, 请确认模板是否存在非法内容。 更多信息请参见语音模板规范,API错误码请参见API错误码

语音服务公网接入域名策略是否为双向放开?

公网域名接入是双向放开,公网接入点请参见服务接入点

说明

语音服务接口接入只能通过公网域名接入,不能通过IP访问。

语音服务控制台查看话单详情,显示错误码200005?

运营商回执错误码200005是被叫用户无法接通,因运营商问题或者被叫拒接等导致的被叫无法接通。更多回执错误码请参见运营商回执错误码

语音通知接口如何设置重播次数?

SingleCallByVoice和SingleCallByTts接口,您可以入参时PlayTimes设置播放次数。如果正常接通,就会多次播放;如果未接通,就不会有多次播放。具体详情请参见语音通知语音验证码

说明

如果语音通知呼叫失败,则无自动重播功能。

可以直接调用API接口,查看语音模板或者创建语音模板吗?

语音服务的文本转语音模板目前仅支持在语音服务控制台创建 ,暂不支持API接口创建模板 ,如果您需要创建模板或者查看您申请过的模板,请登录语音服务控制台查看。

调用QueryCallDetailByCallId接口为什么Data中state等于200没有对应的运营商侧错误码?

调用QueryCallDetailByCallId接口中Data中state等于200说明接口已调用成功,由于刚呼叫完成的错误码合成有时候会产生延迟,所以会出现您查询state=200,而不是对应运营商回执错误码的情况,建议您在呼叫结束3~5分钟后再查询。

语音服务如何将多个IP设置为回调地址?

同一个阿里云账号同一种类型的回执消息只支持配置一个回调地址。如果您有多个IP地址需要接收回执消息,建议您申请多个阿里云账号,配置不同的IP地址。 回执消息配置详情,请参见回执消息简介与配置流程

语音服务VoiceReport设置回调地址报错?

您需要解析阿里服务器发送的测试内容:{"json":"test-content"},这个测试内容是JSON格式,不是Json Array格式。在设置回调地址进行测试的时候,需要您本地按照JSON格式进行校验;测试完成后,实际接收回执消息的时候,需要按照Json Array格式进行校验。