《SmartVoice融合通信平台整合说明.docx》由会员分享,可在线阅读,更多相关《SmartVoice融合通信平台整合说明.docx(11页珍藏版)》请在第壹文秘上搜索。
1、SmartVoice融合通信平台通话记录整合说明2020-11-25V3.21通话记录整合错误!未定义书签。1. 通话记录整合简介:错误!未定义书签。2. 第三方实时获取通话记录错误!未定义书签。.2.1.界面配置错误!未定义书签。.2.2.提交的数据错误!未定义书签。.2.3.转接历史对象描述:错误!未定义书签。.2.4.传真传输结果表错误!未定义书签。3. 第三方获取录音文件流错误!未定义书签。.3.1.根据refJd下载语音流错误!未定义书签。.3.2.电话拨打录音下载接口错误!未定义书签。.3.3.语音留言下载接口错误!未定义书签。5. 第三方播放录音文件错误!未定义书签。.5.1.调
2、用方式错误!未定义书签。6. 第三方获取传真文件错误!未定义书签。.6.1.调用方式:错误!未定义书签。.6.2.数据返回错误!未定义书签。1通话记录整合1 .通话记录整合简介:通话记录整合是指第三方应用获取SmartVoice呼叫中心的通话记录,并且获取录音数据的接口。主要包括: 第三方实时获取通话记录 第三方获取录音文件 第三方播放通话语音等三种数据集成接口。下面将详细介绍。2 .第三方实时获取通话记录当一通电话结束后,呼叫中心在1-2秒之内,会立即将通话记录通过HttPPOSt方式提交给第三方应用。第三方应用接收到数据后应该立即返回,此操作第三方不应该消耗过长时间,从而影响呼叫中心话单的
3、处理。.2.1.界面配置如上图所示:“CDR远程接收地址”此处填写第三方应用中接收CDR数据的链接;“CDR最短时间(秒)”是指小于此值的通话记录将被丢弃,如果填0,那么表示所有数据都会被提交;“是否允许第三方播放录音”表示是否允许第三方播放录音文件。是否校验提交结果,如果勾选则客户端接受到话单需要返回array(resulttrue)(result=true);.2.2.提交的数据系统提交的数据支持2种格式:1、采用标准JSON格式,推荐使用2、采用标准的PoSt(key/VaIUe对)提交第三方应用只需要采用普通的post即可以获取,每次提交一条通话记录。注意:系统具有重推机制。因此当地方
4、业务系统收到数据后,务必返回JSON字符串:result:true),否则系统将一直推送相同的数据。下表是提交的数据项列表:序D名称字段类型描述1calIerstring主叫号码2calledstring被叫号码3begin_timeint通话开始时间,时间戳格式,从格林威治时间1970年01月01日00时00分00秒起至现在的总秒数4end_timeint通话结束时间,时间戳格式,从格林威治时间1970年01月01日00时00分00秒起至现在的总秒数5durationint通话持续时间,从开始到结束的整个时间,单位为秒6faIking_timeint通话时长,可以以此判断电话是否接通7rin
5、g_timeint振铃时长8record_path录音存储路径9caIl_typestring通话类型:in表示呼入,OUt一呼出,1。-一内部分机通话10caIl_statestring通话最后挂断时,所处状态,route-表示路由,queue-表示在排队,ring-表示在振铃,bridged-表示接通后挂断,voicemaiI-表示进入了语音邮箱11trunkstring中继12uuidstringCDR的唯一标示13time_rangestring保留不用14hangupcausestring挂机原因15biIIgroupint计费组16in_bytesint本通话流入字节数17out_
6、bytesint本通话的流出字节数18forward_numberstring保留不用19queue_timeint排队时长20feedback_timeint满意度评分所花时间21hangupsidestring挂机方22caIl_statestring电话挂机最后位置,route-路由,ivr-1VR阶段,queue-排队,ring-振铃、bridged-接通23ivr_timeintIVR时长,单位为秒24xfer_typestring保留不用25forward_extnostring保留不用26auto_feedbackint是否为系统自动推送满意度,1是,其他不是27forward_
7、typestring保留不用28ts_queuestring进入队列时间,格式为yyyy-MM-ddHH:mm:ss29ts_ringstring坐席振铃时间,格式为yyyy-MM-ddHH:mm:ss30ts_bridgedstring坐席接通时间,格式为yyyy-MM-ddHH:mm:ss31ori_hangupsidestring保留不用32org_idint保留不用33ivr_idint保留不用34remote_ipstring保留不用35CjqUeUestring排队队列36hold_timeint保持时长37busyness_resuItstring保留不用38fail_tryss
8、tring保留不用39caller_encrypt_keystring保留不用40org_codestring机构编号(多职场模式下可用)41feedback_scoreint满意度评分42hangupcausestring挂断原因(物理线路原因)43ref_idstring拨打时带的业务id44cdr_typestring通话类型:voiCe-表示语音通话,fax-表示传真45errorNamestring保留不用46errorMsgstring保留不用47hangupcause_detaiIstring交换机内核给出的挂机原因48user_nostring工号49chargedoubIe计
9、费,保留不用50area_codestring号码所在地区码,保留不用51trunk_numberstring中继号码52miss_causestring未接电话原因53pause_timeint话后时长54fax_resuIt_codestring传真发送结果,代码表请查看下表仅限传真55fax_fiIestring传真文件路径仅限传真56fax_successstring传真是否发送成功,I-成功,O-不成功仅限传真57fax_image_pixel_sizeint传真像素仅限传真58fax_transferred_pagesint传真发送的页数仅限传真59fax_total_pagesi
10、nt传真总的页数仅限传真60fax_transfer_ratedoube传真传输速率仅限传真61xfer_history对象数组转接历史:格式为:,打,对象格式如2.3章节描述,此字段只有采用Json格式提交时,才能正常提交.2.3.转接历史对象描述:序号名称字段类型描述1calIerstring电话原始主叫2xfer_source_uuidstring电话原始UUid,对应于Cdr中的UUid3xfer_source_queuestring电话原始队列,转出队列4xfer_extnostring转接坐席5xfer_tostring转接的目标号码6uuidstring本次电话的唯一码7ts_s
11、tart_timestring开始转接时间,格式为yyyy-MM-ddHH:mm:ss8ts_ring_timestring转接目标号码振铃时间,为空表示没有振铃,格式为yyyy-MM-ddHH:mm:ss9ts_bridged_timestring转接目标号码应答时间,为空表示没有应答,格式为yyyy-MM-ddHH:mm:ss10ts_end_timestring转接结束时间,格式为yyyy-MM-ddHH:mm:ss11ring_timeint振铃时长12taIking_timeint振铃时长13file-pathstring转接录音路径.2.4.传真传输结果表代码代码描述-100对方不
12、是传真机0发送成功2Timedoutwaitingforinitialcommunication3Timedoutwaitingforthefirstmessage5TheHDLCcarrierdidnotstopinatimelymanner6FailedtotrainwithanyofthecompatibIemodems13Unexpectedmessagereceived14ReceivedbadresponsetoDCSortraining15ReceivedaDCNfromremoteaftersendingapage17ReceivedaDCNwhilewaitingforaDI
13、S20ReceivednoresponsetoDCSorTCF23InvaIidECMresponsereceivedfromtransmitter31TimerT2expiredwhilewaitingforfaxpage32TimerT2expiredwhilewaitingfornextfaxpage48Disconnectedafterpermittedretries49ThecaIIdroppedprematurely3 .第三方获取录音文件流要让第三方能够获取录音文件流,首先参考1.2.1章节,开启允许第三方播放录音文件。3J.根据refJd下载语音流1 .接口功能:用于根据ref_id下载语音通知所产生的录音。2 .调用链接http:ip/atstarCdr-CdrPlay/refplay?refid二拨打时传递的唯一编码(UUid)3 .data参数无4 .返回成功时,返回对应的语音流,失败时,返回JSon格式的错误信息.3.2.电话拨打录音下载接口1 .接口功能:用于根据录音路径下载录音。2 .调用链接http:ipatstar/Cdr-CdrPIay