

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

# Connect Customer ルールの実行に失敗した場合のエラー通知
<a name="error-notifications-rule-fails-to-run"></a>

実稼働環境で特定のルールアクションが失敗したタイミングと、失敗の原因を理解することは重要です。それにより、今後、このような失敗を未然に防止できます。

実行に失敗したアクションに関するリアルタイムのインサイトを取得するには、Connect Customer Rules を Amazon EventBridge イベントと統合します。これにより、例えば、**インスタンスあたりの同時アクティブタスク**の最大数がサービスクォータに達したために「タスクの作成」アクションの実行に失敗した場合、通知を受け取ることができます。この場合、Connect Customer は Amazon EventBridge イベントを使用してエラー通知を送信します。

イベントは、[ベストエフォート](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html)ベースで出力されます。

## EventBridge 通知へのサブスクライブ
<a name="rule-error-notifications-subscribe"></a>

これらの通知を受け取るには、以下の条件を満たすカスタム EventBridge ルールを作成します。
+ "source" = "aws.connect"
+ "detail-type" = "Contact Lens Rules Action Execution Failed"（Contact Lens ルールアクションの実行に失敗しました）

また、このパターンに追加して、特定のイベントコードが発生したときに通知されるようにすることもできます。詳細については、「Amazon EventBridge ユーザーガイド**」の「[Event Patterns](https://docs.aws.amazon.com/eventbridge/latest/userguide/filtering-examples-structure.html)」を参照してください。

通知は、以下の例のような形式になります。

```
{
  "version": "0",
  "id": "8d122163-6c07-f8cb-06e7-373a1bcf8fc6",
  "source": "aws.connect",
  "detail-type": "Amazon Connect Rules Action Execution Failed",
  "account": "123456789012",
  "time": "2022-01-05T01:30:42Z",
  "region": "us-east-1",
  "resources": ["arn:aws:connect:us-east-1:123456789012:instance/cb54730f-5aac-4376-b2f4-7c822889931e"],
  "detail": {
    "ruleId": "7410c94b-21c2-4db0-a707-c6d751edbe8f",
    "actionType": "CREATE_TASK",
    "triggerEvent": "THIRD_PARTY",
    "instanceArn": "arn:aws:connect:us-east-1:123456789012:instance/cb54730f-5aac-4376-b2f4-7c822889931e",
    "reasonCode": "ResourceNotFoundException",
    "error": "ContactFlowId provided does not belong to connect instance",
    "additionalInfo": "{\n  \"message\": \"Not Found\",\n  \"code\": \"ResourceNotFoundException\",\n  \"statusCode\": 404,\n  \"time\": \"2022-01-03T20:23:07.073Z\",\n  \"requestId\": \"048e4403-71c1-47d6-96fc-825744f518e7\",\n  \"retryable\": false,\n  \"retryDelay\": 28.217537834500316\n}"
  }
}
```

## サポートされているアクションタイプ
<a name="supported-action-types-rules"></a>
+ `CREATE_TASK`
+ `GENERATE_EVENTBRIDGE_EVENT`
+ `SEND_NOTIFICATION`

`ASSIGN_CONTACT_CATEGORY` の詳細については「[エラー通知: Contact Lens がコンタクトを分析できない場合 トラブルシューティング](contact-lens-error-notifications.md)」を参照してください。

## サポートされているトリガーイベント
<a name="supported-trigger-events"></a>
+ `REAL_TIME_CALL`
+ `REAL_TIME_CHAT`
+ `POST_CALL`
+ `POST_CHAT`
+ `THIRD_PARTY`

## 失敗したアクションの理由コード
<a name="reason-codes-failed-actions"></a>

アクションが失敗した場合、エラー通知サービスはサポートされているアクションから理由コードを収集します。タスクおよび EventBridge アクション失敗の理由コードの詳細については、次のトピックを参照してください。
+ タスクアクションの失敗の理由コードについては、*Connect Customer API リファレンスガイド*の **StartTaskContact** API トピックの[「エラー](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartTaskContact.html#API_StartTaskContact_Errors)」を参照してください。
+ EventBridge アクション失敗の理由コードについては、*Amazon EventBridge API リファレンスガイド*の「**PutEvents** API」トピックの「[エラー](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutEvents.html#API_PutEvents_Errors)」を参照してください。