Aktifkan panggilan dalam aplikasi, web, dan video multi-pengguna - Amazon Connect

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

Aktifkan panggilan dalam aplikasi, web, dan video multi-pengguna

Amazon Connect mendukung penambahan pengguna tambahan untuk bergabung dalam aplikasi, web, dan panggilan video dalam panggilan yang ada. Anda dapat menambahkan hingga empat pengguna tambahan ke dalam aplikasi, web, atau panggilan video yang sedang berlangsung atau dijadwalkan, dengan total enam peserta: agen, pengguna pertama, dan empat peserta lainnya (pengguna atau agen).

Cara menambahkan peserta ke panggilan multi-pengguna

  1. Untuk mengaktifkan panggilan multi pengguna, Anda perlu mengaktifkan pemantauan kontak multi-pihak yang disempurnakan dari Amazon Connect konsol.

  2. Setelah ini selesai, Anda dapat memanfaatkan Amazon Connect StartWebRTCContactAPI yang ada untuk membuat kontak, dan merutekan kontak ini ke agen.

  3. Untuk menambahkan peserta tambahan, pertama-tama buat peserta yang lewat ContactId dari respons StartWebRTCContactAPI ke CreateParticipantAPI. CreateParticipanttidak akan berhasil sampai penelepon asli terhubung ke agen. Kemampuan video dan screenshare untuk peserta dapat diatur di ParticipantDetails.ParticipantCapabilities lapangan.

  4. Ketika berhasil CreateParticipantdiselesaikan, ia mengembalikan token peserta. Token ini dapat digunakan dalam permintaan CreateParticipantConnectiondengan Type set keWEBRTC_CONNECTION. Responsnya mencakup ConnectionDatayang dapat digunakan untuk bergabung dengan rapat menggunakan Library Klien SDK Amazon Chime untuk peserta tambahan yang dibuat. Ikuti petunjuk integrasi untuk memungkinkan pengguna akhir aplikasi Anda bergabung dalam rapat.

    catatan

    CreateParticipantmengembalikan kesalahan Permintaan Buruk jika agen belum terhubung ke kontak. Untuk aplikasi bisnis di mana pengguna dapat mencoba bergabung sebelum agen terhubung, lihatMenangani gabungan pengguna bersamaan.

  5. Pelanggan tambahan dapat terhubung kapan saja setelah CreateParticipantConnectionpengembalian. Setelah peserta bergabung, semua perilaku suara dan rekaman tambahan mirip dengan kemampuan multi partai. Peserta baru dapat mengaktifkan video dan berbagi layar mereka, jika kemampuan mereka telah diaktifkan dalam permintaan. CreateParticipant

    catatan

    Sebanyak hanya 6 peserta (pelanggan dan agen) yang dapat bergabung dengan panggilan aktif kapan saja. Library Klien Amazon Chime SDK menampilkan kode status yang menunjukkan panggilan berada pada kapasitas saat tindakan diambil untuk menambahkan peserta tambahan di luar batas yang terjadi selama pertemuan bergabung.

  6. Setelah peserta terhubung ke panggilan, dan kemudian terputus dengan anggun, atau tidak anggun untuk waktu yang telah dikonfigurasi sebelumnya, kredensi peserta mereka tidak lagi valid. Jika onAudioVideoDidStop pengamat pustaka klien menerima kode status yang menunjukkan peserta tidak lagi valid, aplikasi dapat memicu panggilan baru ke CreateParticipantdan CreateParticipantConnectiondari backend bisnis Anda untuk bergabung kembali dengan panggilan.

  7. Untuk setiap koneksi pengguna tambahan, Amazon Connect buat kontak baru dan catatan kontak. Semua kontak tambahan telah PreviousContactId disetel ke InitialContactId (yaitu, kontak yang dibuat oleh StartWebRTCContactAPI) untuk melacaknya ke kontak asli. Setiap catatan kontak:

    • Memiliki "InitiationMethod“: “WEBRTC_API

    • Memiliki atribut segmen berikut:

      "SegmentAttributes": { "connect:Subtype": { "ValueString": "connect:WebRTC" } },

    Selain itu, setiap catatan kontak memiliki nama tampilan yang disediakanCreateParticipant. Informasi agen tidak diisi untuk kontak pengguna tambahan apa pun. Hal ini untuk menghindari duplikasi informasi agen.

    Diagram berikut menggambarkan bagaimana kontak sebelumnya dan berikutnya IDs dipetakan dalam skenario di mana beberapa peserta dan agen ditambahkan dalam panggilan web, dalam aplikasi atau video.

    Diagram yang menunjukkan bagaimana kontak IDs dipetakan untuk panggilan WebRTC multi-pihak

Menangani gabungan pengguna bersamaan

Bisnis mungkin ingin membuat aplikasi di mana pengguna dapat bergabung dalam urutan apa pun, kapan saja. Misalnya, aplikasi Anda dapat mengirim email tautan dengan ID janji temu eksternal ke beberapa pengguna yang harus digunakan untuk bergabung dengan panggilan pada waktu yang dijadwalkan. Untuk mencapai perilaku ini, backend bisnis harus memastikan bahwa:

  • Pengguna pertama yang bergabung memicu permintaan. StartWeb RTCContact

  • Semua pengguna tambahan menggunakan CreateParticipant dan CreateParticipantConnection tetapi hanya setelah pengguna pertama terhubung ke agen.

Bagian ini menjelaskan kemungkinan implementasi, dengan asumsi bahwa backend bisnis Anda berisi toko (seperti DynamoDB) yang dapat menyimpan metadata tentang janji temu terjadwal. Perhatikan bahwa janji temu terjadwal bukanlah fitur Amazon Connect, tetapi implementasi contoh.

Ketika pengguna menavigasi ke halaman, mereka harus mengirim permintaan ke backend. Backend memeriksa:

  • Apakah pengguna dapat memulai janji temu, dan apakah itu waktu yang tepat.

  • Apakah Amazon Connect kontak sudah dibuat dengan menelepon StartWebRTCContact.

Jika kontak belum dibuat, pelanggan harus memanggil StartWebRTCContactAPI dengan alur kustom, dan Atribut yang menunjukkan antrian agen dari agen terkait yang diharapkan untuk bergabung dengan panggilan. Alur harus menyertakan blok antrian kerja Set yang dikonfigurasi untuk menggunakan antrian agen yang disediakan dalam atribut. Aliran kemudian harus diakhiri dengan blok Transfer ke antrian. Sebelum API dipanggil, backend harus memperbarui toko secara atomik untuk memindahkan panggilan dari status 'Tidak Ada' ke 'Membuat', dan menangani pengecualian modifikasi bersamaan.

Kredensi dari StartWebRTCContactharus dikembalikan ke pelanggan dan mereka harus segera bergabung dengan panggilan. Kontak harus ditandai sebagai 'Dibuat' di toko bisnis, bersama dengan ID Kontak. API bisnis ini perlu disinkronkan antara semua kemungkinan peserta yang bergabung. Ini dapat dilakukan dengan menggunakan operasi atom yang disediakan oleh DB.

Jika kontak dalam keadaan pembuatan, pengguna tambahan harus dikembalikan status ini, menampilkan informasi yang relevan, dan coba lagi setelah menunggu sebentar.

Jika kontak dibuat: Mereka harus mengambil ID kontak, dan memanggil DescribeContactAPI. Backend bisnis harus mencari lapangan. Contact.AgentInfo.ConnectedToAgentTimestamp Jika tidak ada, pengguna pertama belum terhubung ke agen, dan pengguna tambahan harus menampilkan informasi yang relevan, dan coba lagi setelah menunggu sebentar.

Jika bidang ada, backend harus memanggil CreateParticipant, dan kemudian, untuk mendapatkan CreateParticipantConnectionConnectionData, seperti yang dijelaskan di bagian sebelumnya.

Aliran backend akan terlihat seperti berikut ini.

Diagram alir backend untuk menangani gabungan pengguna bersamaan

Anda dapat merujuk ke contoh panggilan dalam aplikasi Amazon Connect GitHub untuk implementasi.

Agen tidak akan bergabung menggunakan situs web yang sama. Agen harus mengatur statusnya di Contact Control Panel ke Available. Ketika pelanggan pertama bergabung, agen dipanggil secara otomatis.

Penagihan

Penagihan untuk peserta tambahan setara dengan penagihan yang ada untuk pelanggan awal dan agen apa pun yang sedang menelepon. Audio, video, dan berbagi layar semuanya dikenakan biaya khusus peserta mereka sendiri.

Tahan perilaku

Selama sesi panggilan video atau berbagi layar, agen dapat melihat video atau berbagi layar peserta bahkan ketika peserta ditahan. Adalah tanggung jawab peserta untuk menangani PII sesuai dengan itu. Jika menggunakan aplikasi CCP asli, video agen dinonaktifkan jika ada peserta non-agen yang ditunda. Jika Anda ingin mengubah perilaku ini, Anda dapat membangun CCP kustom dan widget komunikasi.

Untuk informasi selengkapnya, lihat Integrasikan in-app, web, panggilan video, dan berbagi layar secara native ke dalam aplikasi Anda.

Batasan

Batasan berikut ada saat membuat peserta dalam aplikasi, web, panggilan video, dan berbagi layar tambahan:

  • Peserta tambahan tidak dapat mengatur kemampuan video ke Kirim, jika kontak asli dibuat dengan kemampuan video pelanggan yang disetel ke Tidak Ada.