文档首页/ 隐私保护通话 PrivateNumber/ 开发指南/ 新手必读
更新时间：2021-07-08 GMT+08:00
查看PDF
分享

新手必读

业务流程

隐私保护通话二次开发业务整体流程如下：

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

  1. 参考开发准备，获取调用隐私保护通话API的关联数据。
  2. 参考代码样例调用AXB模式绑定接口，设置用户号码A、用户号码B和隐私号码X的绑定关系。
  3. 根据请求响应消息，判断请求是否成功。
  4. 发起呼叫验证绑定关系：使用A或B号码直接呼叫X号码（点击查看其他模式的呼叫验证方法）。

    因运营商管控，固话号码只能接收来自X号码的呼叫，不能作为主叫呼叫X号码。若用户号码A为固话号码，请使用用户号码B（手机号码）呼叫X号码进行验证，反之亦然。

  5. 查看接收到的呼叫事件通知和话单通知（若要接收呼叫事件通知和话单通知，需在添加应用时填写“呼叫状态接收地址”和“呼叫话单接收地址”）。
  6. 根据呼叫是否接通（如A直接呼叫X，是否接通B），判断呼叫是否成功。
  7. 是否开启了录音功能？（点击查看如何开启录音功能）

调测指引

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

注：隐私保护通话各模式的二次开发业务流程不完全相同，以下流程以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"}]}

相关文档