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 このアクションを使用して、特定のエージェントがアクティブかどうかを確認したり、エージェントのEメールアドレスを見つけたり、所属するチームを確認したり、その他のさまざまなカスタムオプションを確認したりできます。 エージェントリストは、Studio内で使用できるAPIの1つです。 このアクションを利用するには、事業単位でフレームワークアクションと権限を有効にする必要があります。

依存関係

• SetSecurityUserアクションがこのアクションの前にあり、そのアクションの出力変数がアクションプロパティのSecurityUser入力変数Agent Listと一致していることを常に確認してください。

• これはAPIアクションで、APIアクションパレットにあります。

サポートされているスクリプトタイプ

一般	Eメール	チャット	電話	ボイスメール	ワークアイテム	SMS

入力プロパティ

これらのプロパティは、アクションが実行時に使用するデータを定義します。

プロパティ	説明
Add Caption	スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。 アクションアイコンにカーソルを合わせるとキャプションが表示されます。
Security User (セキュリティユーザー)	セキュリティプロファイルの権限に基づいて選択したエージェントを認証するSetSecurityUserアクションの出力値。 このフィールドは、中括弧({ })でフォーマットされた変数を受け入れます。 デフォルト値はSecurityUser（SetSecurityUserと同じデフォルト出力値）です。
エージェントID	エージェントID。 このフィールドには{agentId}などの変数を使用できます。空白の場合、テナント CXone Mpowerシステムのテクニカルサポート、請求、およびグローバル設定の管理に使用される高レベルの組織グループ。に関連するすべてのユーザーが配列で返されます。 値モード：エージェントIDを入力するか、プラス(+)またはマイナス(-)タンをクリックしてID番号を追加します。 式モードエージェントIDを入力します。

出力プロパティ

これらのプロパティには、実行したアクションから返されたデータを保持する変数が含まれています。 これらはアクションが完了したときに参照・使用することができます。

プロパティ	説明
ListVar (リスト変数)	返されたデータを保持します。 この変数の内容は配列として格納されます。デフォルト値は「Agents」ですが、任意の値に変更できます。

結果分岐条件

結果の分岐条件を使用すると、アクションが実行されたときにさまざまな結果を処理できるように、スクリプトにブランチを作成できます。

条件	説明
Default	スクリプトが他のブランチのいずれかを取る必要がある条件を満たさない限り、パスが取られます。 他のブランチが未定義の場合にも使用されます。
成功	アクションがエラーなしで完了し、API呼び出しまたはデータの戻りが成功した場合に実行されるパス(2xx応答コード)。
InvalidAgentId (無効なエージェントID)	エージェントIDが無効な場合に使用されるパス。
InvalidSecurityUser (無効なセキュリティユーザー)	無効なセキュリティユーザーが使用されたときに取られるパス。

その他のオプション

取得したいデータに応じて、追加のAPIアクションが役に立つ場合があります。 たとえば、All Agent Skill Assignments、Agent States V4、Get Agents List、Get Agent Details by Agent IDなどがあります。