AgentList

以数组形式返回分配给业务单位的所有坐席（除非在属性中输入了特定的坐席 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 action在此操作之前，并且该操作的输出变量与 Agent List 操作属性的 SecurityUser 输入变量相匹配。

支持的脚本类型

通用	Email	聊天	电话	语音信箱	工作项目	短信

输入属性

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

属性	说明
Caption	输入在脚本中唯一标识此操作的短语。标题显示在脚本画布上的操作图标下方。The default is the action name.
SecurityUser	SetSecurityUser 操作的输出值，该操作会根据安全配置文件中的坐席权限对选定的坐席进行身份验证。此字段接受用花括号 ( { } ) 格式化的变量。默认值为 SecurityUser（与 SetSecurityUser 的默认输出值相同）。
AgentID	坐席 ID。您可以为该字段使用一个变量，例如 {agentId}。留空时，与业务单位关联的所有用户将以数组的形式返回。此字段接受变量。

输出属性

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

属性	说明
ListVar (out)	保存返回的数据。此变量的内容以数组形式存储。 默认变量为 Agents。

结果分支条件

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

条件	说明
Default	除了脚本满足条件要求其接受其他分支的情况之外，所要采用的路径。如果未定义操作的其他分支，也会执行此操作。
OnError	操作无法正确执行时所采用的路径。例如，出现连接不良、语法错误等意外问题时。_ERR 变量以单个下划线字符填充，应包含对问题的简要解释。

其他选项

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