

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Aktifkan lampiran di PKC Anda sehingga pelanggan dan agen dapat berbagi dan mengunggah file
<a name="enable-attachments"></a>

Anda dapat mengizinkan pelanggan dan agen untuk berbagi file menggunakan obrolan, email, dan tugas, dan memungkinkan agen untuk mengunggah file ke kasus. Setelah Anda menyelesaikan langkah-langkah dalam topik ini, ikon lampiran secara otomatis muncul di Panel Kontrol Kontak agen Anda sehingga mereka dapat berbagi lampiran pada obrolan, email, dan tugas. 

**penting**  
Anda harus menyelesaikan langkah 1 dan 4 dalam topik ini (buat bucket Amazon S3 dan konfigurasikan kebijakan CORS) untuk lampiran email. Jika Anda tidak melakukan ini, namun telah memilih **Aktifkan berbagi Lampiran** untuk instans Anda, saluran email tidak akan berfungsi untuk instans Anda.

 Untuk daftar jenis file yang didukung, lihat [Connect Customer spesifikasi fitur](feature-limits.md).

Jika Anda tidak menggunakan widget komunikasi yang dihosting, Anda perlu memperbarui antarmuka obrolan yang menghadap pelanggan untuk mendukung berbagi lampiran.

**Menggunakan aplikasi obrolan khusus?** Lihat API yang telah kami tambahkan untuk mendukung berbagi lampiran: [StartAttachmentUpload](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_StartAttachmentUpload.html), [CompleteAttachmentUpload](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CompleteAttachmentUpload.html), dan [GetAttachment](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_GetAttachment.html).

**Menggunakan aplikasi agen khusus?** Periksa API file terlampir: [StartAttachedFileUpload[CompleteAttachedFileUpload](https://docs.aws.amazon.com/connect/latest/APIReference/API_CompleteAttachedFileUpload.html)](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartAttachedFileUpload.html),, dan [GetAttachedFile[BatchGetAttachedFileMetadata](https://docs.aws.amazon.com/connect/latest/APIReference/API_BatchGetAttachedFileMetadata.html)](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetAttachedFile.html), dan [DeleteAttachedFile](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteAttachedFile.html).

## Langkah 1: Aktifkan lampiran
<a name="step1-enable-attachments"></a>

1. Buka konsol Connect Customer di [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).

1. Pada halaman instance, pilih alias instance. Alias instance juga merupakan **nama instans** Anda, yang muncul di URL Connect Customer Anda. Gambar berikut menunjukkan halaman **instance pusat kontak virtual Connect Customer**, dengan kotak di sekitar alias instance.  
![Halaman instans pusat kontak virtual Connect Customer, alias instance.](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/instance.png)

1. **Pada halaman **Penyimpanan data**, di bawah **Lampiran**, pilih **Edit**, pilih **Aktifkan Berbagi lampiran**, lalu pilih Simpan.**

   Opsi penyimpanan muncul, mirip dengan gambar berikut.  
![Bagian lampiran.](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/attachments-enable.png)

1. Anda dapat mengubah lokasi bucket Amazon S3 tempat lampiran disimpan. Secara default, bucket Connect Customer Anda yang ada digunakan, dengan awalan baru untuk lampiran. 
**catatan**  
Saat ini, Connect Customer tidak mendukung bucket S3 dengan [Object Lock diaktifkan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html). 

   Fitur lampiran menggunakan dua lokasi Amazon S3: lokasi pementasan dan lokasi akhir. 

   Perhatikan hal berikut tentang lokasi pementasan:
   + Lokasi pementasan digunakan sebagai bagian dari alur validasi bisnis. Connect Customer menggunakannya untuk memvalidasi ukuran dan jenis file sebelum tersedia untuk diunduh dengan menggunakan `GetAttachment` API `GetAttachedFile` atau.
   + Awalan pementasan dibuat oleh Connect Customer berdasarkan path bucket yang telah Anda pilih. Secara khusus, ini termasuk awalan S3 untuk tempat Anda menyimpan file, dengan **pementasan** ditambahkan padanya.
   + Kami menyarankan Anda mengubah kebijakan penyimpanan data untuk awalan pementasan menjadi satu hari. Dengan cara ini Anda tidak akan dikenakan biaya untuk menyimpan file pementasan. Untuk petunjuk, lihat [Bagaimana cara membuat aturan siklus hidup untuk bucket S3?](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-lifecycle.html) di *Panduan Pengguna Amazon S3*.
**Awas**  
Hanya ubah siklus hidup untuk lokasi **pementasan file**. Jika Anda secara tidak sengaja mengubah siklus hidup untuk seluruh bucket Amazon S3, semua transkrip dan lampiran akan dihapus.
Objek S3 **dihapus secara permanen** jika versi bucket S3 tidak diaktifkan.

## Langkah 2: Aktifkan izin konfigurasi lampiran file
<a name="step2-security-profile-permissions"></a>

Untuk mengizinkan administrator melihat atau mengubah pengaturan lampiran file, tetapkan izin yang sesuai di profil keamanannya.

1. Di konsol Connect Customer, pilih **Users**, **Security profiles**.

1. Pilih profil keamanan yang ingin Anda ubah.

1. Perluas bagian **Pengaturan**.

1. Di bawah **Lampiran file**, pilih izin yang akan ditetapkan:
   + **Lihat** - Memungkinkan pengguna untuk melihat pengaturan lampiran file.
   + **Edit** - Memungkinkan pengguna untuk melihat dan memodifikasi pengaturan lampiran file, termasuk ukuran dan jenis lampiran.
   + **Semua** - Memberikan izin Lihat dan Edit untuk pengaturan lampiran file.

1. Pilih **Simpan**.

![Halaman Edit profil keamanan dengan bagian Pengaturan diperluas, menampilkan izin lampiran File.](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/enable-attachments-security-profile-settings.png)


Pengguna yang diberi profil keamanan dengan izin lampiran file melihat ikon **Pengaturan** di menu navigasi kiri, di bawah **Saluran**. Dari sana, mereka dapat melihat atau mengedit pengaturan lampiran file berdasarkan izin yang ditetapkan.

## Langkah 3: Konfigurasikan jenis file lampiran dan batas ukuran
<a name="step3-configure-attachment-options"></a>

Setelah mengaktifkan lampiran dan menetapkan izin, Anda dapat mengonfigurasi jenis file yang diizinkan dan ukuran file maksimum untuk setiap saluran secara independen. Konfigurasi dicakup per saluran: Email, Obrolan, Tugas, dan Kasus. Perubahan pada satu saluran tidak mempengaruhi yang lain.

**Untuk mengonfigurasi jenis file lampiran dan batas ukuran**

1. Di situs web admin Connect Customer, pilih ikon **Pengaturan** (ikon roda gigi) di panel navigasi kiri.

1. Pada halaman **Lampiran**, pilih **Edit**.

   Gambar berikut menunjukkan halaman Lampiran dalam mode read-only.  
![Halaman Lampiran menampilkan konfigurasi saat ini dalam mode hanya-baca, dengan tombol Edit di kanan atas.](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/enable-attachments-config-view.png)

1. Di bawah **Saluran**, pilih **Konfigurasikan setiap saluran dan layanan satu per** satu untuk menetapkan jenis file dan batas ukuran yang berbeda per saluran. Atau, pilih **Terapkan satu konfigurasi ke semua saluran dan layanan** untuk menggunakan pengaturan yang sama di seluruh instans Anda.

1. Pilih tab saluran yang ingin Anda konfigurasikan: **Email**, **Obrolan**, **Tugas**, atau **Kasus**.

1. Untuk menambahkan ekstensi file khusus, masukkan ekstensi di bidang **Tambahkan ekstensi file** dan pilih **Tambahkan ekstensi**. Untuk menghapus jenis file yang diizinkan, pilih X di sebelah ekstensi.

1. Di bawah **Ukuran file maksimum**, gunakan penggeser atau masukkan nilai untuk mengatur ukuran lampiran maksimum untuk saluran yang dipilih.
   + Untuk Obrolan, Tugas, dan Kasus, Anda dapat mengonfigurasi ukuran file maksimum dari 1 MB hingga 100 MB.
   + Untuk Email, ukuran file maksimum adalah 20 MB. Anda dapat mengurangi batas ini tetapi tidak dapat melebihi 20 MB.

   Gambar berikut menunjukkan konfigurasi lampiran dalam mode edit.  
![Halaman Lampiran dalam mode edit, menampilkan tab saluran, jenis file yang diizinkan, dan penggeser ukuran file maksimum.](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/enable-attachments-config-edit.png)

1. Pilih **Simpan**.

**Batasan lampiran email**  
Lampiran email tidak boleh melebihi 20 MB karena keterbatasan Amazon SES.
Bahkan jika Anda menambahkan ekstensi file ke daftar yang diizinkan untuk email, Amazon SES dapat memblokir jenis file tertentu. Untuk daftar jenis file yang diblokir SES, lihat [Jenis lampiran yang tidak didukung](https://docs.aws.amazon.com/ses/latest/dg/mime-types-appendix.html) di *Panduan Pengembang Layanan Email Sederhana Amazon*.

**catatan**  
Anda juga dapat mengonfigurasi opsi ini secara terprogram dengan menggunakan API. [UpdateAttachedFilesConfiguration](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateAttachedFilesConfiguration.html) API menggunakan `AttachmentScope` parameter untuk menentukan saluran (EMAIL, CHAT, CASE, atau TASK).

## Langkah 4: Konfigurasikan kebijakan CORS pada bucket lampiran
<a name="step4-update-cors-policy"></a>

Agar pelanggan dan agen dapat mengunggah dan mengunduh file, perbarui kebijakan berbagi sumber daya lintas asal (CORS) Anda untuk mengizinkan `PUT` dan `GET` meminta bucket Amazon S3 yang Anda gunakan untuk lampiran. Ini lebih aman daripada mengaktifkan publik read/write di bucket Amazon S3 Anda, yang tidak kami rekomendasikan.

**Untuk mengkonfigurasi CORS pada bucket lampiran**

1. Temukan nama bucket Amazon S3 untuk menyimpan lampiran: 

   1. Buka konsol Connect Customer di [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).

   1. Di konsol Connect Customer, pilih **Penyimpanan data**, dan cari nama bucket Amazon S3. 

1. Buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Di konsol Amazon S3, pilih bucket Amazon S3 Anda. 

1. Pilih tab **Izin**, lalu gulir ke bawah ke **bagian berbagi Cross-origin sumber daya (CORS)**.

1. Tambahkan kebijakan CORS yang memiliki salah satu aturan berikut di bucket lampiran Anda. Misalnya kebijakan CORS, lihat [ Use-case skenario berbagi Cross-origin sumber daya:](https://docs.aws.amazon.com/AmazonS3/latest/userguide/cors.html#example-scenarios-cors) di Panduan Pengembang *Amazon S3*.
   + Opsi 1: Buat daftar titik akhir dari mana lampiran akan dikirim dan diterima, seperti nama situs web bisnis Anda. Aturan ini memungkinkan permintaan PUT dan GET lintas asal dari situs web Anda (misalnya,http://www.example1.com).

     Kebijakan CORS Anda mungkin terlihat mirip dengan contoh berikut:

     ```
     [
         {                               
             "AllowedMethods": [
                 "PUT",
                 "GET"            
             ],
             "AllowedOrigins": [
                 "http://www.example1.com", 
                 "http://www.example2.com" 
                 ],
            "AllowedHeaders": [
                 "*"
                 ]
         }    
     ]
     ```
   + Opsi 2: Tambahkan `*` wildcard ke`AllowedOrigin`. Aturan ini memungkinkan permintaan PUT dan GET lintas asal dari semua asal, jadi Anda tidak perlu mencantumkan titik akhir Anda.

     Kebijakan CORS Anda mungkin terlihat mirip dengan contoh berikut:

     ```
     [
         {                               
             "AllowedMethods": [
                 "PUT",
                 "GET"            
             ],
             "AllowedOrigins": [
                 "*" 
                 ],
            "AllowedHeaders": [
                 "*"
                 ]
         }    
     ]
     ```

## Langkah 5 (Opsional): Integrasikan dengan API untuk meningkatkan UI kustom Anda
<a name="step5-update-chat-ui"></a>

Jika Anda melewatkan UI Obrolan atau ruang kerja Agen yang tidak biasa, Anda dapat menggunakan API lampiran Connect Customer Participant, atau Connect Customer attached files API untuk membangun UI Anda sendiri dan memberikan dukungan lampiran untuk Kasus dan Obrolan. Untuk langkah-langkah umum dalam bekerja dengan kedua set API, lihat [Bekerja dengan lampiran.](https://docs.aws.amazon.com/connect/latest/APIReference/working-with-acps-api)

## Langkah berikutnya
<a name="nextsteps-attachments"></a>

Sebaiknya aktifkan pemindaian lampiran untuk memenuhi persyaratan kepatuhan atau kebijakan keamanan yang mungkin dimiliki organisasi Anda untuk berbagi file. Untuk informasi selengkapnya, lihat [Siapkan pemindaian lampiran di Connect Customer](setup-attachment-scanning.md).

## Lampiran tidak muncul?
<a name="problems-enabling-attachments"></a>

Jika agen Anda melaporkan masalah saat menerima dan mengirim lampiran dalam pesan obrolan, lihat[Firewall internal atau kebijakan CORS yang hilang mencegah akses ke obrolan, email, tugas, atau lampiran kasus](ts-agent-attachments.md). 