检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 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原因值、呼叫拆线点查看语音通话平台推送的呼叫状态通知和话单通知。 （仅
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
