AgentList

This help page is for Desktop Studio.This information is also available for CXone Studio.

ビジネスユニットに割り当てられたすべてのエージェントを返します(特定のエージェント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つです。このアクションを利用するには、事業単位でフレームワークアクションと権限を有効にする必要があります。

依存関係

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

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

The icon for a Generic script type - a rectangle with < and > symbols inside it.

The icon for the Email script type - a large @ symbol in a diamond.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

一般

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

入力プロパティ

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

プロパティ

説明

Caption

スクリプト内でこのアクションを一意に識別できる、短いフレーズを入力します。アクションアイコンにカーソルを合わせるとキャプションが表示されます。The default is the action name.

SecurityUser セキュリティプロファイルの権限に基づいて選択したエージェントを認証するSetSecurityUserアクションの出力値。このフィールドは中括弧({ })でフォーマットされた変数を受け入れます。デフォルト値はSecurityUserSetSecurityUserと同じデフォルト出力値)です。
AgentID エージェントID。このフィールドには{agentId}などの変数を使用できます。空白の場合、ビジネスユニットに関連付けられているすべてのユーザーが配列で返されます。このフィールドは変数を受け入れます。

出力プロパティ

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

プロパティ

説明

ListVar (out) 返されたデータを保持します。この変数の内容は配列として格納されます。デフォルトの変数はAgentsです。

結果ブランチ条件

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

条件

説明

Default

スクリプトが他のブランチのいずれかを取る必要がある条件を満たさない限り、パスが取られます。他のブランチが定義されていない場合にも使用されます。

OnError

アクションが正しく実行されなかったときにとられるパス。これは例えば、接続不良、構文エラーなど予期しない問題が発生した場合などです。_ERR変数に1つのアンダースコア文字がある場合、問題の簡潔な説明を入力する必要があります。

別のオプション

取得したいデータによっては、追加のフレームワークAPIアクションが役に立つかもしれない。例:All Agent Skill AssignmentsAgent States V4Get Agents ListGet Agent Details by Agent IDなど。