华为云用户手册

保持成功 标示符 AgentEvent_Hold 作用 表示当前座席已处于保持状态。 附带信息 content：文本型，呼叫所属于的CallId（呼叫标示）。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_Hold","workNo":"49999","content":"1456402370-7"}} 父主题： 音视频通话事件

客户退出呼叫 标示符 AgentEvent_Customer_Release 作用 表示客户从指定的callId呼叫中退出。 附带信息 callid：呼叫的CallID。 number：挂断者的电话。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_Customer_Release","workNo":"49999","content":{"callid":"1456404171-43","number":"70093"}}} 父主题： 音视频通话事件

外呼失败 标示符 AgentEvent_Call_Out_Fail 作用 座席发起外呼呼叫失败，可能失败的原因为电话号码不对等。 附带信息 字符串：呼叫的CallID。 触发条件 座席发起外呼失败。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_Call_Out_Fail","workNo":"49999","content":"1456403661-19"}} 父主题： 音视频通话事件

外呼失败检测失败原因 标示符 OUTBOUND_DETECT_EVENT 作用 座席接收到外呼失败原因码，以及失败原因。 附带信息 callid：呼叫标识。 detect：外呼失败原因码。准确度依赖于核心网，或对接网关返回信令中的原因码，详情请参见表3。 desc：外呼失败原因描述。 示例： {"message":"success","event":{"eventType":"OUTBOUND_DETECT_EVENT","workNo":"464","content":{"callId":"1589167025-134428","detect":1552,"desc":"The calling number is not allowed to make a call."}},"retcode":"0"} 父主题： 音视频通话事件

内部呼叫失败 标示符 AgentEvent_Inside_Call_Fail。 作用 座席发起内部呼叫已经失败。 附带信息 content：呼叫的CallID。 触发条件 内部呼叫失败。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_Inside_Call_Fail","workNo":"49999","content":"1456403699-21"}} 父主题： 音视频通话事件

座席退出呼叫 标示符 AgentEvent_Call_Release 作用 表示座席从指定callId的呼叫中退出。 附带信息 content：呼叫的CallID。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_Call_Release","workNo":"49999","content":"1456403549-15"}} 父主题： 音视频通话事件

座席自动应答 标示符 AgentEvent_Auto_Answer 作用 座席自动应答呼叫。 附带信息 caller：文本型，主叫号码。 called：文本型，被叫号码。 callid：文本型，呼叫所属于的CallId（呼叫标示）。 type：文本型，协作呼叫(assistant)或主呼叫(main)。 feature：呼叫类型，例如0普通呼入，7普通外呼，43预测外呼。feature与callid关联，不会随转移等动作改变。 mediaAbility：媒体能力，1表示语音，2表示视频，3表示音视频，5表示文字，6表示H5视频。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_Auto_Answer","workNo":"49999","content":{"caller":"70093","transfer":"no","callid":"1456404171-43","transfrom":"","called":"6048","type":"main","mediaAbility":"1","feature":"0"}}} 父主题： 音视频通话事件

连接失败 标示符 AgentEvent_Connect_Fail 作用 座席连接失败。 附带信息 content：文本型，呼叫所属于的CallId（呼叫标示）。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_Connect_Fail","workNo":"49999","content":"1456404043-38"}} 父主题： 音视频通话事件

咨询失败 标示符 AgentEvent_Consult_Fail 作用 座席内部求助咨询失败。 附带信息 content：文本型，呼叫所属于的CallId（呼叫标示）。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_Consult_Fail","workNo":"49999","content":"1456404043-39"}} 父主题： 音视频通话事件

座席来电提醒 标示符 AgentEvent_Ringing 作用 座席来电提醒，提醒用户需要手工应答呼叫。 附带信息 caller：文本型，主叫号码，如果为座席，则首字符为a或者A。 called：文本型，被叫号码，如果为座席，则首字符为a或者A。 callid：文本型，呼叫所属于的CallId（呼叫标示）。 type：文本型，协作呼叫(assistant)或主呼叫(main)。 feature：呼叫类型，例如0普通呼入，7普通外呼。 mediaAbility：媒体能力，1表示语音，2表示视频，3表示音视频，5表示文字，6表示H5视频。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_Ringing","workNo":"49999","content":{"caller":"49997","transfer":"no","callid":"1456404043-37","transfrom":"","called":"49999","type":"main","mediaAbility":"1","feature":"0"}}} 父主题： 音视频通话事件

取消示忙成功 标示符 AgentState_CancelNotReady_Success 作用 表示某个座席取消示忙成功。 附带信息 无。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentState_CancelNotReady_Success","workNo":"49997","content":null}} 父主题： 座席状态类事件

从IVR返回 标示符 AgentEvent_ReturnFromIvr 作用 音视频呼叫的转移场景中，座席调用转移接口，选择转移设备类型为IVR，转移模式为挂起转进行呼叫转移，转移成功后呼叫从IVR返回到座席时，座席会收到该事件表示从IVR返回成功。 附带信息 content：文本型，呼叫所属于的CallId（呼叫标示）。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_ReturnFromIvr","workNo":"108","content":"1529571145-1187"}}} 父主题： 音视频通话事件

座席久不应答 标示符 AgentEvent_No_Answer 作用 座席久不应答，呼叫挂断通知事件。 附带信息 content：呼叫的CallID。 触发条件 通知座席对于手工应答的呼叫请求，已经挂断。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_No_Answer","workNo":"49999","content":"1456403745-23"}} 父主题： 音视频通话事件

成功转结果通知 标示符 AgentEvent_SuccTransResult 作用 音视频呼叫或文字的转移场景中，座席成功调用转移接口进行成功转时，座席会收到该事件表示成功转是否成功。（语音成功转外部电话时，没有该事件） 附带信息 callId表示呼叫唯一标记。 result表示成功转结果。0表示成功，其他表示失败。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_SuccTransResult","workNo":"20011","content":{"result":1,"callId":"1477467960-16777237"}}} 父主题： 音视频通话事件

预览外呼 标示符 AgentEvent_Preview_CallOut 作用 座席接收到预览外呼（预览呼出的电话号码长度是24）。 附带信息 controlid：预览呼出控制块号。 dialeddigits：预览呼出被叫号码。 callData：随路数据，最大长度16k。 示例： { "message":"", "retcode":"0", "event":{ "eventType":"AgentEvent_Preview_CallOut", "workNo":"49999", "content":{ "controlid":"0", "dialeddigits":"1456404043", "callData":"xxxxxx" } } } 父主题： 外呼相关

新预览外呼 标示符 AgentEvent_Preview_CallOut_Ex 作用 座席接收到新预览外呼（预览呼出的电话号码长度是120）。 附带信息 controlid：预览呼出控制块号。 dialeddigits：预览呼出被叫号码。 callData：随路数据，最大长度16k。 示例： { "message":"", "retcode":"0", "event": {"eventType":"AgentEvent_Preview_CallOut_Ex", "workNo":"49999", content:{ "dialeddigits":"100,101,103,105", "controlid":"1536", "callData":"4" } } } 父主题： 外呼相关

预览发起 标示符 AgentEvent_Preview 作用 座席接收到预览发起。 附带信息 controlid：预览呼出控制块号。 dialeddigits：预览呼出被叫号码。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_Preview","workNo":"49999","content":{"controlid":"1456404043","dialeddigits":""}}} 父主题： 外呼相关

音视频切换 标示符 AgentEvent_MediaSwith 作用 音频呼叫切换视频呼叫场景中，座席调用音视频切换接口，选择媒体类型为视频，调用成功后呼叫从音频切换到视频时，座席会收到该事件，reason为0时表示从IVR返回成功。 附带信息 reason表示切换原因码，0代表成功，其余为失败。 caller表示主叫号码。 called表示被叫号码。 callId表示呼叫唯一标记。 mediaType表示媒体类型。 示例： {"eventType":"AgentEvent_MediaSwith","workNo":"111","content":{"callid":"1603286369-16773","reason":0,"caller":"","mediaType":3,"called":"88022","jsonKey":["callid","reason","caller","mediaType","called"]},"jsonKey":["eventType","workNo","content"]} 父主题： 音视频通话事件

录音开始 标示符 AgentMediaEvent_Record 作用 当前座席录音开始。 附带信息 taskId表示平台内部的录音任务号。 caller表示主叫号码。 called表示被叫号码。 locationId表示录音对应的中心节点ID。 recordID表示录音流水号。 fileName表示录音文件地址。 callId表示呼叫唯一标记。 fileMediaType表示媒体类型，1是音频，2视频。 示例： 音频： {"message":"","retcode":"0","event":{"eventType":"AgentMediaEvent_Record","workNo":"20011","content":{"taskId":5206,"caller":"70006","recordID":"Yc1v6a20011d20161025t1902050","called":"60015","locationId":"256","fileName":"Y:/6/0/20161025/20011/1902050.V3","fileMediaType":"1","callId":"1477393325-164"}}} RSE视频录制： {"eventType":"AgentMediaEvent_Record","workNo":"25002","content":{"recordID":"0a08082d-df1e-4c06-9a97-c7c6f7a4724e","callId":"1606459553-176","fileName":"conferenceId=7a008307-34ad-435b-bccd-222be5ac5385;recordId0=0a08082d-df1e-4c06-9a97-c7c6f7a4724e;","caller":"25002","called":"22061","locationId":"255","taskId":5065,"fileMediaType":2,"jsonKey":["recordID","callId","fileName","caller","called","locationId","taskId","fileMediaType"]},"jsonKey":["eventType","workNo","content"]} 第三方视频录制： {"eventType":"AgentMediaEvent_Record","workNo":"503","content":{"recordID":"Yc1v1a503d20201202t1714442.","callId":"1606900483-31","fileName":"Y:/1/0/20201202/503/1714442.mp4","caller":"83110091","called":"94865001","locationId":"65535","taskId":5007,"fileMediaType":2,"jsonKey":["recordID","callId","fileName","caller","called","locationId","taskId","fileMediaType"]},"jsonKey":["eventType","workNo","content"]} 父主题： 录音事件

录音播放停止 标示符 AgentMediaEvent_StopPlayDone 作用 录音被停止播放。 附带信息 cause表示停止播放的原因。0：正常播放结束；1：座席主动停止播放；2：录音播放失败而停止播放。 示例 {"message":"","retcode":"0","event":{"eventType":"AgentMediaEvent_StopPlayDone","workNo":"49999","content":{"cause":0}}} 父主题： 质检放音事件

录音开始失败 标示符 AgentMediaEvent_Record_Fail 作用 当前座席录音开始失败。 附带信息 taskId表示平台内部的录音任务号。 caller表示主叫号码。 called表示被叫号码。 locationId表示录音对应的中心节点ID。 recordID表示录音流水号。 fileName表示录音文件地址。 callId表示呼叫唯一标记。 fileMediaType表示媒体类型，1是音频，2视频。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentMediaEvent_Record_Fail","workNo":"20011","content":{"taskId":5255,"caller":"70006","recordID":"Cc1v6a20011d20161025t1930326","called":"60015","locationId":"65535","fileName":"C:/6/0/20161025/20011/1930326.V3","fileMediaType":"1","callId":"1477395030-183"}}} 父主题： 录音事件

停止录音成功 标示符 AgentMediaEvent_StopRecordDone 作用 座席停止录音成功。 附带信息 beginTime：录音开始时间。 endTime：录音结束时间。 taskId表示平台内部的录音任务号。 fileMediaType表示媒体类型，1是音频，2视频。 示例： {"eventType":"AgentMediaEvent_StopRecordDone","workNo":"1115","content":{"beginTime":1566867437000,"endTime":1566867472000,"fileMediaType":"1","taskId":5451,"jsonKey":["beginTime","endTime","taskId"]},"jsonKey":["eventType","workNo","content"]} 父主题： 录音事件

座席物理话机摘机 标示符 AgentOther_PhoneOffhook 作用 表示某个座席的物理话机已经摘机。 附带信息 type表示事件呼叫类型。unknown表示未知呼叫，main表示主呼叫，assistant表示协助呼叫。 示例： {"message":"","retcode":"0","event":{"eventType": "AgentOther_PhoneOffhook","workNo": "56020","content": {"type": "main"}}} 父主题： 物理话机事件

容灾事件 标示符 Agent_Recover 作用 表示当前座席在CC-Gateway发生重启后容灾恢复完成。 附带信息 无。 示例： {"message":"","retcode":"0","event":{"eventType":"Agent_Recover","workNo":"49999","content":{"agentStatus":"4"}}} 收到该事件，表示CC-Gateway发生了异常切换，该切换过程中，当前呼叫的部分接口调用和事件有影响，对下一通来话无影响。 具体的影响场景有： 两方求助、三方求助 (求助到队列、座席、外部号码)，会缺少AgentEvent_Call_Release和AgentEvent_Customer_Release、AgentEvent_Talking等事件。 成功转、通话转、三方转等场景，缺少部分AgentEvent_Call_Release、AgentEvent_Customer_Release、AgentEvent_Talking、AgentEvent_Call_Release等事件。 恢复措施： 挂断座席电话（软电话、固话，或手机）。 座席手工签出，再签入。 父主题： 事件

监视座席通知事件 表示符 QC_AgentState_Notify 作用 表示某个座席的监视（质检）事件。 附带信息 agentname：表示座席工号或用户名。 subtype：子类型，表示被监视座席的状态或操作。 示例： {"eventType":"QC_AgentState_Notify","workNo":"107","content":{"subtype":"QC_AgentState_Login","monitoredagent":"108","agentname":"108","mediaserver":"CtiServer","jsonKey":["subtype","monitoredagent","agentname","mediaserver"]},"jsonKey":["eventType","workNo","content"]} 其中subtype的类型有： QC_AgentState_Login:监视座席签入事件 QC_AgentState_Logout:监视座席签出事件。 父主题： 实时质检事件

座席签出成功 标示符 AgentOther_ShutdownService 作用 表示某个座席签出成功 附带信息 loginTime：登录时间。 示例： {"message":"","retcode":"0","event":{"eventType":"AgentOther_ShutdownService","workNo":"49999","content":{"loginTime":"1471585949806"}}} 父主题： 其它座席相关事件

多媒体消息事件 标示符 AgentEvent_MessageData 作用 表示座席接收多媒体会话上行消息 附带信息 workNo：座席号。 content：消息对象，JSON格式。包含字段如下： callid：呼叫标示。 caller：主叫号码。 called：被叫号码。 feature：呼叫类型，例如0普通呼入，7普通外呼。 type：呼叫媒体类型，协助呼叫(assistant)和主呼叫(main)。 message：发送的消息内容。 mediaAbility：媒体能力，1表示语音，2表示视频，3表示音视频，5表示文字，6表示H5视频。 示例： {"eventType":"AgentEvent_MessageData","workNo":"211","content":{"callid":"1552038964-16797222","caller":"88880022","called":"20012","feature":0,"type":"main","message":"testmessage","mediaAbility":"5","jsonKey":["callid","caller","called","feature","type","message","mediaAbility"]},"jsonKey":["eventType","workNo","content"]} 父主题： 多媒体事件

座席状态说明 表1 CCGateway状态 状态值 说明 0 未知。对应CTI平台状态的9。 1 签入状态。未使用。 2 签出状态。对应CTI平台状态的0。 3 示忙状态。对应CTI平台状态的7。 4 空闲状态。对应CTI平台状态的1。 5 整理态。对应CTI平台状态的6。 6 同空闲态。未使用。 7 通话态。对应CTI平台状态的2、3、4、5。 8 休息状态。对应CTI平台状态的8。 9 预休息状态。 表2 CTI平台状态 值 说明 0 未签入状态 1 空闲状态 2 预占用状态 3 占用状态 4 应答状态 5 通话状态 6 事后调整 7 示忙状态 8 休息状态 9 学习状态 表3 座席状态表 值 说明 1 空闲状态 2 整理态 3 休息态 4 示忙 5 放音 6 外呼 7 占用 8 请求应答 9 通话态 10 3方通话 11 保持 12 静音 13 求助 14 通话转 15 插入 16 监听 17 耳语 255 异常状态 父主题： 附录

设备类型 表1 设备类型 类型编号 类型描述 1 技能队列 2 座席工号 3 IVR 表2 自定义设备类型 类型编号 类型描述 0 未知 1 普通电话 2 无线数字设备 3 无线模拟设备 4 短波 5 手机 6 座席 7 eLTE 表3 自定义设备呼叫类型 类型编号 类型描述 0 常规呼叫 1 组呼 2 秘密呼叫，即点呼 表4 转移模式说明 定义 含义 释放转 不管呼叫转移/转出是否成功，业务代表均释放呼叫 成功转 系统监视呼叫转移/转出过程，成功后业务代表才释放呼叫 通话转 系统监视呼叫转出过程，被叫应答并和业务代表通话，业务代表释放呼叫 三方转 系统监视转出过程，被叫应答后实现三方通话，业务代表释放呼叫 挂起转 将呼叫转移到某自动流程，该流程处理完呼叫后将呼叫转回原座席继续处理 父主题： 附录

报文样例 请求头: x-app-key:9******************************3 Authorization:Bearer e******************************e Content-Type:application/json 请求参数: {"id":"1307145259662215169","callType":"1","userId":"10gg000000y6OOrNaUFs","callerPresent":["12323"],"callNumber":["12323","232343","233","239343"],"callNumberDefault":"23232323","callerPresentDefault":"1212121212"} 响应头: {"connection": "keep-alive","content-type": "application/json;charset=UTF-8"} 响应参数: {"returnCode": "0","returnDesc": "update success.","id": "1307145259662215169"}