Menyiapkan penyimpanan eksternal untuk email

Menyiapkan penyimpanan eksternal adalah persyaratan untuk saluran email. Anda dapat menggunakan Cloud Storage atau Amazon S3 sebagai penyimpanan eksternal.

Menyiapkan Cloud Storage

Untuk menyiapkan Cloud Storage untuk email, lihat Cloud Storage.

Pastikan kunci akun layanan JSON Anda berisi kolom berikut:

  • 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

Menyiapkan penyimpanan Amazon S3

Saat Anda menyiapkan autentikasi untuk Amazon S3, Contact Center AI Platform (CCAI Platform) akan mengasumsikan peran Identity and Access Management (IAM) yang Anda buat di akun AWS. Peran ini memberi CCAI Platform izin yang diperlukan untuk mengakses bucket Amazon S3 Anda.

Kunci akun layanan JSON untuk metode autentikasi ini memerlukan kolom berikut:

  • region: Region AWS tempat bucket Amazon S3 Anda berada—misalnya, "us-east-1".

  • role_arn: Amazon Resource Name (ARN) dari peran IAM yang diasumsikan oleh CCAI Platform. ARN ini secara unik mengidentifikasi peran yang telah dikonfigurasi dengan kebijakan akses yang sesuai.

  • external_id: ID yang Anda berikan saat membuat kebijakan kepercayaan untuk peran tersebut. CCAI Platform meneruskan ID ini saat meminta untuk mengasumsikan peran, sehingga memastikan hanya entity yang dimaksud yang dapat melakukannya.

Untuk membuat kunci akun layanan JSON Amazon S3, ikuti langkah-langkah berikut:

  1. Login ke akun AWS Anda.

  2. Buka Dasbor IAM.

  3. Di IAM Dashboard, pilih Roles, lalu Create role.

  4. Untuk mengonfigurasi hubungan kepercayaan, lakukan hal berikut:

    1. Pilih Another AWS account sebagai entitas tepercaya.

    2. Masukkan ID akun entitas yang akan mengasumsikan peran tersebut.

    3. Opsional: Anda dapat menambahkan ID eksternal untuk lapisan keamanan tambahan.

  5. Tetapkan izin, lampirkan kebijakan yang memberikan peran izin yang diperlukan untuk bucket Amazon S3 Anda. Google merekomendasikan agar Anda menggunakan kebijakan dengan hak istimewa terendah yang diperlukan (misalnya, akses baca dan tulis ke bucket tertentu), bukan akses Amazon S3 penuh. Berikut adalah izin Amazon S3 yang diperlukan:

    • "s3:ListBucket",

    • "s3:GetObject",

    • "s3:PutObject",

    • "s3:DeleteObject"

  6. Ikuti petunjuk selanjutnya untuk membuat peran. Anda akan diberikan ARN Peran.

  7. Untuk membuat file JSON, gunakan ARN Peran dan ID eksternal (jika digunakan) seperti dalam contoh berikut:

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

Mengonfigurasi penyimpanan email

Jika Anda menggunakan Google Cloud sebagai server data, pastikan peran Cloud Storage Anda ditetapkan ke Storage Admin untuk mencegah error selama penyiapan. Untuk mengetahui informasi selengkapnya, lihat Peran IAM untuk Cloud Storage.

Untuk mengonfigurasi penyimpanan email Anda, ikuti langkah-langkah berikut:

  1. Di portal CCAI Platform, klik Settings > Developer Settings. Jika Anda tidak melihat menu Setelan, klik Menu.

  2. Buka bagian Email Account Management, lalu klik Manage Email Account.

  3. Di bagian Pengelolaan Data, pilih durasi penyimpanan data.

  4. Di bagian Data Server, pilih Google Cloud atau Amazon S3. Informasi yang sama diperlukan untuk kedua opsi:

    • Bucket Name: Masukkan nama persis bucket penyimpanan Anda.

    • Kunci Akun Layanan (file JSON): Upload file kunci JSON untuk akun layananGoogle Cloud atau Amazon S3 Anda.

    • Folder Path: Jalur ini dibuat secara otomatis. Saat Anda menautkan akun email, sistem akan otomatis membuat folder dalam bucket yang Anda tentukan.

  5. Klik Test Connection untuk memverifikasi bahwa kredensial dan detail bucket sudah benar.

  6. Klik Simpan.

Sistem dikonfigurasi untuk menyimpan data email dari akun email tertaut. Anda dapat mengharapkan perilaku berikut:

  • Sinkronisasi data otomatis: Sistem akan otomatis menyinkronkan data email, termasuk metadata dan lampiran, dari server email Anda ke bucket penyimpanan yang dikonfigurasi setiap 45 detik.

  • Pemantauan koneksi: Sistem terus memantau koneksi ke penyimpanan email dan server email Anda. Jika koneksi tidak dapat dibuat ulang selama lebih dari 30 menit, email notifikasi otomatis akan dikirim ke pengguna Admin untuk instance Anda. Sistem juga memiliki logika percobaan ulang otomatis untuk membuat ulang koneksi yang gagal.

Kebijakan retensi email

Durasi penyimpanan yang Anda tetapkan di bagian Pengelolaan Data menunjukkan jumlah waktu email disimpan di bucket penyimpanan Anda. Setelah waktu tersebut, email akan dihapus dari penyimpanan. Jika Anda membalas rangkaian pesan email setelah waktu penyimpanan yang ditetapkan (misalnya, waktu penyimpanan ditetapkan ke 60 hari, dan Anda membalas pada hari ke-61), seluruh rangkaian pesan email akan diambil dari server IMAP Anda, termasuk lampiran apa pun. Namun, email yang berusia lebih dari tiga tahun tidak akan terlihat.