文档首页 > > 开发指南>

新手必读

新手必读

分享
更新时间:2021/04/16 GMT+08:00

业务流程

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

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

    相关文档

    相关产品