AGENT LIST

返回分配给业务部门 用于管理CXone Mpower系统的技术支持、计费和全局设置的高级组织分组。的所有坐席，除非在包含每个坐席配置文件信息的数组中。 可以通过在 AgentID 属性中输入坐席 ID 来返回有关特定坐席的信息。 在 ListVar 参数中指定的变量中返回以下字段： • BusinessUnitID • UserName • MiddleName • Email • TeamId • ReportToId • ReportToMiddleName • IsSupervisor • LastModified • Custom1 • Custom3 • Custom5 • AgentID • FirstName • LastName • IsActive • TeamName • ReportToFirstName • ReportToLastName • LastLogin • Location • Custom2 • Custom4 • InternalId 您可以使用此操作来检查一个特定的坐席是否处于活动状态，找到坐席的电子邮件地址，检查他们属于哪个团队，或其他各种自定义选项。 坐席列表是您可以在 Studio 中使用的可用 API 之一。 您必须在您的业务单位上启用框架操作和权限，以便利用此操作。

依赖关系

• 始终确保 SetSecurityUser 操作在此操作之前，并且该操作的输出变量与 Agent List 操作属性的 SecurityUser 输入变量相匹配。

• 这是一个API作，位于API作选项板上。

支持的脚本类型

通用	电子邮件	聊天	电话	语音信箱	工作项目	短信

输入属性

这些属性定义操作在执行时使用的数据。

属性	说明
Add Caption	输入在脚本中唯一标识此操作的短语。 标题显示在脚本画布上的操作图标下方。
安全用户	SetSecurityUser 操作的输出值，该操作会根据安全配置文件中的坐席权限对选定的坐席进行身份验证。 此字段接受用大括号 （ { } ） 格式化的变量。 默认值为 SecurityUser（与 SetSecurityUser 的默认输出值相同）。
坐席 ID	坐席 ID。 您可以为该字段使用一个变量，例如 {agentId}。 如果为空，则会以数组形式返回与 租户 用于管理CXone Mpower系统的技术支持、计费和全局设置的高级组织分组。 相关联的所有用户。 在值模式下：输入坐席 ID 或单击加号 + 或减号 - 按钮添加 ID 编号。 在表达式模式下：输入坐席 ID。

输出属性

这些属性包含保存执行操作返回的数据的变量。 它们在操作完成后供引用和使用。

属性	说明
ListVar	保存返回的数据。 此变量的内容以数组形式存储。默认值为 Agents，但可以修改为任何需要的值。

结果分支条件

结果分支条件允许您在脚本中创建分支，以在执行操作时处理不同的结果。

条件	说明
Default	除了脚本满足条件要求其接受其他分支的情况之外，所要采用的路径。 如果未定义操作的其他分支，也会执行此操作。
成功	完成操作而无错误，且 API 调用或数据返回全部成功时所采用的路径（2xx 响应代码）。
InvalidAgentId	坐席 ID 无效时所采用的路径。
InvalidSecurityUser	使用无效的安全用户时所采用的路径。

其他选项

根据您想要获取的数据，其他 API 操作可能会有所帮助。 例如，All Agent Skill Assignments、Agent States V4、Get Agents List、Get Agent Details by Agent ID 等操作。