この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

AgentWork

エージェントに転送された割り当て作業を表します。このオブジェクトは、API バージョン 32.0 以降で使用できます。

サポートされているコール

create()、delete()、query()、getDeleted()、getUpdated()、retrieve()、undelete()

項目

項目 詳��
AcceptDatetime
型
dateTime
プロパティ
Filter、Nillable、Sort
説明
作業項目が受け入れられた日時を示します。
ActiveTime
型
int
プロパティ
Filter、Group、Nillable、Sort
説明
エージェントが作業項目に実際に取り組んだ時間。項目が開き、エージェントのコンソールでフォーカスが置かれていた時間を追跡します。
AgentCapacityWhenDeclined
型
double
プロパティ
Filter、Nillable、Sort
説明
エージェントが明示的に、または転送タイムアウトによって作業を拒否したときのエージェントの業務量。
AssignedDateTime
型
dateTime
プロパティ
Filter、Nillable、Sort
説明
作業項目がエージェントに割り当てられた日時を示します。
CancelDateTime
型
dateTime
プロパティ
Filter、Nillable、Sort
説明
作業項目がキャンセルされた日時を示します。
CapacityPercentage
型
percent
プロパティ
Create、Filter、Nillable、Sort
説明
エージェントの作業項目対応能力のうち、このサービスチャネルから生じた特定の種別の作業項目で消費される対応能力の割合。

エージェントの作業項目が合わせて 100% に達した場合、業務量に他の作業を受け入れられるだけの空きができるまで、エージェントは新しい作業項目を受け付けません。たとえば、エージェントは電話を受けると業務量が 100% に達するため、その通話が終了するまで新しい作業項目を受け付けません。

CapacityWeight
型
double
プロパティ
Create、Filter、Nillable、Sort
説明
エージェントの作業項目対応能力のうち、このサービスチャネルから生じた作業項目で消費されるエージェントの対応能力の量。

たとえば、ケースに業務量加重 2 が割り当てられている場合、業務量が 6 のエージェントは 3 個までケースを受け入れることができます。3 個で業務量が上限に達するため、新しい作業項目を受け付けられなくなります。

CloseDateTime
型
dateTime
プロパティ
Filter、Nillable、Sort
説明
作業項目が完了した日時を示します。
CreatedById
型
reference
プロパティ
Defaulted on create、Filter、Group、Sort
説明
このレコードを作成した User の ID。
CreatedDate
型
dateTime
プロパティ
Defaulted on create、Filter、Sort
説明
このレコードが作成された日時。
DeclineDatetime
型
dateTime
プロパティ
Filter、Nillable、Sort
説明
エージェントがこのレコードを拒否した日時。
DeclineReason
型
string
プロパティ
Filter、Group、Nillable、Sort
説明
エージェントが作業要求を拒否した場合に入力された理由。
HandleTime
型
int
プロパティ
Filter、Group、Nillable、Sort
説明
エージェントが作業項目をオープンにしていた時間。クローズ時間 – [承諾された時間] で計算されます。
Id
型
ID
プロパティ
Defaulted on create、Filter、Group、idLookup、Sort
説明
AgentWork オブジェクトの ID。
IsDeleted
型
boolean
プロパティ
Defaulted on create、Filter、Group、Sort
説明
レコードがごみ箱に移動されたか (true)、否か (false) を示します。
LastModifiedById
型
reference
プロパティ
Defaulted on create、Filter、Group、Sort
説明
このレコードを最後に変更したユーザの ID。
LastModifiedDate
型
dateTime
プロパティ
Defaulted on create、Filter、Sort
説明
ユーザがこのレコードを最後に変更した日時。
Name
型
string
プロパティ
Autonumber、Defaulted on create、Filter、idLookup、Sort
説明
レコードを識別する自動生成 ID 番号。
OriginalQueueId
型
reference
プロパティ
Filter、Group、Nillable、Sort
説明
作業割り当てが最初に転送されたキューの ID。
PushTimeout
型
int
プロパティ
Filter、Group、Nillable、Sort
説明
転送タイムアウトに設定された秒数。転送タイムアウトが無効な場合は 0 が返されます。API バージョン 36.0 以降で利用できます。
PushTimeoutDateTime
型
dateTime
プロパティ
Filter、Nillable、Sort
説明
転送タイムアウトイベントが発生した日時。API バージョン 36.0 以降で利用できます。
RequestDateTime
型
dateTime
プロパティ
Filter、Nillable、Sort
説明
作業が要求された日時を示します。
ServiceChannelId
型
reference
プロパティ
Create、Filter、Group、Sort
説明
作業割り当てに関連付けられているサービスチャネルの ID。
ShouldSkipCapacityCheck
型
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort
説明
外部転送作業項目が作成されるときに、エージェントが対応可能な業務量のチェックをスキップするか (true)、否か (false) を示します。この項目は、オムニチャネルキューと外部ルーティングを使用したキューの両方の作業をエージェントが同時に処理できる場合に使用します。
true の場合、受け入れ先エージェントは設定された業務量を超えてその項目を受け入れ可能ですが、オムニチャネルで転送されたその他の作業を受け入れることはできません。false の場合、受け入れ先エージェントは設定された業務量を超えることはできず、その項目を受け入れるために十分な業務量の空きが必要です。
SpeedToAnswer
型
int
プロパティ
Filter、Group、Nillable、Sort
説明
作業が要求されてからエージェントが受け入れるまでの時間。
Status
型
picklist
プロパティ
Filter、Group、Restricted picklist、Sort
説明
作業項目の処理状況。有効な値は、次のとおりです。
  • Assigned – 項目がエージェントに割り当てられていますが、まだオープンされていません。
  • Opened – エージェントが項目をオープンしました。
  • Unavailable – 項目がエージェントに割り当てられましたが、エージェントが対応できません (オフラインになっている場合や、接続が失われた場合など)
  • Declined – 項目がエージェントに割り当てられましたが、エージェントが明示的に拒否しました。
  • DeclinedOnPushTimeout – 転送タイムアウトが有効で、エージェントへの項目要求がタイムアウトしたため、項目が拒否されました。
  • Closed – 項目が完了しています。
  • Canceled – 項目を転送する必要がなくなりました。たとえば、チャット訪問者がオムニチャネルで転送されるチャット要求を、エージェントに到達する前にキャンセルした場合などです。
  • Transferred – この項目はエージェントから別のエージェント、キュー、またはスキルに転送されました。
SystemModstamp
型
dateTime
プロパティ
Defaulted on create、Filter、Sort
説明
このレコードがユーザまたは自動化されたプロセス (トリガなど) によって最後に更新された日時。このコンテキストでは、「トリガ」は、標準機能を実装するために実行する Salesforce コードを意味します。Apex トリガではありません。
UserId
型
reference
プロパティ
Create、Filter、Group、Sort
説明
作業項目が割り当てられたユーザの ID。
WorkItemId
型
reference
プロパティ
Create、Filter、Group、Sort
説明
オムニチャネルを通じてエージェントに転送されたオブジェクトの ID。

使用方法

AgentWork レコードは、状況が Closed、Declined、または Unavailable の場合にのみ削除できます。状況が Assigned または Opened の場合は、Omni-Channel で有効であるため、削除できません。

AgentWork レコードの作成時、状況は Assigned に設定されます。作成後、レコードは割り当てられたエージェントに自動的に転送されます。

AgentWork のメタデータは、upsert() と update() のサポートを示していますが、更新できる項目がないため、これらのコールは AgentWork では使用されません。

AgentWork では Apex トリガはサポートされていません。