

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

# EventBridge イベントを生成するルールを作成する
<a name="contact-lens-rules-eventbridge-event"></a>

リアルタイムまたは通話後/チャット後にイベントを受け取り、それを使用して事後の通知やアラートをトリガーしたり、Amazon Connect 以外のレポートを集約したりできます。このデータは多くのことに利用できます。例: 
+ QuickSight ダッシュボードでのリアルタイムアラートの取得。
+ Amazon Connect の外部で集計したレポートの作成。
+ CRM によるデータの結合。
+ 通知ソリューションを EventBridge に接続し、特定の種類のすべてのイベントが、一日の終了時点で、それぞれ対応する受信トレイに確実に送られるようにします。ペイロードからは、コンタクト、エージェント、およびキューを知ることができます。

**注記**  
 リアルタイムメトリクスルールの場合、ルールをトリガーするリソースは**リソース**の下に一覧表示されます。たとえば、平均キュー応答時間などのキューメトリクスをアラートするルールを作成すると、しきい値を超えたキューのリストがリソースに表示されます。

**EventBridge イベントを生成するルールを作成する**

1. ルールの作成時、アクションとして [**EventBridge イベントの生成**] を選択します。  
![\[[新しいルール] ページ、[これらのアクションを実行] セクション、[アクションを追加] ドロップダウンリスト、[EventBridge イベントを生成] アクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/contact-lens-rules-events-example1.png)

1. [**アクション名**]に、イベントペイロードの名前を入力します。
**注記**  
[**アクション名**] に割り当てた値は、EventBridge ペイロードに表示されます。イベントの集約時、このアクション名によって、イベントを処理するための追加のディメンションが提供されます。例えば、カテゴリ名が 200 個あり、その中で特定のアクション名 (NOTIFY\$1CUSTOMER\$1RETENTION など) を持つものが 50 個しかないということがあります。  
![\[[これらのアクションを実行] セクション、[コンタクトカテゴリの割り当て] セクション、[EventBridge イベントを生成] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/contact-lens-rules-add-eb-action.png)

1. **[次へ]** を選択します。確認後、[**保存**] をクリックします。

1. 追加されたルールは、その後に発生する新しい通話に対して適用されます。ルールは、Amazon Connect 会話分析が会話を分析するときに適用されます。

   過去に保存された会話にルールを適用することはできません。

1. EventBridge データの活用のために、EventBridge イベントタイプにサブスクライブします。下記の手順を参照してください。

## EventBridge イベントタイプにサブスクライブする
<a name="subscribe-eb-eventtype"></a>

EventBridge イベントタイプにサブスクライブするには、次の条件を満たすカスタム EventBridge ルールを作成します。
+ "source" = "aws.connect"
+ "detail-type" = "Contact LensPost Call Rules Matched" または次のいずれか:
  + **Contact Lens 一致するリアルタイムルール**
  + **Contact Lens 一致するリアルタイムチャットルール**
  + **Contact Lens チャット後のルールが一致**
  +  **Contact Lens 一致する評価ルール**
  + **メトリクスルールが一致**

次の画像は、[新しいルール] ページの [イベントパターン] セクションにあるこれらの設定を示しています。

![\[[新しい EventBridge ルール] ページの [イベントパターン] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/contact-lens-eb-rules-events.png)


### EventBridge ペイロードの例
<a name="eb-payload"></a>

以下は、**Contact Lens[Post Call Rules Matched]** が選択されている場合の、EventBridge ペイロードの表示例です。

```
{
 "version": "0", // set by EventBridge
 "id": "aaaaaaaa-bbbb-cccc-dddd-bf3703467718", // set by EventBridge
 "source": "aws.connect",
 "detail-type": "Contact Lens Post Call Rules Matched", 
 "account": "your AWS account ID",
 "time": "2020-04-27T18:43:48Z",
 "region": "us-east-1", // set by EventBridge
 "resources": ["arn:aws:connect:us-east-1:your AWS account ID:instance/instance-ARN"],
 "detail": {
    "version": "1.0",
    "ruleName": "ACCOUNT_CANCELLATION", // Rule name
    "actionName": "NOTIFY_CUSTOMER_RETENTION",  
    "instanceArn": "arn:aws:connect:us-east-1:your AWS account ID:instance/instance-ARN",
    "contactArn": "arn:aws:connect:us-east-1:your AWS account ID:instance/instance-ARN/contact/contact-ARN",
    "agentArn": "arn:aws:connect:us-east-1:your AWS account ID:instance/instance-ARN/agent/agent-ARN",
    "queueArn": "arn:aws:connect:us-east-1:your AWS account ID:instance/instance-ARN/queue/queue-ARN",
    }
}
```

以下は、**[Contact Lens Realtime Rules Matched]** が選択されている場合のペイロードの表示例です。

```
{
 "version": "0", // set by EventBridge
 "id": "aaaaaaaa-bbbb-cccc-dddd-bf3703467718", // set by EventBridge
 "source": "aws.connect",
 "detail-type": "Contact Lens Realtime Rules Matched", 
 "account": "your AWS account ID",
 "time": "2020-04-27T18:43:48Z",
 "region": "us-east-1", // set by EventBridge
 "resources": ["arn:aws:connect:us-east-1:your AWS account ID:instance/instance-ARN"],
 "detail": {
     "version": "1.0",
     "ruleName": "ACCOUNT_CANCELLATION", // Rule name
     "actionName": "NOTIFY_CUSTOMER_RETENTION",
      "instanceArn": "arn:aws:connect:us-east-1:your AWS account ID:instance/instance-ARN",
     "contactArn": "arn:aws:connect:us-east-1:your AWS account ID:instance/instance-ARN/contact/contact-ARN",
     "agentArn": "arn:aws:connect:us-east-1:your AWS account ID:instance/instance-ARN/agent/agent-ARN",
     "queueArn": "arn:aws:connect:us-east-1:your AWS account ID:instance/instance-ARN/queue/queue-ARN",
      }
}
```