Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Sesuaikan pengalaman alur obrolan di Amazon Connect dengan mengintegrasikan peserta khusus
Anda dapat mengintegrasikan solusi lain, seperti bot, dengan obrolan Amazon Connect untuk membuat pengalaman alur obrolan yang disesuaikan.
Berikut ini adalah ikhtisar tentang bagaimana Anda dapat menyesuaikan pengalaman alur obrolan Anda. Terapkan langkah-langkah ini untuk setiap segmen obrolan setelah percakapan obrolan dimulai. Sebaiknya tambahkan [Fungsi AWS Lambda ](invoke-lambda-function-block.md) blok untuk memanggil alur obrolan Anda. APIs
**penting**
Tambahkan [Mainkan prompt](play.md) blok sebelum [Fungsi AWS Lambda ](invoke-lambda-function-block.md) blok. Ini diperlukan hanya jika blok **Invoke AWS Lambda** adalah blok pertama dalam alur obrolan masuk Anda.
1. [Aktifkan streaming pesan obrolan secara real-time](chat-message-streaming.md).
1. Hubungi Amazon Connect [CreateParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateParticipant.html)API untuk menambahkan peserta khusus (`ParticipantRole`=`CUSTOM_BOT`) ke kontak obrolan.
1. Untuk informasi tentang cara membuat klien SDK untuk memanggil Amazon Connect APIs, lihat topik berikut:
+ [Kelas AmazonConnectClientBuilder](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/connect/AmazonConnectClientBuilder.html)
+ [Membuat Klien Layanan](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/creating-clients.html)
1. Simpan `ParticipantToken` yang diperoleh dari [CreateParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateParticipant.html)panggilan [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html). `CreateParticipantConnection`mengembalikan`ConnectionToken`, yang dapat Anda gunakan untuk memanggil Peserta Amazon Connect lainnya APIs.
Saat menelepon [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html)untuk membuat koneksi untuk peserta khusus:
+ Setel `ConnectParticipant` `True` untuk menandai peserta kustom sebagai terhubung untuk streaming pesan.
+ Lulus `Type` `CONNECTION_CREDENTIALS` untuk menghubungi Layanan Peserta Amazon Connect berikutnya APIs.
+ `CreateParticipantConnection`harus dipanggil dalam waktu 15 detik setelah menelepon`CreateParticipant`.
1. Setelah peserta ditambahkan ke kontak, mereka dapat bertukar pesan dengan pelanggan menggunakan Layanan Peserta Amazon Connect APIs.
1. Untuk memutuskan sambungan peserta, hubungi [ DisconnectParticipant](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_DisconnectParticipant.html)API.
**catatan**
Peserta khusus tidak dapat ditambahkan ke obrolan ketika agen atau bot Amazon Lex sudah ada di kontak.
Peserta khusus akan terputus saat agen atau bot Amazon Lex bergabung dengan kontak.
Hanya satu peserta khusus yang dapat hadir di kontak.
Peserta khusus tidak diizinkan untuk mengakses lampiran yang dapat diunggah pelanggan.
Kami merekomendasikan untuk mengonfigurasi berapa lama peserta kustom dapat mengobrol dengan kontak:
+ Mengatur properti **Timeout** pada [Tunggu](wait.md) blok untuk `ParticipantRole` =`CUSTOM_BOT`.
+ Jika peserta bot khusus tidak terputus sebelum batas waktu, maka kontak dialihkan ke cabang **Time** Expired. Ini memungkinkan Anda memutuskan blok mana yang akan dijalankan di sebelah untuk menyelesaikan kueri pelanggan.
**catatan**
Jika kontak dialihkan ke cabang **Time Expired**, kontak tersebut tidak terputus dari kontak. Anda harus memanggil [ DisconnectParticipant](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_DisconnectParticipant.html)API untuk memutuskan sambungan peserta.
## Aktifkan timer untuk pelanggan yang bergabung dengan peserta kustom
Anda dapat mengaktifkan timer pada pelanggan yang bergabung dengan peserta khusus, seperti bot khusus. Ini memungkinkan Anda mendeteksi kapan pelanggan berhenti merespons sehingga Anda kemudian dapat menghentikan percakapan bot itu, dan melakukan langkah berikutnya dalam alur. Dengan menghentikan peserta idle, Anda dapat mengurangi jumlah obrolan terbuka di mana ada pelanggan yang tidak responsif yang terlibat dengan peserta khusus.
Lakukan langkah-langkah berikut untuk mengintegrasikan Ekstensi Bot Kustom Peserta Idle dan secara opsional mengatur nilai timer kustom. Langkah-langkah ini mengasumsikan bahwa Anda sudah menggunakan fitur peserta kustom untuk chatting.
1. Sebelum peserta kustom bergabung dengan obrolan, panggil [UpdateParticipantRoleConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateParticipantRoleConfig.html)API untuk pelanggan.
1. Timer hanya diaktifkan untuk pelanggan. Peserta kustom tidak memiliki peserta idle atau timer pemutusan otomatis.
1. Anda dapat memilih metode untuk menjalankan API.
1. Nilai pengatur waktu yang dikonfigurasi dalam langkah ini bertahan selama masa obrolan. Jika Anda menginginkan nilai timer yang berbeda untuk **interaksi pelanggan dan agen**, lihat Langkah 2.
1. Jika klien Anda sudah diatur dengan cara ini, Anda tidak perlu mengambil tindakan lain untuk mengintegrasikan peserta kustom Anda.
1. (Opsional) Untuk mengonfigurasi nilai timer dan timer yang berbeda selama interaksi **pelanggan dan agen dibandingkan selama interaksi** **pelanggan dan peserta kustom**:
+ Sebelum agen bergabung dengan obrolan, panggil [UpdateParticipantRoleConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateParticipantRoleConfig.html)API lagi dengan konfigurasi yang Anda inginkan.
Untuk informasi selengkapnya tentang pengatur waktu obrolan, lihat[Mengatur batas waktu obrolan untuk peserta obrolan](setup-chat-timeouts.md).
### Pengatur waktu mulai
Timer dimulai untuk pelanggan setelah peserta kustom membuat koneksi ke mereka menggunakan [CreateParticipantConnection](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-participant_CreateParticipantConnection.html)API.
### Apa yang terjadi ketika peserta yang tidak kompatibel bergabung dengan obrolan dengan peserta khusus
Berikut adalah apa yang terjadi ketika agen atau peserta Lex bot bergabung dengan obrolan dengan peserta khusus, dan mereka adalah peserta yang tidak kompatibel:
1. Peserta kustom secara otomatis terputus dari obrolan.
1. Semua timer yang sebelumnya aktif dihentikan dan timer baru dibuat untuk peserta yang terhubung (jika timer dikonfigurasi).
1. Setiap timer baru juga diperbarui dengan konfigurasi terbaru (jika diperlukan). Ini secara efektif menetapkan “Sesi menganggur” baru untuk kumpulan peserta aktif baru di obrolan.
### Interaksi dengan timer blok Tunggu
Timer idle tidak memengaruhi cara kerja [Tunggu](wait.md) blok.
Pengatur waktu blok **Tunggu** yang dimulai saat kontak obrolan memasuki blok **Tunggu** terus berfungsi. Jika pengatur waktu blok **Tunggu** kedaluwarsa, kontak melanjutkan aliran dan dialihkan ke cabang **Waktu Kedaluwarsa, terlepas dari apakah ada pengatur waktu** peserta yang menganggur yang aktif.
## Tip pemecahan masalah
+ `ResourceNotFoundException`:
Jika Anda mendapatkan `ResourceNotFoundException` untuk peserta kustom saat memanggil `CreateParticipantConnection` API, periksa apakah `CreateParticipantConnection` API dipanggil dalam waktu 15 detik setelah `CreateParticipant` API.
+ `AccessDeniedException`:
Jika Anda mendapatkan `AccessDeniedException` kesalahan dan peran peserta adalah CUSTOM\$1BOT, ini menunjukkan bot mencoba mengakses lampiran. Peran peserta CUSTOM\$1BOT tidak diizinkan untuk mengakses lampiran yang diunggah pelanggan.