SmartVoice融合通信平台整合说明.docx

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.调用方式错误!未定义书签。6. 第三方获取传真文件错误!未定义书签。.6.1.调用方式：错误!未定义书签。.6.2.数据返回错误!未定义书签。1通话记录整合1 .通话记录整合简介：通话记录整合是指第三方应用获取SmartVoice呼叫中心的通话记录，并且获取录音数据的接口。主要包括： 第三方实时获取通话记录 第三方获取录音文件 第三方播放通话语音等三种数据集成接口。下面将详细介绍。2 .第三方实时获取通话记录当一通电话结束后，呼叫中心在1-2秒之内，会立即将通话记录通过HttPPOSt方式提交给第三方应用。第三方应用接收到数据后应该立即返回，此操作第三方不应该消耗过长时间，从而影响呼叫中心话单的处理。.2.1.界面配置如上图所示：“CDR远程接收地址”此处填写第三方应用中接收CDR数据的链接；“CDR最短时间（秒）”是指小于此值的通话记录将被丢弃，如果填0,那么表示所有数据都会被提交；“是否允许第三方播放录音”表示是否允许第三方播放录音文件。是否校验提交结果，如果勾选则客户端接受到话单需要返回array("result"'true')("result"=>'true')；.2.2.提交的数据系统提交的数据支持2种格式：1、采用标准JSON格式，推荐使用2、采用标准的PoSt(key/VaIUe对)提交第三方应用只需要采用普通的post即可以获取，每次提交一条通话记录。注意：系统具有重推机制。因此当地方业务系统收到数据后，务必返回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通话时长，可以以此判断电话是否接通7ring_timeint振铃时长8record_path录音存储路径9caIl_typestring通话类型：in表示呼入，OUt一呼出，1。-一内部分机通话10caIl_statestring通话最后挂断时，所处状态，route-表示路由，queue-表示在排队，ring-表示在振铃，bridged-表示接通后挂断,voicemaiI-表示进入了语音邮箱11trunkstring中继12uuidstringCDR的唯一标示13time_rangestring保留不用14hangupcausestring挂机原因15biIIgroupint计费组16in_bytesint本通话流入字节数17out_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_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_trysstring保留不用39caller_encrypt_keystring保留不用40org_codestring机构编号（多职场模式下可用）41feedback_scoreint满意度评分42hangupcausestring挂断原因（物理线路原因）43ref_idstring拨打时带的业务id44cdr_typestring通话类型：voiCe-表示语音通话,fax-表示传真45errorNamestring保留不用46errorMsgstring保留不用47hangupcause_detaiIstring交换机内核给出的挂机原因48user_nostring工号49chargedoubIe计费，保留不用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_pagesint传真总的页数仅限传真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_start_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对方不是传真机0发送成功2Timedoutwaitingforinitialcommunication3Timedoutwaitingforthefirstmessage5TheHDLCcarrierdidnotstopinatimelymanner6FailedtotrainwithanyofthecompatibIemodems13Unexpectedmessagereceived14ReceivedbadresponsetoDCSortraining15ReceivedaDCNfromremoteaftersendingapage17ReceivedaDCNwhilewaitingforaDIS20ReceivednoresponsetoDCSorTCF23InvaIidECMresponsereceivedfromtransmitter31TimerT2expiredwhilewaitingforfaxpage32TimerT2expiredwhilewaitingfornextfaxpage48Disconnectedafterpermittedretries49ThecaIIdroppedprematurely3 .第三方获取录音文件流要让第三方能够获取录音文件流，首先参考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