Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Integrasikan aplikasi pihak ketiga (aplikasi 3p) di ruang kerja agen Amazon Connect
Connect Customer ruang kerja agen adalah aplikasi tunggal dan intuitif yang memberi agen Anda alat dan step-by-step panduan yang mereka butuhkan untuk menyelesaikan masalah secara efisien, meningkatkan pengalaman pelanggan, dan melakukan onboard lebih cepat. Selain menggunakan aplikasi pihak pertama di ruang kerja agen Anda, seperti Profil Pelanggan, Kasus, dan agen Connect AI, Anda dapat mengintegrasikan aplikasi pihak ketiga.
**catatan**
Fungsionalitas ini hanya didukung di ruang kerja agen default; tidak didukung saat menggunakan CCP khusus.
Misalnya, Anda dapat mengintegrasikan sistem reservasi milik Anda atau dasbor metrik yang disediakan vendor, ke dalam ruang kerja agen. Connect Customer
Jika Anda adalah pengembang yang tertarik untuk membuat aplikasi pihak ketiga, lihat [Panduan Pengembang Ruang Kerja Agen](https://docs.aws.amazon.com/agentworkspace/latest/devguide/getting-started.html).
**Topics**
+ [Persyaratan](#onboard-3p-apps-requirements)
+ [Bagaimana cara menambahkan integrasi](#onboard-3p-apps-how-to-integrate)
+ [Hapus integrasi](#delete-3p-apps)
+ [Tetapkan izin](assign-security-profile-3p-apps.md)
+ [Izin Iframe saat memberikan akses aplikasi pihak ketiga](3p-apps-iframe-permissions.md)
+ [Integrasikan server MCP](3p-apps-mcp-server.md)
+ [Acara dan permintaan](3p-apps-events-requests.md)
+ [Akses aplikasi pihak ketiga di ruang kerja agen](3p-apps-agent-workspace.md)
+ [Akses aplikasi Worklist](worklist-app.md)
+ [Pengaturan Federasi SSO aplikasi pihak ketiga](3p-apps-sso.md)
+ [Gunakan fungsionalitas pop layar aplikasi pihak ketiga di ruang kerja agen Amazon Connect](no-code-ui-builder-app-integration.md)
+ [Lokakarya untuk membangun aplikasi pihak ketiga](https://catalog.workshops.aws/amazon-connect-agent-empowerment/en-US/third-party-applications/test)
## Persyaratan
Jika Anda menggunakan kebijakan IAM khusus untuk mengelola akses ke aplikasi pihak ketiga, pengguna Anda memerlukan izin IAM berikut untuk mengintegrasikan aplikasi pihak ketiga menggunakan aplikasi. Konsol Manajemen AWS Selain itu`AmazonConnect_FullAccess`, pengguna membutuhkan:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"app-integrations:CreateApplication",
"app-integrations:GetApplication",
"iam:GetRolePolicy",
"iam:PutRolePolicy",
"iam:DeleteRolePolicy"
],
"Resource": "arn:aws:app-integrations:{{us-east-1}}:{{111122223333}}:application/*",
"Effect": "Allow"
}
]
}
```
------
## Integrasi
**catatan**
Untuk menambahkan integrasi ke instans Anda, pastikan instans Anda menggunakan Service-Linked Role (SLR). Jika instans Anda saat ini tidak menggunakan SLR tetapi Anda ingin menambahkan integrasi, Anda harus bermigrasi ke SLR. Integrasi hanya dapat ditambahkan ke instance yang menggunakan SLR. Untuk informasi selengkapnya, lihat [Untuk contoh yang dibuat sebelum Oktober 2018](connect-slr.md#migrate-slr).
1. Buka Connect Customer [konsol](https://console.aws.amazon.com/connect/) (https://console.aws.amazon.com/connect/).
1. Di panel navigasi kiri, pilih **Integrasi**. Jika Anda tidak melihat menu ini, itu karena tidak tersedia di wilayah Anda. Untuk memeriksa wilayah tempat fitur ini tersedia, lihat[Ketersediaan Connect Customer fitur berdasarkan Wilayah](regions.md).
1. Pada halaman **Integrasi**, pilih **Tambahkan integrasi**.
1. Pada halaman **Tambahkan integrasi**, masukkan:
1. **Informasi dasar**
1. **Nama tampilan**: Nama yang ramah untuk integrasi. Nama ini ditampilkan di profil keamanan dan agen Anda di tab di ruang kerja agen. Anda dapat kembali dan mengubah nama ini.
1. **Deskripsi (opsional)**: Anda dapat memberikan deskripsi apa pun untuk integrasi ini secara opsional. Deskripsi ini tidak ditampilkan kepada agen.
1. **Jenis integrasi**: Menunjukkan apakah integrasi adalah aplikasi web standar, layanan, atau server MCP. Ini menentukan bagaimana integrasi akan diakses dalam sistem.
1. **Integration identifier**: Nama resmi yang unik untuk integrasi jenis aplikasi standar atau layanan. Jika Anda hanya memiliki satu aplikasi per URL akses, kami sarankan Anda menggunakan asal URL akses. Anda tidak dapat mengubah nama ini.
1. Batas **waktu inisialisasi**: Waktu maksimum yang diizinkan untuk membuat koneksi dengan ruang kerja. Waktu yang diizinkan adalah dalam milidetik. Pengaturan ini membantu mengelola masalah koneksi dan memastikan startup aplikasi tepat waktu.
1. **Detail aplikasi**
1. **Cakupan Kontak**: Menunjukkan apakah aplikasi web menyegarkan untuk setiap kontak atau hanya menyegarkan dengan setiap sesi browser baru. Pengaturan ini memengaruhi seberapa sering aplikasi memperbarui datanya.
1. Batas **waktu inisialisasi**: Waktu maksimum yang diizinkan untuk membuat koneksi dengan ruang kerja. Waktu yang diizinkan adalah dalam milidetik. Pengaturan ini membantu mengelola masalah koneksi dan memastikan startup aplikasi tepat waktu.
1. **Akses**
1. **URL Akses**: Ini adalah URL tempat aplikasi Anda di-host. URL harus aman, dimulai dengan https, kecuali jika itu adalah host lokal.
**catatan**
Tidak semua URLs bisa di-iframed. Berikut adalah dua cara untuk memeriksa apakah URL dapat di-iframed:
Ada alat pihak ketiga yang tersedia untuk membantu memeriksa apakah URL dapat di-iframed yang disebut [Iframe](http://iframetester.com/) Tester.
Jika URL dapat di-iframed, itu akan ditampilkan dalam pratinjau di halaman ini.
Jika URL tidak dapat di-iframed, itu akan menampilkan kesalahan dalam pratinjau di halaman ini.
Ada kemungkinan bahwa situs web ini menampilkan kesalahan, dan aplikasi masih dapat di-iframed di ruang kerja agen. Ini karena pengembang aplikasi dapat mengunci aplikasi mereka agar hanya dapat disematkan ke ruang kerja dan tidak di tempat lain. Jika Anda menerima aplikasi ini dari pengembang aplikasi, kami sarankan Anda tetap mencoba mengintegrasikan aplikasi ini ke dalam ruang kerja agen.
Untuk pengguna teknis: Periksa konten kebijakan keamanan aplikasi yang Anda coba integrasikan.
Firefox: Menu hamburger > Alat lainnya > Alat pengembang web > Jaringan
Chrome: Menu 3 titik > Alat lainnya > Alat pengembang > Jaringan
Browser lain: Temukan pengaturan jaringan di alat pengembang.
Arahan Content-Security-Policy bingkai-leluhur harus. `https://{{your-instance}}.my.connect.aws`
Jika direktifnya adalah `same origin` atau`deny`, maka URL ini tidak dapat di-iframed oleh Connect AWS/Amazon
Inilah yang dapat Anda lakukan jika aplikasi tidak dapat di-iframed:
+ Jika Anda mengontrol aplikasi/URL, Anda dapat memperbarui kebijakan keamanan konten aplikasi. [Ikuti praktik terbaik untuk pengembang aplikasi/ Memastikan bahwa aplikasi hanya dapat disematkan di bagian ruang kerja agen Amazon Connect di sini.](https://docs.aws.amazon.com/agentworkspace/latest/devguide/recommendations-and-best-practices.html)
+ Jika Anda tidak mengontrol aplikasi/URL, Anda dapat mencoba menghubungi pengembang aplikasi dan meminta mereka untuk memperbarui kebijakan keamanan konten aplikasi.
1. **Asal yang disetujui (opsional)**: Daftar URLs Izinkan yang harus diizinkan, jika berbeda dari URL akses. URL harus aman, dimulai dengan https, kecuali jika itu adalah host lokal.
1. Tambahkan izin ke [acara dan permintaan](3p-apps-events-requests.md).
Berikut ini adalah contoh bagaimana Anda dapat onboard aplikasi baru dan menetapkan izin untuk itu dengan menggunakan. Konsol Manajemen AWS Dalam contoh ini, enam izin berbeda ditetapkan ke aplikasi.
**Memberikan informasi dasar dan detail akses**
1. **Asosiasi contoh**
1. Anda dapat memberikan contoh apa pun dalam akses wilayah akun ini ke aplikasi ini.
1. Meskipun mengaitkan integrasi dengan instance adalah opsional, Anda tidak akan dapat menggunakan aplikasi ini sampai Anda mengaitkannya dengan instance.
**catatan**
Untuk server MCP, Anda hanya dapat memilih instance yang dikonfigurasi dengan URL Discovery Gateway yang dipilih.
**Memberikan izin ke aplikasi untuk integrasi data ruang kerja**
**Konfigurasi Iframe**
1. Pilih **Tambahkan integrasi**.
1. Jika integrasi berhasil dibuat, Anda akan dikirim ke halaman **Detail Integrasi**, dan Anda akan melihat spanduk sukses.
Anda dapat mengedit atribut tertentu dari aplikasi yang ada, seperti Nama Tampilan, URL Akses, dan Izin.
1. Jika ada kesalahan dalam membuat aplikasi atau mengaitkan aplikasi ke instance, maka Anda akan melihat pesan kesalahan, dan Anda dapat mengambil tindakan yang sesuai untuk memperbaiki masalah.
## Hapus integrasi
Jika Anda tidak lagi ingin menggunakan integrasi di masa mendatang, Anda dapat menghapusnya. Jika Anda sementara ingin berhenti menggunakannya, tetapi Anda mungkin ingin menggunakannya lagi di masa mendatang, kami sarankan Anda memisahkannya dari sebuah instance untuk menghindari keharusan menambahkannya lagi. Untuk menghapus integrasi, navigasikan ke Konsol Manajemen AWS, pilih integrasi, dan pilih **Hapus**.
**Pemecahan Masalah**
+ Operasi akan gagal jika integrasi dikaitkan dengan instance apa pun. Pertama-tama Anda harus memisahkan integrasi dari instance apa pun. Kemudian Anda dapat kembali dan menghapusnya.
**Tip**
Jika Anda membuat integrasi sebelum 15 Desember 2023, Anda mungkin mengalami masalah saat memperbarui asosiasi integrasi ke instance. Ini karena Anda perlu melakukan pembaruan pada kebijakan IAM Anda.
Kebijakan IAM Anda perlu diperbarui untuk menyertakan izin berikut:
+ `app-integrations:CreateApplicationAssociation`
+ `app-integrations:DeleteApplicationAssociation`
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"app-integrations:CreateApplication",
"app-integrations:GetApplication"
],
"Resource": "arn:aws:app-integrations:{{us-east-1}}:{{111122223333}}:application/*",
"Effect": "Allow"
},
{
"Action": [
"app-integrations:CreateApplicationAssociation",
"app-integrations:DeleteApplicationAssociation"
],
"Resource": "arn:aws:app-integrations:{{us-east-1}}:{{111122223333}}:application-association/*",
"Effect": "Allow"
},
{
"Action": [
"iam:GetRolePolicy",
"iam:PutRolePolicy",
"iam:DeleteRolePolicy"
],
"Resource": "arn:aws:iam::{{111122223333}}:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_*",
"Effect": "Allow"
}
]
}
```
------