設定電子郵件的外部儲存空間

必須設定外部儲存空間，才能使用電子郵件管道。您可以使用 Cloud Storage 或 Amazon S3 做為外部儲存空間。

設定 Cloud Storage

如要設定 Cloud Storage 接收電子郵件，請參閱「Cloud Storage」。

請確認 JSON 服務帳戶金鑰包含下列欄位：

  • type: "service_account"

  • project_id

  • private_key_id

  • private_key

  • client_email

  • client_id

  • auth_uri

  • token_uri

  • auth_provider_x509_cert_url

  • Client_x509_cert_url

設定 Amazon S3 儲存空間

設定 Amazon S3 驗證時，Contact Center AI 平台 (CCAI Platform) 會擔任您在 AWS 帳戶中建立的身分與存取權管理 (IAM) 角色。這個角色會授予 CCAI Platform 存取 Amazon S3 儲存貯體所需的權限。

這個驗證方式的 JSON 服務帳戶金鑰需要下列欄位：

  • region：Amazon S3 bucket 所在的 AWS 區域，例如 "us-east-1"。

  • role_arn：CCAI 平台假設的 IAM 角色 Amazon Resource Name (ARN)。這個 ARN 可明確識別已設定適當存取政策的角色。

  • external_id：建立角色信任政策時提供的 ID。CCAI Platform 要求擔任該角色時，會傳遞這個 ID，確保只有預期的實體能擔任該角色。

如要建立 Amazon S3 JSON 服務帳戶金鑰，請按照下列步驟操作：

  1. 登入 AWS 帳戶。

  2. 前往「IAM 資訊主頁」。

  3. 在「IAM Dashboard」(IAM 資訊主頁) 中，依序選取「Roles」(角色) 和「Create role」(建立角色)。

  4. 如要設定信任關係，請按照下列步驟操作：

    1. 選取「Another AWS account」做為信任實體。

    2. 輸入要擔任該角色的實體帳戶 ID。

    3. 選用：您可以新增外部 ID，多添一層安全保障。

  5. 設定權限，附加政策，授予角色 Amazon S3 bucket 的必要權限。 Google 建議您使用具備最低必要權限的政策 (例如特定 bucket 的讀取和寫入權限)，而非完整的 Amazon S3 存取權。以下是必要的 Amazon S3 權限：

    • "s3:ListBucket"、

    • "s3:GetObject"、

    • "s3:PutObject"、

    • "s3:DeleteObject"

  6. 按照其餘提示建立角色。系統會提供角色 ARN。

  7. 如要建立 JSON 檔案，請使用角色 ARN 和外部 ID (如有)，如以下範例所示：

    {
  "region": "YOUR-AWS-REGION",
  "role_arn": "YOUR_ROLE_ARN",
  "external_id": "YOUR_EXTERNAL_ID"
}

設定電子郵件儲存空間

如果您使用 Google Cloud 做為資料伺服器，請務必將 Cloud Storage 角色設為「Storage Admin」，以免在設定期間發生錯誤。詳情請參閱「Cloud Storage 的 IAM 角色」。

如要設定電子郵件儲存空間，請按照下列步驟操作：

  1. 在 CCAI Platform 入口網站中，依序點選「Settings」>「Developer Settings」。如果沒有看到「設定」選單，請按一下「選單」圖示 。

  2. 前往「Email Account Management」(電子郵件帳戶管理) 專區，然後按一下「Manage Email Account」(管理電子郵件帳戶)。

  3. 在「資料管理」部分，選取資料儲存時間長度。

  4. 在「Data Server」(資料伺服器) 部分，選取「 Google Cloud」或「Amazon S3」。這兩種選項都需要提供相同資訊：

    • Bucket Name：輸入儲存空間 bucket 的確切名稱。

    • 服務帳戶金鑰 (JSON 檔案)：上傳Google Cloud 或 Amazon S3 服務帳戶的 JSON 金鑰檔案。

    • 資料夾路徑：系統會自動產生這個路徑。連結電子郵件帳戶後，系統會自動在您指定的 bucket 中建立資料夾。

  5. 按一下「Test Connection」(測試連線)，確認憑證和值區詳細資料正確無誤。

  6. 按一下「儲存」。

系統已設定為儲存已連結電子郵件帳戶的電子郵件資料。預期行為如下：

  • 自動同步資料：系統每 45 秒會自動將郵件伺服器中的電子郵件資料 (包括中繼資料和附件) 同步至設定的儲存空間 bucket。

  • 連線監控：系統會持續監控與電子郵件儲存空間和電子郵件伺服器的連線。如果超過 30 分鐘仍無法重新建立連線，系統會自動傳送通知電子郵件給執行個體的管理員使用者。系統也具備自動重試邏輯，可重新建立失敗的連線。

電子郵件資料保留政策

您在「Data Management」(資料管理) 專區設定的儲存時間長度，代表電子郵件在儲存空間 bucket 中的保留時間。超過這個時間後，電子郵件就會從儲存空間中刪除。如果您在設定的儲存時間後回覆電子郵件討論串 (例如儲存時間設為 60 天，而您在第 61 天回覆)，系統會從 IMAP 伺服器擷取整個電子郵件討論串，包括任何附件。但不會顯示超過三年的電子郵件。