View a markdown version of this page

Aktifkan panggilan dalam aplikasi, web, dan video multi-pengguna - Pelanggan Amazon Connect
Cara menambahkan pesertaMenangani gabungan bersamaanPenagihanTahan perilakuBatasan

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

Connect Customer mendukung penambahan pengguna tambahan untuk bergabung dengan panggilan dalam aplikasi, web, dan video dalam panggilan yang ada. Anda dapat menambahkan hingga empat pengguna tambahan ke dalam aplikasi, web, atau panggilan video yang sedang berlangsung atau terjadwal, 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 disempur nakan dari Connect Customer konsol.

  2. Setelah selesai, Anda dapat menggunakan Connect Customer StartWebRTCContact API yang ada untuk membuat kontak, dan merutekan kontak ini ke agen.

  3. Untuk menambahkan peserta tambahan, pertama-tama buat peserta yang mener ContactId uskan dari respons StartWebRTCContact API ke CreateParticipant API. CreateParticipanttidak akan berhasil sampai penelepon asli terhubung ke agen. Kemampuan berbagi video dan layar untuk peserta dapat diatur di ParticipantDetails.ParticipantCapabilities lapangan.

  4. Ketika CreateParticipant selesai dengan sukses, ia mengembalikan token peserta. Token ini dapat digunakan dalam permintaan ke CreateParticipantConnection dengan Type set toWEBRTC_CONNECTION. Tanggapan termasuk ConnectionData yang dapat digunakan untuk bergabung dengan rapat menggunakan Perpustakaan Klien Amazon Chime SDK untuk peserta tambahan yang dibuat. Ikuti petunjuk integrasi untuk memungkinkan pengguna akhir aplikasi Anda bergabung dengan rapat.

    catatan

    CreateParticipantmengembalikan kesalahan Bad Request jika agen belum terhubung ke kontak. Untuk aplikasi bisnis di mana pengguna mungkin mencoba bergabung sebelum agen terhubung, lihatMenangani gabungan pengguna bersamaan.

  5. Pelanggan tambahan dapat terhubung kapan saja setelah pengem CreateParticipantConnection balian. Setelah peserta bergabung, semua perilaku suara dan perekaman tambahan mirip dengan kemampuan multi pihak. 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. Pustaka Klien Amazon Chime SDK mengembalikan kode status yang menunjukkan panggilan dalam kapasitas saat tindakan diambil untuk menambahkan peserta tambahan di luar batas yang terjadi selama bergabung rapat.

  6. Setelah peserta terhubung ke panggilan, dan kemudian terputus dengan anggun, atau tidak anggun untuk waktu yang telah dikonfigurasi sebelumnya, kredenSIAL 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 CreateParticipant dan CreateParticipantConnection dari backend bisnis Anda untuk bergabung kembali dengan panggilan tersebut.

  7. Untuk setiap koneksi pengguna tambahan Connect Customer , buat kontak baru dan catatan kontak. Semua kontak tambahan PreviousContactId telah diset InitialContactId el ke (yaitu, yang dibuat oleh StartWebRTCContact API) 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 ID kontak sebelumnya dan berikutnya dipetakan dalam skenario di mana beberapa peserta dan agen ditambahkan dalam panggilan web, dalam aplikasi, atau panggilan video.

    ID kontak 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 mungkin 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 StartWebRTCContact permintaan.

  • 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 yang dijadwalkan bukan fitur Connect Customer, tetapi dari contoh implementasi.

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

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

  • Apakah Connect Customer kontak sudah dibuat dengan menelepon StartWebRTCContact.

Jika kontak belum dibuat, pelanggan harus memanggil StartWebRTCContact API dengan alur khusus, dan A tribut yang menunjukkan antrian agen dari agen terkait yang diharapkan bergabung dengan panggilan. Alur harus menyertakan blok Set antrian kerja yang dikonfigurasi untuk menggunakan antrian agen yang disediakan dalam atribut. Alur kemudian harus diakhiri dengan blok Transfer ke antrean. Sebelum API dipanggil, backend harus memperbarui penyimpanan secara atomik untuk memindahkan panggilan dari status 'None' ke 'Creating', dan menangani pengecualian modifikasi bersamaan.

KredenSIAL dari StartWebRTCContact harus 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 peserta yang mungkin bergabung. Ini dapat dilakukan dengan menggunakan operasi atom yang disediakan oleh DB.

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

Jika kontak dibuat: Mereka harus mengambil ID kontak, dan memanggil DescribeContact API. Backend bisnis harus mencari Contact.AgentInfo.ConnectedToAgentTimestamp lapangan. 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 CreateParticipantConnection ConnectionData, seperti yang dijelaskan di bagian sebelumnya.

Alur backend akan terlihat seperti berikut ini.

Diagram alir backend untuk menangani gabungan pengguna bersamaan.

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

Agen tidak akan bergabung menggunakan situs web yang sama. Agen harus mengatur statusnya di Panel Kontrol Kontak ke Ter sedia. 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 pada panggilan. Audio, video, dan berbagi layar semuanya dikenakan biaya khusus peserta sendiri.

Tahan perilaku

Selama sesi panggilan video atau berbagi layar, agen dapat melihat video atau berbagi layar peserta bahkan ketika peserta ditunda. 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 membuat CCP kustom dan widget komunikasi.

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

Batasan

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

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