翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# サードパーティーのアプリケーションからエージェントアクティビティを取り込んでエージェントのパフォーマンスを評価する
<a name="evaluations-external-activities"></a>

サードパーティーアプリケーションで完了したエージェントのアクティビティを Amazon Connect にインポートできます。これらのアクティビティは Amazon Connect のタスクとしてインポートされ、Amazon Connect で完了した作業とともに評価できます。これにより、品質管理を 1 つのアプリケーションで一元的に行えるようになります。

サードパーティーアプリケーションで完了したアクティビティ (アプリケーション処理やソーシャルメディアでのやり取りなど) を完了したタスクとしてインポートするには、[CreateContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateContact.html) API を使用します。こうしたアクティビティをインポートすると、パフォーマンス評価に関連する詳細をタスク属性として取り込むことができます。 Amazon Connect 管理ウェブサイトで作成されたタスクとは異なり、これらのインポートされたタスクは既に完了とマークされているため、外部アプリケーションでアクティビティを完了したエージェントに受け入れられる必要はありません。

マネージャーは、Amazon Connect のネイティブのやり取りやバックオフィスタスクとともに、これらの外部アクティビティを評価できます。これにより、マネージャーはエージェントのパフォーマンスを[エージェントパフォーマンス評価ダッシュボード](agent-performance-evaluation-dashboard.md)で一元的に確認できます。

## サードパーティーアプリケーションからアクティビティを取り込む方法
<a name="steps-for-it-admins"></a>

通常、次の手順は IT 管理者が行います。
+  評価の対象となるエージェントまたはバックオフィスワーカーは、Amazon Connect のユーザーでなければなりません。新しいユーザーを追加するには、「[ユーザーを に追加する Amazon Connect](user-management.md)」を参照してください。
+ [CreateContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateContact.html) API を使用して、これらのエージェントが完了したすべての外部アクティビティを、完了した Amazon Connect タスクとして Amazon Connect に取り込みます。

   次の項目を取り込むことができます。
  + サードパーティーアプリケーションで完了したすべてのアクティビティ (例えば、これらのアクティビティの完了によってトリガーされるものを含む)。これにより、エージェントのアクティビティを 1 つのアプリケーションで包括的に把握できます。
  + エージェントのパフォーマンス評価でサンプルとして使用する外部アクティビティの割合。

  以下は、別のシステムで完了したクレーム承認アクティビティを取り込むための API リクエストの例です。

  ```
  awscurl \
  --service connect \
  -X PUT \
  'https://connect.us-east-1.amazonaws.com/Prod/contact/create-contact' \
  --region us-east-1 \
  -d \
  '{
    "Channel":"TASK",
    "InstanceId":"8f3b9ab3-df68-4124-8573-2626b5c939ac", 
    "InitiationMethod":"API",
    "InitiateAs":"COMPLETED",
    "UserInfo": {"UserId": "arn:aws:connect:us-west-2:295154396770:instance/8f3b9ab3-df68-4124-8573-2626b5c939ac/agent/1c99b776-8e56-4aaa-a1bf-b950ffbe61e4"},
    "Name": "Processing Authorization #12345",
    "Description": "Customer Name: John Doe; Customer Condition: Asthma; Medication: Levocetrizin",
    "Attributes": {
      "Authorization": "12345",
      "ExternalContactType": "Authorization" 
    },
    "References": {
      "ThirdPartySystemURL": {
        "Type": "URL",
        "Value": "https://example.com/customer/12345"
      }
    }
  }'
  ```
+  属性内にアクティビティ情報を追加できます。この情報は、品質マネージャーがコンタクトを検索および評価する際に役立つ場合があります。例えば、前に示した API コールには、`ExternalContactType` というカスタム属性が含まれています。これにより、マネージャーはコンタクトの検索でさまざまなタイプの外部アクティビティを区別できます。

   コンタクトのリファレンスにサードパーティーシステムへのリンクを追加することもできます。このリンクを使って、マネージャーはタスクに含まれていない追加情報を参照できます。
+  マネージャーがこれらの属性を使用してアクティビティを検索できるようにするには、これらの属性による検索を有効にする必要があります。詳細については、「[カスタムのコンタクト属性またはコンタクトセグメント属性を使用して Amazon Connect でコンタクトを検索する](search-custom-attributes.md)」を参照してください。
**注記**  
この設定を行った後に作成されたタスクのみが、これらの属性を使用して検索できます。

## 外部アクティビティを評価する方法
<a name="steps-for-managers"></a>

通常、次の手順はマネージャーが行います。

 マネージャーは、Amazon Connect のネイティブのコンタクトを評価するのと同じ方法で、Amazon Connect に取り込まれたアクティビティを評価できます。詳細については、「[パフォーマンスを評価します。](evaluations.md)」を参照してください。

 管理者がカスタムのコンタクト属性による検索を設定している場合は、アクティビティのタイプや ID などの識別子を使って外部アクティビティを検索できます。

次の図は、`Attribute`が `ExternalContactType` の、`Completed`コンタクトの検索を示しています。

![\[属性が ExternalContactType の、完了したコンタクトの検索。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/evaluate-external-activities1.png)


次の図は、完了した外部コンタクトの [コンタクトの詳細] の例を示しています。この図で、次のようなことがわかります。
+ チャネルサブタイプ = connect:ExternalTask
+ 開始方法 = API
+ リファレンスには、サードパーティーシステムへの URL が含まれています。

![\[外部コンタクトのコンタクトの詳細。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/evaluate-external-activities2.png)