隐私保护通话 PrivateNumber-新手必读:调测指引

时间:2025-02-12 14:52:30

调测指引

隐私保护通话 二次开发过程中,开发者需关注的业务调测点如下:

注:隐私保护通话各模式的二次开发业务流程不完全相同,以下流程以AXB模式为例。

  • Check 1:发起AXB绑定请求前,对请求参数合法性做必要的检查,如:
    • 携带正确的APP接入地址。APP接入地址需登录隐私保护通话控制台,从“应用管理”页获取。
    • 携带的参数格式是否正确,无多余空格等。如:绑定接口携带的A号码需为全局号码格式(如:+86138****0021),其他参数详见API参考文档
  • Check 2:获取绑定请求结果时,请解析出响应结果码。若绑定失败,可参考API错误码中的处理建议进行修正。
    HTTP/1.1 200 OK Content-Type: application/json;charset=utf-8 Content-Length: xx { "resultcode":"0", "resultdesc":"Success" ,"subscriptionId":"********","relationNum":"+867552****08", "callDirection":0,"duration":0,"maxDuration":0}
  • Check 3:隐私保护通话平台会推送呼叫事件通知给客户服务器。若呼叫失败,请解析出挂机事件通知(disconnect)中的挂机原因值(stateCode)并参考挂机原因值排查失败原因。

    注:仅在添加应用时设置了呼叫状态接收地址时,隐私保护通话平台才会推送呼叫事件通知给客户服务器。

    POST /status HTTP/1.1{"eventType":"disconnect","statusInfo":{"sessionId":"1200_1029_4294967295_20190123091514@callenabler246.huaweicaas.com","timestamp":"2019-01-23 09:16:41","caller":"+86138****0021","called":"+86138****7021","stateCode":0,"stateDesc":"The user releases the call.","subscriptionId":"********"}}
  • Check 4:通话结束后,隐私保护通话平台会推送话单通知给客户。若呼叫失败,请解析出转接呼叫操作失败的Q850原因值(fwdUnaswRsn)和通话失败的拆线点(ulFailReason),并参考Q850原因值说明呼叫拆线点说明排查失败原因。

    注:仅在添加应用时设置了呼叫话单接收地址时,隐私保护通话平台才会推送话单通知给客户服务器。

    POST /fee  HTTP/1.1{"eventType":"fee","feeLst":[{"direction":1,"spId":"********","appKey":"************","icid":"ba171f34e6953fcd751edc77127748f4.3757223714.337238282.9","bindNum":"+86138****0022","sessionId":"1200_1029_4294967295_20190123091514@callenabler246.huaweicaas.com","subscriptionId":"********","callerNum":"+86138****0021","calleeNum":"+86138****0022","fwdDisplayNum":"+86138****0022","fwdDstNum":"+86138****7021","callInTime":"2019-01-23 09:15:14","fwdStartTime":"2019-01-23 09:15:15","fwdAlertingTime":"2019-01-23 09:15:21","fwdAnswerTime":"2019-01-23 09:15:36","callEndTime":"2019-01-23 09:16:41","fwdUnaswRsn":0,"ulFailReason":0,"sipStatusCode":0,"callOutUnaswRsn":0,"recordFlag":1,"recordStartTime":"2019-01-23 09:15:37","recordDomain":"****.com","recordBucketName":"****","recordObjectName":"****.wav","ttsPlayTimes":0,"ttsTransDuration":0,"mptyId":"****","serviceType":"004","hostName":"callenabler246.huaweicaas.com"}]}
support.huaweicloud.com/devg-PrivateNumber/privatenumber_01_0024.html