检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API调用失败如何处理?失败后可以一直不停的调用吗? 当SP调用API接口失败时,根据语音通话平台返回的4xx或5xx消息中“resultdesc”字段初步确定故障类型,例如参数非法、access_token过期、系统错误等。调用接口失败后要及时排查原因,不可以一直不停的调用,容易导致IP被封禁。
推送的话单中时间未按正常的时区显示,服务器时间和北京时间相差8小时? 话单里的时间统一用的是UTC时间,加8小时即为北京时间。 父主题: 呼叫状态和话单通知
客户侧的网络与华为云服务通信正常。 图1 telnet成功示例 图2 telnet失败示例 若步骤1失败,使用安卓手机软件Ping&DNS,输入对应ip和端口,若显示open则表示华为云服务正常,需客户侧排查自身网络问题;若显示close则联系华为云客服处理。 父主题: 故障排除
应用调用API发起呼叫后,语音通话平台在接收到终端用户操作通知时,如振铃、接听、挂机等,会实时向企业服务器推送呼叫状态通知。 呼叫终止时,即用户未接听、用户挂机或异常挂机,语音通话平台会向企业服务器推送话单通知。 父主题: 呼叫状态和话单通知
HH:mm:ss”。 fwdUnaswRsn 否 Integer 转接呼叫操作失败的Q850原因值。详细说明参见附录1-Q850原因值说明。 failTime 否 String(1-128) 呼入、呼出的失败时间。 该参数为UTC时间(+8小时为北京时间),时间格式为“yyyy-MM-dd
HH:mm:ss”。 fwdUnaswRsn 否 Integer 无 转接呼叫操作失败的Q850原因值。详细说明参见附录1-Q850原因值说明。 failTime 否 String(1-128) 无 呼入、呼出的失败时间。 该参数为UTC时间(+8小时为北京时间),时间格式为“yyyy-MM-dd
SP应用调用场景API时,填写feeUrl参数。 注意事项 若平台给SP推送话单后未收到成功响应,视为推送失败,会重新推送话单,直至客户返回成功响应。平台最多重推6次,每次时间间隔1小时。若6次重推后仍然推送失败,后台会生成话单文件,请联系华为云客服手动推送。 单个用户(一路呼叫)的话单通知是根据呼
"stateDesc":"The user releases the call."}} 响应参数 接收到事件通知时,第三方服务器响应返回200则为成功,否则语音通话平台会认为推送失败。 响应示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8
"stateDesc":"The user releases the call."}} 响应参数 接收到事件通知时,第三方服务器响应返回200则为成功,否则语音通话平台会认为推送失败。 响应示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8
"stateDesc":"The user releases the call."}} 响应参数 接收到事件通知时,第三方服务器响应返回200则为成功,否则语音通话平台会认为推送失败。 响应示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8
提供的URL无效,请确认该URL是可通过外网访问的有效地址。 华为服务器作为客户端向提供的URL推送呼叫状态通知和话单通知时,发送的POST请求中不携带任何认证鉴权信息,若提供的URL所在服务器需要对客户端进行认证,则会出现没有收到呼叫状态通知和话单通知的情况。请不要对华为服务器做认证鉴权。 接口中携带的URL加
附录3-其他附加性说明 本文档中提供的API接口均采用短连接(短信接口除外,短信接口可支持长连接。),平台服务器作为服务端时会主动拆链,建议SP作为客户端时不要主动拆链,等接收到服务端的FIN, ACK后按照正常四次挥手拆链。 若SP主动拆链,可能造成该链路对应的端口短时间不可用,影响SP发送请求。
接收呼叫过程中状态信息(振铃、应答、挂机等)的服务器地址。若需订阅呼叫状态通知,可提交该资源。 提前准备可用的服务器地址,创建应用时填写,或调用接口时填写。 创建应用,请参考添加应用。 话单通知URL(可选) feeUrl 接收呼叫结束后产生话单的服务器地址。若需订阅话单通知,可提交该资源。
按键操作 501 录音创建会议失败 502 录音创建会议超时 503 录音主叫加入会议失败 504 录音主叫加入会议超时 505 录音增加录音端点失败 506 录音增加录音端点超时 507 启动录音失败 508 启动录音超时 509 放录音提示音失败 510 放录音提示音超时 512
若语音通话平台给SP推送呼叫状态或话单后未收到成功响应,视为推送失败。 若呼叫状态通知推送失败,语音通话平台不会重新推送。 若话单通知推送失败,语音通话平台会重新推送话单,直至客户返回成功响应。最多重推6次,每次时间间隔1小时。若6次重推后仍然推送失败,后台会生成话单文件,请联系华为云客服手动推送。
语音验证码能力实现流程 前提条件 打车软件服务器与语音通话平台对接正常。 打车软件服务器成功登录语音通话平台。 Jane注册打车软件,输入电话号码后,点击“获取语音验证码”。 打车软件服务器发起语音验证码请求,请求语音通话平台向Jane播放语音验证码。 打车软件服务器调用“语音验证码API”实现整个呼叫过程。
录音功能会涉及用户的通信内容,请确保更换的录音提示音满足当地法律法规的要求。 快递网站服务器成功登录语音通话平台。 Jack登录快递网站服务器。 Jack输入自己的号码使用语音回呼业务联系客服。 语音回呼请求上报至语音通话平台。 快递网站服务器调用“语音回呼场景API”实现整个呼叫过程。 语音通话平台呼叫Jack。
所示。 图2 语音通知能力实现流程 前提条件 业务公司服务器与语音通话平台对接正常。 业务公司服务器成功登录语音通话平台。 业务公司服务器发起语音通知请求,请求语音通话平台向Jane播放业务公司定制的欠费通知。 业务公司服务器调用“语音通知API”实现整个呼叫过程。 语音通话平台呼叫Jane。
语音通话平台将业务触发过程中通话的状态信息(包括呼出、振铃、摘机和挂机信息)推送至此服务器,SP根据通话状态信息确定用户状态。 URL可填写为https://IP:Port或域名,推荐使用域名。且该域名对应多个服务器,避免单点故障无法接收通知。 URL只能由大小写字母(a-z、A-Z),数字(0-9
参考代码样例调用语音通话API,发起语音回呼/语音通知/语音验证码请求。 根据请求响应消息,判断请求是否成功。 请求成功 => 4 请求失败 => 参考API错误码,修正后重新执行2 参考挂机原因值、Q850原因值、呼叫拆线点查看语音通话平台推送的呼叫状态通知和话单通知。 (仅