本文为您介绍了坐席管理相关的接口说明。

接口列表

API名称 描述
CreateAgent 创建坐席
UpdateAgent 修改坐席
DeleteAgent 删除坐席
GetAgent 获取坐席
ListAgentBySkillGroupId 根据技能组获取坐席列表

CreateAgent

创建坐席账号,并返回坐席ID

请求参数

参数名称 类型 是否必填 描述
InstanceId String AICCS实例ID,在智能联络中心控制台上可以看到
AccountName String 账号名称,实例内唯一
DisplayName String 账号显示名称
SkillGroupIdLists List<Long> 坐席所属的技能组列表

返回数据

参数名称 类型 是否为空 描述
RequestId String 请求ID,用于跟踪错误原因
Success Boolean 接口调用是否成功
Data Long 坐席ID
Code String 错误编码
Message String 错误描述

UpdateAgent

修改坐席账号,目前仅支持修改显示名称

请求参数

参数名称 类型 是否必填 描述
InstanceId String AICCS实例ID,在智能联络中心控制台上可以看到
AccountName String 账号名称,实例内唯一
DisplayName String 账号显示名称
SkillGroupIdLists List<Long> 坐席所属的技能组列表

返回数据

参数名称 类型 是否为空 描述
RequestId String 请求ID,用于跟踪错误原因
Success Boolean 接口调用是否成功
Code String 错误编码
Message String 错误描述

DeleteAgent

删除坐席账号,逻辑删除,删除后重新添加,坐席ID不变

请求参数

参数名称 是否必填 描述
InstanceId AICCS实例ID,在智能联络中心控制台上可以看到
AccountName 账号名称,实例内唯一

返回数据

参数名称 类型 是否为空 描述
RequestId String 请求ID,用于跟踪错误原因
Success Boolean 接口调用是否成功
Code String 错误编码
Message String 错误描述

GetAgent

删除坐席账号,逻辑删除,删除后重新添加,坐席ID不变

请求参数

参数名称 是否必填 描述
InstanceId AICCS实例ID,在智能联络中心控制台上可以看到
AccountName 账号名称,实例内唯一

返回数据

参数名称 类型 是否为空 描述
RequestId String 请求ID,用于跟踪错误原因
Success Boolean 接口调用是否成功
Data JSONObject 坐席数据
Data.TenantId Long 坐席所属的租户ID,与入参中的实例ID一一对应
Data.AgentId Long 坐席ID
Data.AccountName String 坐席账号名称
Data.DisplayName String 坐席显示名称
Data.Status Integer 坐席状态,0:正常,1:冻结,2:删除。只有正常的状态,才可进行业务活动
Data.GroupList Array 坐席关联技能组信息
Code String 错误编码
Message String 错误描述

ListAgentBySkillGroupId

根据技能组ID获取坐席列表

请求参数

参数名称 是否必填 描述
InstanceId AICCS实例ID,在智能联络中心控制台上可以看到
SkillGroupId 技能组ID

返回数据

参数名称 类型 是否为空 描述
RequestId String 请求ID,用于跟踪错误原因
Success Boolean 接口调用是否成功
Data Array 坐席数据
Data.N.TenantId Long 坐席所属的租户ID,与入参中的实例ID一一对应
Data.N.AgentId Long 坐席ID
Data.N.AccountName String 坐席账号名称
Data.N.DisplayName String 坐席显示名称
Data.N.Status Integer 坐席状态,0:正常,1:冻结,2:删除。只有正常的状态,才可进行业务活动
Code String 错误编码
Message String 错误描述