云客服-华为云

云客服-查询座席当前呼叫统计信息:报文样例

报文样例消息头 Content-Type:application/json; charset=UTF-8Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 请求参数无响应参数 { "message": "", "retcode": "0", "result": { "talktime": 4328, "answernums": 5, "noanswernums": 0, "calloutnums": 0, "intercallnums": 5, "interhelpnums": 0, "transfernums": 0, "transferoutnums": 0, "transferivrnums": 0, "redirectnums": 0, "keepnums": 0, "busynums": 0, "restnums": 0, "restoutnums": 0, "resttime": 0, "restouttime": 0, "agentrelease": 1, "busytime": 0 }}

云客服

云客服-查询座席当前呼叫统计信息:接口URI

接口URI https://ip:port/agentgateway/resource/calldata/{agentid}/statistics 其中，ip为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号。表1 URI中携带的参数说明序号参数名数据类型选取原则说明 1 agentid string True 座席的工号，取值范围：101～59999。

云客服

云客服-查询座席当前呼叫统计信息:响应说明

响应说明表3 消息体参数说明序号名称参数类型说明 1 message string 描述 2 retcode string 错误码。取值如下： 0：成功非0：失败 3 result object 查询成功后，返回座席当前呼叫统计信息对象。该对象的参数说明请参见表4。表4 result对象参数说明序号名称参数类型说明 3.1 talktime long 当日总通话时长，单位 s。 3.2 answernums int 当日接听次数 3.3 noanswernums int 当日久不应答次数 3.4 calloutnums int 当日外呼次数 3.5 intercallnums int 当日内部呼叫次数 3.6 interhelpnums int 当日内部求助次数 3.7 transfernums int 当日转接次数 3.8 transferoutnums int 当日转出次数 3.9 transferivrnums int 当日转IVR次数 3.10 redirectnums int 重定向的次数 3.11 keepnums int 保持次数 3.12 busynums int 示忙次数 3.13 restnums int 请假次数 3.14 restoutnums int 超假次数 3.15 resttime long 请假时长（秒） 3.16 restouttime long 超假时长（秒） 3.17 agentrelease int 主动释放数 3.18 busytime long 示忙时长（秒）

云客服

云客服-查询呼叫随路数据:接口URI

接口URI https://ip:port/agentgateway/resource/calldata/{agentid}/appdata?isEncodeResult={isEncodeResult}&callId={callId} 其中，ip为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号。表1 URI中携带的参数说明序号参数名数据类型选取原则说明 1 agentid string True 座席的工号，取值范围：101～59999。 2 isEncodeResult boolean False 查询到的呼叫数据是否经过base64编码。取值范围： true：查询到的呼叫数据经过了base64编码 false：查询到的呼叫数据没有经过base64编码 true以外的参数都作为false处理。说明： Base64是一种编码方式，不是加密算法，不能用作任何敏感信息的加密用途。 3 callid string False 被查询呼叫ID。多媒体会话时为必传。

云客服

云客服-预览外呼

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

云客服

云客服-对方振铃

对方振铃标示符 AgentEvent_Customer_Alerting 作用表示座席相关的其它用户正在发生振铃。附带信息 otherPhone: 字符串，用户的电话号码(内部呼叫时为被叫座席号)。 callid:呼叫标示。 type:呼叫类型，协助呼叫(assistant)和主呼叫(main)。触发条件准备通话的对方正在振铃。示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_Customer_Alerting","workNo":"49999","content":{"callid":"1456401416-3","otherPhoneWorkno":"","otherPhone":"70092","type":"main"}}} 父主题：音视频通话事件

云客服

云客服-座席自动应答

座席自动应答标示符 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_Conference 作用表示当前座席已进入三方通话状态。附带信息 partner：字符串，通话方电话，如"7101，7102"。 callid：呼叫标识。示例： {"message":"","retcode":"0","event":{"eventType":"AgentEvent_Conference","workNo":"49999","content":{"callid":"1456403570-17","partner":"49997，70093"}}} 父主题：音视频通话事件

云客服

云客服-内部呼叫失败

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

云客服

云客服-订阅语音识别结果接口通用返回结果码

订阅语音识别结果接口通用返回结果码结果码说明 0 调用配置接口成功 107-000 缓存登录信息失效，需要重新登录鉴权 107-001 调用配置接口抛了异常 107-002 输入参数不合法，必填字段为空 107-003 配置管理员密码错误，重试多次后锁定账号 107-004 无效配置管理员账号 107-005 配置接口通信失败 107-007 配置接口配置前鉴权失败 107-026 订阅失败异常 107-027 订阅登记失败异常 107-028 订阅请求失败异常 107-029 订阅请求超时异常 107-030 订阅异常 107-031 订阅注销失败异常 107-032 订阅握手失败异常 107-049 识别结果推送获取流程接入码失败异常码 107-050 识别结果推送获取servicetoken失败异常码 107-051 识别结果推送 servicetoken 无效异常码 107-052 识别结果推送失败异常码 107-053 识别结果推送请求异常码 107-054 识别结果推送请求超时异常码 107-055 ODFS 会话初始化异常码 107-056 ODFS 会话交互异常码 107-057 ODFS 断开连接异常码父主题：错误码定义

云客服

云客服-识别结果通知:接口URI

接口URI 呼叫中心平台调用识别结果通知接口的URI格式如下： {servicecallbackuri}/v100/subscribe/asrevent/asrresult其中，“servicecallbackuri”为注册的通知回调地址。例如：https://10.21.117.9:8043/agentgateway/resource/asrresult/v100/subscribe/asrevent/asrresult 第三方需要对该地址进行接收消息处理。

云客服

云客服-查询当前会话客户的最近历史接触记录（queryUserContactLimit）:报文样例

报文样例请求头： x-app-key:9******************************3 Authorization:Bearer 9******************************7 请求参数: {"callId": "1652317325-339","userId": "1652268429538866153","tenantId": "202205116084"} 响应参数: {"callSerialno": "1243353389979684865","countId": "1652268429538866153","callId": "1652317325-339","mediaAbility": 1,"channelType": 1,"talkReason": "1300404704098042886，1300404506395329541","beginTime": "2022-05-12 01:01:33","callType": 1}

云客服

云客服-查询当前会话客户的最近历史接触记录（queryUserContactLimit）:请求说明

请求说明表1 请求头参数序号名称参数类型是否必选说明 1 X-APP-Key string False appKey字段，用户标识 2 Authorization string True 鉴权字段，内容格式为：Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格）表2 请求体参数序号名称参数类型是否必选说明 1 callId string True 呼叫id 2 userId string True 用户id 3 tenantId string True 租户id

云客服

云客服-查询当前会话客户的最近历史接触记录（queryUserContactLimit）:响应说明

响应说明响应状态码: 200 表3 响应体参数序号名称参数类型是否必选说明 1 callSerialno string False 呼叫流水号 2 countId string False 账号 3 callId string False 呼叫ID 4 mediaAbility number False 媒体类别：1: 语音 2:视频 5 channelType number False 多媒体渠道 6 talkReason string False 会话原因ID 7 beginTime timestamp False 开始时间 8 callType number False 呼叫类型响应状态码: 400 错误的请求：请检查请求路径及参数。响应状态码: 401 未授权：1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。响应状态码: 404 请求的内容未找到：请检查请求的路径。响应状态码: 500 业务失败：请依次确认您请求中各参数的取值。

云客服

云服务器内容精选

云客服

7*24

备案

专业服务

退订

建议反馈

售前咨询热线