View a markdown version of this page

錯誤通知：當 Contact Lens 無法分析聯絡 - Amazon Connect 客戶
訂閱 EventBridge 通知事件代碼

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

錯誤通知：當 Contact Lens 無法分析聯絡

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

盡可能發出事件。

訂閱 EventBridge 通知

若要訂閱這些通知，請建立符合下列項目的自訂 EventBridge 規則：

  • 「來源」=「aws.connect」

  • 「詳細資訊類型」=「Contact Lens 分析狀態變更」

您還可以新增至模式，以便在特定事件代碼發生時通知。如需詳細資訊，請參閱《Amazon EventBridge 使用者指南》中的事件模式。

通知的格式如下範例：

{
    "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"
    }
}

事件代碼

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

事件原因代碼 Description

INVALID_ANALYSIS_CONFIGURATION

流程起始時，Contact Lens 收到無效的值，例如不支援或無效的語言代碼，或修訂行為不支援的值。

RECORDING_FILE_CANNOT_BE_READ

Contact Lens 無法取得錄音檔案。可能是因為檔案不在 S3 儲存貯體中，或是許可有問題。

RECORDING_FILE_TOO_SMALL

錄音檔案太小，無法進行分析 (小於 105 ms)。

如果檔案沒有預期的格式，就會發生 INVALID 錯誤。空的 JSON 也是個預期外的物件。

RECORDING_FILE_TOO_LARGE

錄音檔案超過分析的持續時間限制。

  • 語音：超過 14,400 秒或 4 小時以上

  • 聊天：文字記錄超過 20 萬條訊息

RECORDING_FILE_INVALID

錄音檔案無效。

RECORDING_FILE_CANNOT_BE_READ

Contact Lens 嘗試讀取錄音檔案時發生錯誤。

RECORDING_FILE_EMPTY

錄音檔案是空的。

RECORDING_SAMPLE_RATE_NOT_SUPPORTED

音訊檔案的取樣率不受支援。Contact Lens 目前支援 8kHz 取樣率的音訊檔案。這是 Amazon Connect 錄音的採樣率。