

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 錯誤通知：當 Contact Lens 無法分析聯絡
<a name="contact-lens-error-notifications"></a>

即使流程已啟用分析，Contact Lens 也可能無法分析聯絡檔案。發生這種情況時，Contact Lens 會使用 Amazon EventBridge 事件傳送錯誤通知。

[盡可能](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html)發出事件。

## 訂閱 EventBridge 通知
<a name="contact-lens-error-notifications-subscribe"></a>

若要訂閱這些通知，請建立符合下列項目的自訂 EventBridge 規則：
+ 「來源」=「aws.connect」
+ 「詳細資訊類型」=「Contact Lens 分析狀態變更」

您還可以新增至模式，以便在特定事件代碼發生時通知。如需詳細資訊，請參閱《Amazon EventBridge 使用者指南》**中的[事件模式](https://docs.aws.amazon.com/eventbridge/latest/userguide/filtering-examples-structure.html)。

通知的格式如下範例：

```
{
    "version": "0", // set by CloudWatch Events
    "id": "55555555-1111-1111-1111-111111111111", // set by CloudWatch Events
    "source": "aws.connect",
    "detail-type": "Contact Lens Analysis State Change",
    "account": "111122223333",
    "time": "2020-04-27T18:43:48Z",
    "region": "us-east-1", // set by CloudWatch Events
    "resources": [
        "arn:aws:connect:us-east-1:111122223333:instance/abcd1234-defg-5678-h9j0-7c822889931e",
        "arn:aws:connect:us-east-1:111122223333:instance/abcd1234-defg-5678-h9j0-7c822889931e/contact/efgh4567-pqrs-5678-t9c0-111111111111"
    ],
    "detail": {
        "instance": "arn:aws:connect:us-east-1:111122223333:instance/abcd1234-defg-5678-h9j0-7c822889931e",
        "contact": "arn:aws:connect:us-east-1:111122223333:instance/abcd1234-defg-5678-h9j0-7c822889931e/contact/efgh4567-pqrs-5678-t9c0-111111111111",
        "channel": "VOICE",
        "state": "FAILED",
        "reasonCode": "RECORDING_FILE_CANNOT_BE_READ"
    }
}
```

## 事件代碼
<a name="contact-lens-event-codes-listed"></a>

 下表列出 Contact Lens 無法分析聯絡時可能導致的事件代碼。


| 事件原因代碼 | 說明 | 
| --- | --- | 
| INVALID\_ANALYSIS\_CONFIGURATION | 流程起始時，Contact Lens 收到無效的值，例如不支援或無效的語言代碼，或修訂行為不支援的值。 | 
| RECORDING\_FILE\_CANNOT\_BE\_READ | Contact Lens 無法取得錄音檔案。可能是因為檔案不在 S3 儲存貯體中，或是許可有問題。 | 
| RECORDING\_FILE\_TOO\_SMALL | 錄音檔案太小，無法進行分析 (小於 105 ms)。<br />如果檔案沒有預期的格式，則會發生INVALID錯誤。空的 JSON 也是個預期外的物件。 | 
| RECORDING\_FILE\_TOO\_LARGE | 錄音檔案超過分析的持續時間限制。[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/contact-lens-error-notifications.html) | 
| RECORDING\_FILE\_INVALID | 錄音檔案無效。 | 
| RECORDING\_FILE\_CANNOT\_BE\_READ | Contact Lens 嘗試讀取錄音檔案時發生錯誤。 | 
| RECORDING\_FILE\_EMPTY | 錄音檔案是空的。 | 
| RECORDING\_SAMPLE\_RATE\_NOT\_SUPPORTED | 音訊檔案的取樣率不受支援。Contact Lens 目前支援 8kHz 取樣率的音訊檔案。這是 Connect Customer 錄音的範例速率。 | 