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 Amazon Connect 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. Amazon Connect 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 Amazon Connect [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 Amazon Connect fitur berdasarkan Wilayah](regions.md). 1. Pada halaman **Integrasi**, pilih **Tambahkan integrasi**. ![\[Halaman properti dari blok Atribut kontak Set.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/integrations-list.png) 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 informasi dasar dan detail akses.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/integrations-add-basic-info.png) **Memberikan izin ke aplikasi untuk integrasi data ruang kerja** ![\[Memberikan izin ke aplikasi untuk integrasi data ruang kerja.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/integrations-add-permissions.png) **Konfigurasi Iframe** ![\[Konfigurasi Iframe.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/integrations-add-iframe-config.png) 1. Pilih **Tambahkan integrasi**. 1. Jika integrasi berhasil dibuat, Anda akan dikirim ke halaman **Detail Integrasi**, dan Anda akan melihat spanduk sukses. ![\[Memberikan izin ke aplikasi untuk integrasi data ruang kerja.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/integrations-view.png) 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. ![\[Kesalahan IAM saat mencoba menghapus integrasi karena izin yang tidak mencukupi\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/delete-3p-apps.png) 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" } ] } ``` ------ # Izin profil keamanan untuk menggunakan aplikasi pihak ketiga di Amazon Connect Topik ini menjelaskan izin profil keamanan yang diperlukan untuk mengakses aplikasi pihak ketiga yang telah Anda onboard dan kaitkan. Untuk daftar izin aplikasi pihak ketiga dan nama API-nya, lihat[Daftar izin profil keamanan di Amazon Connect](security-profile-list.md). ## Izin aplikasi pihak ketiga **catatan** Setelah mengaitkan aplikasi ke instans, Anda mungkin harus menunggu hingga 10 menit untuk melihat aplikasi muncul bagian **Aplikasi Agen** dari halaman **Profil keamanan**. Aplikasi apa pun yang telah Anda onboard AWS dan terkait dengan Amazon Connect instans Anda akan muncul di bagian **Aplikasi Agen** pada halaman **Profil Keamanan**, seperti pada gambar berikut. ![\[Bagian aplikasi Agen pada halaman profil Keamanan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/assign-security-profile-3p-apps-displayed.png) Anda juga perlu memberikan akses ke PKC agar menu peluncur aplikasi muncul. ![\[Izin akses yang diterapkan untuk Panel Kontrol Kontak Akses CCP.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/assign-security-profile-3p-apps-ccp-permissions.png) Setelah Anda menetapkan izin, tinjau caranya. [Akses aplikasi pihak ketiga di ruang kerja agen Amazon Connect](3p-apps-agent-workspace.md) # Izin Iframe saat memberikan akses aplikasi pihak ketiga ke Amazon Connect Saat mengonfigurasi aplikasi pihak ketiga melalui `onboarding` UI atau API AWS Console, Anda memiliki kemampuan untuk menentukan setelan `iframe` izin. Izin ini dapat dimodifikasi bahkan setelah aplikasi telah diatur. Secara default, semua aplikasi pihak ketiga diberikan empat `iframe` izin dasar:`allow-forms`,, `allow-popups``allow-same-origin`, dan`allow-scripts`. Karena beberapa aplikasi mungkin memerlukan fungsionalitas yang ditingkatkan, `iframe` izin tambahan dapat diminta selama proses pendaftaran aplikasi. **catatan** Kompatibilitas browser untuk izin berikut dapat bervariasi menurut implementasi browser yang berbeda. | Izin | Deskripsi | | --- | --- | | Izinkan | | | clipboard-baca | Mengontrol apakah aplikasi diizinkan untuk membaca data dari clipboard. Saat ini didukung oleh Chrome, tetapi tidak oleh Firefox dan Safari. | | clipboard-tulis | Mengontrol apakah aplikasi diizinkan untuk menulis data ke clipboard. Saat ini didukung oleh Chrome, tetapi tidak oleh Firefox dan Safari. | | mikrofon | Mengontrol apakah aplikasi diizinkan untuk menggunakan perangkat input audio. | | kamera | Mengontrol apakah aplikasi diizinkan untuk menggunakan perangkat input video. | | Kotak pasir | | | bentuk-ijinkan | Memungkinkan halaman untuk mengirimkan formulir. Ini didukung secara default. | | izinkan popup | Memungkinkan aplikasi untuk membuka popup. Ini didukung secara default. | | allow-same-origin | Jika token ini tidak digunakan, sumber daya diperlakukan sebagai berasal dari asal khusus yang selalu gagal dalam kebijakan asal yang sama (berpotensi mencegah akses ke data storage/cookies dan beberapa JavaScript APIs). Ini didukung secara default. | | izinkan skrip | Memungkinkan halaman untuk menjalankan skrip. Ini didukung secara default. | | mengizinkan-download | Memungkinkan mengunduh file melalui elemen atau dengan atribut unduhan, serta melalui navigasi yang mengarah ke pengunduhan file | | ijinkan-modal | Memungkinkan halaman untuk membuka jendela modal dengan window.alert (), window.confirm (), window.Print () dan window.Prompt (), saat membuka a diperbolehkan terlepas dari kata kunci ini | | allow-storage-access-by-aktivasi pengguna | Memungkinkan untuk menggunakan Storage Access API untuk meminta akses ke cookie yang tidak dipartisi. | | allow-popups-to-escape-kotak pasir | Memungkinkan untuk membuka konteks penelusuran baru tanpa memaksakan bendera sandboxing di atasnya | ## Konfigurasi Sampel Izin Iframe dapat dikonfigurasi menggunakan template yang mirip dengan berikut ini. Misalnya, untuk memberikan izin clipboard: ``` { "IframeConfig": { "Allow": [ "clipboard-read", "clipboard-write" ], "Sandbox": [ "allow-forms", "allow-popups", "allow-same-origin", "allow-scripts" ] } } ``` **Catatan Penting** 1. Secara default, jika bidang konfigurasi iframe dibiarkan kosong atau disetel ke kurung kurawal kosong \$1\$1, izin kotak pasir berikut secara otomatis diberikan: + bentuk-ijinkan + izinkan popup + allow-same-origin + izinkan skrip ``` { "IframeConfig": { "Allow": [], "Sandbox": ["allow-forms", "allow-popups", "allow-same-origin", "allow-scripts"] } } ``` 1. Untuk mengonfigurasi aplikasi secara eksplisit tanpa izin, Anda harus mengatur array kosong untuk keduanya dan: `Allow` `Sandbox` ``` { "IframeConfig": { "Allow": [], "Sandbox": [] } } ``` # Integrasikan server MCP dengan Amazon Connect Untuk mengintegrasikan server MCP dengan Amazon Connect, Anda harus mengonfigurasi gateway Bedrock AgentCore . Gateway mengubah fungsi APIs, dan layanan Lambda Anda menjadi alat yang kompatibel dengan MCP untuk agen AI. **catatan** Hanya satu instance yang dapat dikaitkan dengan gateway, dan instance itu harus dikonfigurasi dengan URL Discovery gateway di Bedrock AgentCore. Setiap gateway hanya dapat digunakan dengan satu server MCP. ## Cara mengintegrasikan server MCP 1. Pada halaman **Tambahkan integrasi**, masukkan informasi berikut: 1. **Informasi dasar** + **Nama tampilan** - Nama yang ramah untuk aplikasi. Nama ini ditampilkan di profil keamanan dan agen Anda di tab di ruang kerja agen. Anda dapat mengubah nama ini nanti. + **Deskripsi (opsional)** — Anda secara opsional dapat memberikan deskripsi untuk aplikasi ini. + **Jenis integrasi** - Pilih **server MCP**. ![\[Halaman Tambahkan integrasi yang menampilkan bidang informasi Dasar untuk aplikasi server MCP.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/integrations-3p-mcp-app.png) 1. **Detail aplikasi** Pilih AgentCore gateway Bedrock untuk terhubung dengan Amazon Connect. Konversi gateway, fungsi APIs Lambda, dan layanan menjadi alat yang kompatibel dengan MCP untuk agen AI. Jika tidak ada gateway saat ini, buat yang baru menggunakan Bedrock. AgentCore ![\[Bagian Detail aplikasi yang menunjukkan pemilihan gateway.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/integrations-3p-mcp-select-gateway.png) Gateway baru dapat dibuat di Bedrock AgentCore. **catatan** URL Discovery harus mengikuti format ini:`[connect instance URL]/.well-known/openid-configuration`. Sebagai contoh: `https://my-instance.my.connect.aws/.well-known/openid-configuration`. ![\[Opsi konfigurasi gateway tambahan.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/3p-apps-mcp-bedrock.png) 1. **Asosiasi instans (opsional)** Pilih instance yang dikonfigurasi dengan URL Discovery gateway yang dipilih. **Default ke None.** Jika Anda belum siap untuk memilih instance atau jika tidak ada instance yang dikaitkan dengan URL Discovery gateway yang dipilih, Anda masih dapat membuat integrasi server MCP sekarang dan mengaitkan instance nanti. ![\[Bagian asosiasi Instance yang menampilkan opsi pemilihan instance.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/3p-apps-mcp-instance.png) 1. Pilih **Tambahkan integrasi**. 1. Jika integrasi berhasil dibuat, Anda akan dikirim ke halaman **Lihat integrasi** di mana Anda akan melihat spanduk sukses dan ringkasan integrasi. ![\[Halaman integrasi View menampilkan banner sukses setelah mengintegrasikan server MCP.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/3p-apps-mcp-success.png) # Peristiwa dan permintaan saat memberikan akses aplikasi pihak ketiga ke Amazon Connect Topik ini mencantumkan izin yang harus Anda berikan secara eksplisit ke aplikasi pihak ketiga untuk mengakses data Amazon Connect. **catatan** Jika Anda seorang pengembang, tinjau cara membuat aplikasi yang bereaksi terhadap peristiwa: [Integrasikan aplikasi dengan data agen Amazon Connect Agent Workspace](https://docs.aws.amazon.com/agentworkspace/latest/devguide/integrate-with-agent-data.html). Saat Anda melakukan onboard aplikasi pihak ketiga dengan menggunakan API atau UI orientasi di Konsol Manajemen AWS, Anda harus secara eksplisit memberikan izin aplikasi pihak ketiga ke data Amazon Connect. Anda juga dapat mengedit izin pada aplikasi yang ada. Untuk memahami efek dari menetapkan izin tertentu, tinjau izin, deskripsi, dan permintaan serta peristiwa berikut. Misalnya, jika Anda menetapkan izin `User.Details.View` ke aplikasi, maka itu akan memiliki kemampuan untuk membuat permintaan berikut: `agent.getName` dan`agent.getARN`. Jika aplikasi Anda mencoba berlangganan acara atau membuat permintaan data yang tidak memiliki izin, aplikasi Anda mungkin tidak berfungsi sebagaimana dimaksud. Untuk mempelajari lebih lanjut tentang setiap permintaan dan peristiwa, lihat [Referensi API](https://docs.aws.amazon.com/agentworkspace/latest/devguide/api-reference-3p-apps-events-and-requests.html.html). | Izin | Deskripsi | Permintaan | Peristiwa | | --- | --- | --- | --- | | User.Details.View | Detail tentang agen, seperti nama lengkap mereka dan ARN Pengguna | Agen/GetName Agen/GetARN | | | User.Configuration.View | Informasi konfigurasi tentang agen, seperti profil perutean terkait | agen/ getRoutingProfile agen/ getChannelConcurrency Agen/GetExtension GetLanguage agen/ listAvailabilityStates agen/ listQuickConnects suara/Izin getOutboundCall suara/ listDialableCountries | onLanguageChanged | | User.Status.View | Detail tentang status agen | Agen/GetState | agen/ onStateChanged | | Kontak.Details.View | Detail tentang kontak yang tersedia di ruang kerja | kontak/Id getInitialContact kontak/ getChannelType kontak/ getStateDuration Kontak/getQueue kontak/ getQueueTimestamp | Kontak/Oncleared Kontak/OnMissed kontak/ onStartingAcw Kontak/tersambung | | Kontak. CustomerDetails.Lihat | Detail tentang pelanggan Anda, seperti nomor telepon yang mereka hubungi (Hanya suara) | suara/ getInitialCustomer PhoneNumber | | | Kontak.Attributes.View | Metadata tentang kontak | Kontak/getAttribute Kontak/getAttributes | | | User.Status.Edit | Ubah status agen | agen/ setAvailabilityState agen/ setAvailabilityState ByName Agen/SetOffline | | | Kontak.Details.Edit | Kemampuan edit kontak, seperti melakukan panggilan keluar atau mentransfer panggilan. | suara/ createOutboundCall kontak/transfer Kontak/AddPartisipan kontak/terima kontak/jelas | | | \$1 | Menyediakan akses ke semua permintaan dan acara. | | | # Akses aplikasi pihak ketiga di ruang kerja agen Amazon Connect ## Hal-hal penting untuk diketahui + Pada 22 Juli 2024, Google [mengumumkan](https://privacysandbox.com/news/privacy-sandbox-update/) bahwa mereka tidak lagi berencana untuk menghentikan cookie pihak ketiga dan sebagai gantinya menyediakan mekanisme keikutsertaan untuk menghentikan cookie pihak ketiga. Memilih penghentian cookie pihak ketiga dapat memengaruhi pengalaman aplikasi pihak ketiga. Jika Anda menggunakan aplikasi pihak ketiga di ruang kerja Amazon Connect Agent di browser Chrome, kami sarankan Anda: + **Solusi sementara**: Perbarui [kebijakan Chrome Perusahaan](https://support.google.com/chrome/a/answer/7679408?sjid=16745203858910744446-EU#upChromeBrsrBB117)). Anda dapat menyetel `BlockThirdPartyCookies` Kebijakan ke false dan melindungi pengalaman agen Anda dari dampak langsung karena penghentian Cookie 3P. + **Solusi permanen**: Kami menyarankan agar pengembang aplikasi mengikuti [praktik terbaik](https://developers.google.com/privacy-sandbox/3pcd) yang akan terus meneruskan cookie pihak ketiga. + Anda harus telah [mengintegrasikan aplikasi](https://docs.aws.amazon.com/connect/latest/adminguide/3p-apps.html) dan agen harus memiliki [akses ke aplikasi](https://docs.aws.amazon.com/connect/latest/adminguide/assign-security-profile-3p-apps.html) dengan menggunakan profil keamanan. Agen juga harus memiliki akses ke PKC agar peluncur aplikasi muncul. ## Gunakan peluncur aplikasi untuk mengakses aplikasi pihak ketiga Agen dapat mengakses aplikasi pihak ketiga di ruang kerja agen dengan menggunakan peluncur aplikasi, yang ditunjukkan pada gambar berikut. Peluncur aplikasi muncul di ruang kerja agen setelah Anda berhasil melakukan [onboard](3p-apps.md) aplikasi pihak ketiga. ![\[Peluncur aplikasi di ruang kerja agen.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/agent-workspace-apps-launcher.png) Peluncur aplikasi menunjukkan daftar aplikasi yang dapat diakses agen. Agen dapat meluncurkan aplikasi ketika mereka tidak memiliki kontak (mereka dalam keadaan menganggur) atau ketika mereka berada di kontak (panggilan, obrolan, atau tugas). Setelah aplikasi dibuka untuk kontak tertentu, aplikasi tetap terbuka hingga kontak tersebut ditutup. ## Izin profil keamanan yang diperlukan untuk mengakses aplikasi pihak ketiga Agen memerlukan izin profil keamanan berikut untuk mengakses aplikasi pihak ketiga: + **Contact Control Panel (CCP) - Akses PKC** + Akses ke setidaknya satu aplikasi pihak ketiga - itu muncul di halaman profil keamanan setelah Anda berhasil memasukkan [aplikasi pihak ketiga](3p-apps.md) Anda. ## Sematkan aplikasi di ruang kerja agen Agen dapat menyematkan aplikasi sebagai terbuka. Pada tab aplikasi, pilih ikon Lainnya lalu pilih **tab Pin**, seperti yang ditunjukkan pada gambar berikut. ![\[Tab pin terbuka di ruang kerja agen.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/3p-apps-agent-workspace-pinned-1.png) Setelah aplikasi disematkan, aplikasi tetap terbuka dalam keadaan siaga dan terbuka untuk kontak apa pun yang masuk. Aplikasi tetap disematkan untuk pengguna dan browser tersebut hingga pengguna menghapus cookie di browser. Agen dapat membuka pin tab jika mereka tidak lagi ingin aplikasi ini selalu terbuka; mereka masih dapat membuka dan menutup aplikasi sesuai kebutuhan. ### Contoh aplikasi yang disematkan di ruang kerja agen Gambar berikut menunjukkan contoh aplikasi pihak ketiga bernama NoteTest yang disematkan ke ruang kerja agen. ![\[Aplikasi pengujian catatan pihak ketiga yang disematkan ke ruang kerja agen.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/3p-apps-agent-workspace-notes-app.png) Gambar berikut menunjukkan contoh aplikasi pihak ketiga bernama Maps yang disematkan ke ruang kerja agen. ![\[Aplikasi peta pihak ketiga yang disematkan ke ruang kerja agen.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/3p-apps-agent-workspace-maps-app.png) # Akses aplikasi Daftar Kerja di ruang kerja agen Amazon Connect Aplikasi Worklist memungkinkan agen dengan izin yang diperlukan dan pengaturan profil perutean untuk secara manual memprioritaskan dan menetapkan pekerjaan antrian untuk diri mereka sendiri. Langkah-langkah berikut menjelaskan cara memberi pengguna Anda akses ke aplikasi Daftar Kerja di ruang kerja mereka. **catatan** Agen hanya dapat mengakses Aplikasi Daftar Kerja di Ruang Kerja Agen jika mereka memiliki Profil Keamanan dengan izin yang sesuai yang dijelaskan di bawah ini. 1. Perbarui profil keamanan dengan memilih salah satu izin ini: + **Izinkan 'Tetapkan kepada saya' untuk izin kontak apa pun** - Memungkinkan agen untuk melihat kontak di bawah salah satu kondisi berikut: + Agen saat ini adalah satu-satunya Agen Pilihan di Kontak. + Agen Saat Ini adalah salah satu Agen Pilihan di Kontak. + Setiap Agen atau set Agen adalah Agen Pilihan di Kontak. + Kontak tanpa Agen Pilihan + **Izinkan 'Tetapkan kepada saya' untuk izin kontak saya** - Memungkinkan agen untuk melihat kontak dalam kondisi berikut: + Agen saat ini adalah satu-satunya Agen Pilihan di Kontak. + Agen Saat Ini adalah salah satu Agen Pilihan di Kontak. ![\[Tindakan kontak untuk aplikasi Daftar Kerja.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/worklist-app-1.png) Setelah izin ini ditetapkan, mereka akan tercermin di **Halaman Profil Keamanan**. ![\[Izin profil keamanan untuk aplikasi Daftar Kerja.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/worklist-security-profile.png) ![\[Izin profil keamanan untuk aplikasi Daftar Kerja.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/worklist-security-profile-2.png) 1. Perbarui pengaturan profil perutean untuk menentukan antrean/saluran untuk penetapan manual di bagian baru. ![\[Pengaturan profil perutean untuk aplikasi Daftar Kerja.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/worklist-routing-profile.png) 1. Setelah profil keamanan dan pengaturan profil perutean diperbarui, agen akan melihat aplikasi Daftar Kerja di ruang kerja mereka: ![\[Aplikasi daftar kerja di ruang kerja agen.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/worklist-workspace-view.png) ## Opsi filter yang tersedia Opsi filter yang tersedia bergantung pada izin agen: + Agen dengan **Izinkan 'Tetapkan kepada saya' untuk kontak apa pun** dapat melihat opsi filter ini: ![\[Opsi filter untuk agen dengan 'Tetapkan kepada saya' untuk izin kontak apa pun.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/worklist-filter-any-contact.png) + Agen dengan **Izinkan 'Tetapkan kepada saya' untuk kontak saya** dapat melihat opsi filter ini: ![\[Opsi filter untuk agen dengan 'Tetapkan kepada saya' untuk izin kontak saya.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/worklist-filter-my-contact.png) ## Filter Rentang Waktu untuk riwayat kontak Secara default, aplikasi Worklist menampilkan kontak yang dibuat dalam 2 minggu terakhir. Untuk melihat kontak yang dibuat di luar jangka waktu ini, gunakan filter Rentang Waktu untuk memilih rentang tanggal tertentu. Filter Rentang Waktu memungkinkan Anda memilih rentang tanggal apa pun dalam 90 hari terakhir. ![\[Aplikasi Worklist yang menampilkan filter Rentang Waktu untuk memilih rentang tanggal riwayat kontak.\]](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/worklist-time-range-filter.png) # Menyiapkan Federasi SSO untuk aplikasi pihak ketiga di instans Amazon Connect Seorang pengguna dapat menggunakan Single-Sign-On untuk federasi ke beberapa aplikasi pihak ketiga yang telah diatur dalam Amazon Connect instance mereka tanpa perlu mengautentikasi secara terpisah untuk setiap aplikasi. **catatan** Aplikasi pihak ketiga (3P) Anda dapat menyelesaikan alur Sign-On dengan mulus dalam iframe, asalkan Penyedia Identitas mendukung iframing halaman login mereka. Lihat panduan Penyedia Identitas untuk informasi rinci tentang kemampuan iframing. **Siapkan SSO untuk aplikasi pihak ketiga yang ada dalam instans Anda Amazon Connect** 1. Siapkan Penyedia Identitas atau gunakan Penyedia Identitas yang ada. 1. Siapkan pengguna dalam Penyedia Identitas. 1. Siapkan instans Amazon Connect dan[Konfigurasikan SAMP dengan IAM untuk Amazon Connect](configure-saml.md). 1. Siapkan aplikasi lain dalam Penyedia Identitas yang akan diintegrasikan dengan instans Amazon Connect. 1. Lampirkan setiap identitas pengguna individu ke aplikasi apa pun dalam Penyedia Identitas yang akan diintegrasikan dengan instans Amazon Connect Anda. Anda dapat mengontrol agen mana yang memiliki akses ke aplikasi di ruang kerja agen Amazon Connect dengan memberikan izin khusus aplikasi yang lebih terperinci dalam profil keamanan. Untuk informasi selengkapnya, lihat [Izin profil keamanan untuk menggunakan aplikasi pihak ketiga di Amazon Connect](assign-security-profile-3p-apps.md). 1. Setelah pengguna masuk ke Penyedia Identitas mereka, mereka dapat bergabung ke instans Amazon Connect mereka yang memiliki aplikasi pihak ketiga yang dikonfigurasi dan mereka dapat bergabung ke setiap aplikasi (jika aplikasi telah diatur untuk SSO) tanpa perlu nama pengguna dan kata sandi mereka.