メール用の外部ストレージを設定する

メール チャネルでは、外部ストレージの設定が必須です。外部ストレージとして 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 の認証を設定すると、コンタクト センター AI プラットフォーム（CCAI Platform）は、AWS アカウントで作成した Identity and Access Management（IAM）ロールを引き受けます。このロールにより、Amazon S3 バケットへのアクセスに必要な権限が CCAI Platform に付与されます。

この認証方法の JSON サービス アカウント キーには、次のフィールドが必要です。

  • region: Amazon S3 バケットが配置されている AWS リージョン（例: "us-east-1"）。

  • role_arn: CCAI Platform が想定する IAM ロールの Amazon Resource Name（ARN）。この ARN は、適切なアクセス ポリシーで構成されたロールを一意に識別します。

  • external_id: ロールの信頼ポリシーの作成時に指定する識別子。CCAI Platform は、ロールの引き受けをリクエストするときにこの ID を渡します。これにより、目的のエンティティのみがロールを引き受けることができます。

Amazon S3 JSON サービス アカウント キーを作成する手順は次のとおりです。

  1. AWS アカウントにログインします。

  2. IAM ダッシュボードに移動します。

  3. [IAM Dashboard] で、[Roles]、[Create role] の順に選択します。

  4. 信頼関係を構成する手順は次のとおりです。

    1. 信頼できるエンティティとして [Another AWS account] を選択します。

    2. ロールを引き受けるエンティティのアカウント ID を入力します。

    3. 省略可: セキュリティを強化するために、外部 ID を追加できます。

  5. 権限を設定し、Amazon S3 バケットに必要な権限をロールに付与するポリシーをアタッチします。 Google では、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 のロールがストレージ管理者に設定されていることを確認してください。詳細については、Cloud Storage に対する IAM ロールをご覧ください。

メール ストレージを構成する手順は次のとおりです。

  1. CCAI Platform ポータルで、[Settings] > [Developer Settings] をクリックします。[設定] メニューが表示されない場合は、 [メニュー] をクリックします。

  2. [Email Account Management] セクションに移動し、[Manage Email Account] をクリックします。

  3. [データ管理] セクションで、データ保存期間を選択します。

  4. [データサーバー] セクションで、[Google Cloud] または [Amazon S3] を選択します。どちらのオプションでも、同じ情報が必要です。

    • バケット名: ストレージ バケットの正確な名前を入力します。

    • サービス アカウント キー（JSON ファイル）:Google Cloud または Amazon S3 サービス アカウントの JSON キーファイルをアップロードします。

    • フォルダパス: このパスは自動的に生成されます。メールアカウントをリンクすると、指定したバケット内にフォルダが自動的に作成されます。

  5. [Test Connection] をクリックして、認証情報とバケットの詳細が正しいことを確認します。

  6. [保存] をクリックします。

システムは、リンクされたメール アカウントからメールデータを保存するように構成されています。想定される動作は次のとおりです。

  • データの自動同期: システムは、メタデータや添付ファイルなどのメールデータを、メールサーバーから構成済みのストレージ バケットに 45 秒ごとに自動的に同期します。

  • 接続のモニタリング: システムは、メール ストレージとメールサーバーへの接続を継続的にモニタリングします。30 分以上接続を再確立できない場合は、インスタンスの管理者ユーザーに自動通知メールが送信されます。また、失敗した接続を再確立するための自動再試行ロジックも備えています。

メールの保持ポリシー

[データ マネジメント] セクションで設定した保存期間は、メールがストレージ バケットに保持される期間を表します。この期間を過ぎると、メールはストレージから削除されます。設定された保存期間を過ぎてからメールスレッドに返信すると（たとえば、保存期間が 60 日に設定されていて、61 日目に返信した場合）、添付ファイルを含むメールスレッド全体が IMAP サーバーから取得されます。ただし、3 年以上前のメールは表示されません。