Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Integrasi zoom
Dengan konektor aksi Zoom, Anda dapat mengakses platform Zoom langsung di Amazon Quick melalui bahasa alami. Anda dapat membuat dan mengelola rapat, mengakses rekaman dan ringkasan rapat, melihat detail webinar, dan mencari kontak tanpa meninggalkan Amazon Quick.
Amazon Quick mendukung beberapa metode otentikasi untuk Zoom. Pilih metode yang paling sesuai dengan persyaratan keamanan organisasi Anda.
+ Aplikasi **OAuth default — Menggunakan aplikasi** OAuth yang AWS dikelola. Tidak diperlukan kredensi tambahan. Pengguna mengautentikasi langsung dengan akun Zoom mereka.
+ Aplikasi **OAuth khusus - Menggunakan aplikasi** OAuth yang dikelola pelanggan yang terdaftar di Zoom App Marketplace. Opsi ini memberi organisasi Anda kontrol penuh atas konfigurasi OAuth.
Untuk informasi selengkapnya tentang metode otentikasi yang didukung Amazon Quick, lihat[Metode autentikasi](quick-action-auth.md).
## Sebelum Anda mulai
Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.
+ Akun Zoom aktif dengan akses ke rapat, rekaman, dan webinar yang ingin Anda gunakan.
+ Untuk aplikasi **OAuth Kustom: Akses ke Marketplace Aplikasi** [Zoom](https://marketplace.zoom.us/) di situs web Zoom untuk membuat aplikasi.
+ Untuk persyaratan berlangganan Amazon Quick, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).
## Mengkonfigurasi Zoom
Jika Anda menggunakan otentikasi **aplikasi OAuth Default**, lewati bagian ini dan lanjutkan ke. [Menyiapkan konektor di Amazon Quick](#zoom-quicksuite-setup)
Untuk otentikasi aplikasi OAuth Kustom, selesaikan langkah-langkah berikut di Marketplace Aplikasi Zoom sebelum mengonfigurasi Amazon Quick.
### Buat aplikasi Zoom (aplikasi OAuth Kustom)
Buat aplikasi di Marketplace Aplikasi Zoom untuk mendapatkan kredensi klien yang Anda butuhkan untuk Amazon Quick. Untuk informasi selengkapnya, lihat [OAuth](https://developers.zoom.us/docs/integrations/oauth/) di situs web Pengembang Zoom.
1. Masuk ke [Marketplace Aplikasi Zoom](https://marketplace.zoom.us/) di situs web Zoom dan buka portal pembuatan aplikasi.
1. Buat aplikasi baru. Pilih **Umum** untuk OAuth berbasis pengguna atau **Server-to-Server OAuth** untuk otentikasi layanan-ke-layanan.
1. Pada tab **Informasi Dasar**, di bawah **Kredensial Aplikasi**, catat nilai berikut. Anda membutuhkannya saat mengonfigurasi Amazon Quick.
+ **ID Klien**
+ **Rahasia klien**
1. Di bagian **Informasi OAuth**, untuk **URI Pengalihan Resmi, tambahkan URL** callback Cepat Amazon: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`
1. Pilih tab **Scopes** dan pilih **\+ Add Scopes** untuk memilih izin yang diperlukan integrasi Anda. Untuk cakupan yang direkomendasikan, lihat[Cakupan yang direkomendasikan](#zoom-oauth-scopes).
### Cakupan yang direkomendasikan
Cakupan berikut diminta saat Anda terhubung ke Zoom. Saat Anda membuat aplikasi Zoom kustom, tambahkan cakupan ini di tab **Scopes**.
**Zoom cakupan yang direkomendasikan**
| Lingkup | Deskripsi |
| --- | --- |
| meeting:read:list\_meetings | Daftar pertemuan. |
| meeting:read:meeting | Membaca detail rapat. |
| meeting:read:summary | Membaca ringkasan pertemuan. |
| meeting:read:list\_past\_participants | Daftar peserta rapat sebelumnya. |
| meeting:read:list\_past\_instances | Daftar contoh pertemuan sebelumnya. |
| meeting:write:meeting | Membuat rapat. |
| meeting:update:meeting | Memperbarui rapat. |
| meeting:delete:meeting | Menghapus rapat. |
| meeting:write:registrant | Menambahkan pendaftar rapat. |
| cloud\_recording:read:list\_user\_recordings | Daftar rekaman pengguna. |
| cloud\_recording:read:list\_recording\_files | Daftar file rekaman. |
| cloud\_recording:delete:meeting\_recording | Menghapus rekaman rapat. |
| webinar:read:webinar | Membaca detail webinar. |
| webinar:read:list\_webinars | Daftar webinar. |
| webinar:read:list\_past\_participants | Daftar peserta webinar sebelumnya. |
| webinar:read:list\_registrants | Daftar pendaftar webinar. |
| webinar:write:registrant | Menambahkan pendaftar webinar. |
| user:read:user | Membaca informasi pengguna. |
| user:read:settings | Membaca pengaturan pengguna. |
| user:read:list\_collaboration\_devices | Daftar perangkat kolaborasi. |
| contact:read:list\_contacts | Daftar kontak. |
**catatan**
Cakupan tambahan untuk fitur papan tulis dan pasar juga diminta. Cakupan yang tercantum di atas mencakup pertemuan utama, rekaman, webinar, pengguna, dan tindakan kontak.
## Menyiapkan konektor di Amazon Quick
### Connect dari tab Tersedia
Jika Anda ingin menggunakan otentikasi aplikasi OAuth Default, Anda dapat terhubung langsung dari tab **Tersedia** tanpa konfigurasi tambahan.
1. Di konsol Amazon Quick, pilih **Konektor**.
1. Pada tab **Tersedia**, temukan **Zoom** dan pilih **Connect**.
1. Selesaikan alur masuk Zoom dan berikan izin yang diminta.
Untuk mengonfigurasi konektor dengan aplikasi Custom OAuth sebagai gantinya, gunakan tab **Buat untuk tim Anda** seperti yang dijelaskan di bawah ini.
### Buat dari tab Buat untuk tim Anda
Setelah Anda menyelesaikan konfigurasi Zoom yang diperlukan, buat konektor di Amazon Quick.
1. Di konsol Amazon Quick, pilih **Konektor**.
1. Pilih tab **Buat untuk tim Anda**.
1. Temukan dan pilih **Zoom**.
**catatan**
Jika konektor Zoom sudah ada, dialog akan muncul dengan konektor yang ada. Untuk menggunakan konektor yang ada, pilihlah. Untuk membuat yang baru, pilih **Tidak, buat yang baru**.
1. Masukkan **Nama** untuk konektor Anda. Secara opsional, pilih **\+ Tambahkan Deskripsi** untuk menambahkan deskripsi.
1. Untuk **jenis Koneksi**, pilih **Jaringan publik**.
1. Untuk **Konfigurasi OAuth**, pilih salah satu metode otentikasi berikut dan konfigurasikan bidang yang diperlukan.
1. Untuk aplikasi **OAuth Default**:
Tidak diperlukan kredensi tambahan. Pilih **Next** untuk melanjutkan.
1. Untuk **aplikasi Custom OAuth**, konfigurasikan bidang berikut:
+ **URL Dasar** (Opsional) - URL dasar API Zoom. Contoh: `https://api.zoom.us`
+ **ID Klien** — ID klien dari aplikasi Zoom Anda.
+ **Rahasia klien** — Rahasia klien dari aplikasi Zoom Anda.
+ **URL Token** — Titik akhir token. Contoh: `https://zoom.us/oauth/token`
+ **URL otorisasi** — Titik akhir otorisasi. Contoh: `https://zoom.us/oauth/authorize`
+ **Redirect URL** — Pre-filled dengan URL callback Amazon Quick.
1. Pilih **Berikutnya**.
1. Jika Anda memilih aplikasi **OAuth Default atau aplikasi** **Custom OAuth, jendela otorisasi** Zoom akan terbuka. Tinjau izin yang diminta dan pilih **Izinkan**.
1. Pada halaman **Ulasan**, tinjau tindakan yang tersedia untuk konektor. Pilih **Berikutnya**.
1. Pada halaman **Publikasikan**, pilih siapa yang dapat mengakses konektor. Anda dapat mengaktifkan akses untuk semua orang di organisasi Anda atau mencari tim atau grup tertentu.
1. Pilih **Terbitkan**.
## Tindakan yang tersedia
Setelah Anda mengatur konektor, tindakan berikut tersedia.
**Memperbesar tindakan yang tersedia**
| Kategori | Tindakan | Deskripsi |
| --- | --- | --- |
| Rapat | Daftar Rapat | Daftar rapat untuk pengguna. |
| Rapat | Dapatkan Rapat | Mengambil detail untuk pertemuan tertentu. |
| Rapat | Buat Rapat | Membuat pertemuan baru. |
| Rapat | Perbarui Rapat | Memperbarui rapat yang ada. |
| Rapat | Dapatkan Ringkasan Rapat | Mengambil AI-generated ringkasan untuk rapat. |
| Rapat | Daftar Template Ringkasan Rapat | Daftar templat ringkasan rapat yang tersedia. |
| Rapat | Dapatkan Peserta Rapat Sebelumnya | Mengambil peserta dari pertemuan sebelumnya. |
| Rapat | Daftar Contoh Rapat Sebelumnya | Daftar contoh pertemuan berulang. |
| Rapat | Buat Pendaftar Rapat | Menambahkan pendaftar ke rapat. |
| Rekaman | Daftar Rekaman | Daftar semua rekaman untuk pengguna. |
| Rekaman | Dapatkan Rekaman Rapat | Mengambil rekaman untuk pertemuan tertentu. |
| Rekaman | Daftar File yang Diarsipkan | Daftar file rekaman yang diarsipkan. |
| Webinar | Daftar Webinar | Daftar webinar untuk pengguna. |
| Webinar | Dapatkan Webinar | Mengambil detail untuk webinar tertentu. |
| Webinar | Daftar Peserta Webinar | Daftar peserta untuk webinar. |
| Kontak | Cari Kontak Perusahaan | Mencari kontak di direktori perusahaan. |
| Perangkat | Daftar Perangkat | Daftar perangkat Zoom. |
| Laporan | Dapatkan Laporan Penggunaan Harian | Mengambil laporan penggunaan harian. |
| Pengguna | Dapatkan Pengguna | Mengambil informasi tentang pengguna yang diautentikasi. |
**catatan**
Tindakan yang dapat Anda gunakan bergantung pada izin yang dikonfigurasi untuk akun Zoom Anda dan data yang dapat diakses oleh pengguna yang diautentikasi.
## Mengelola dan memecahkan masalah
Untuk mengedit, membagikan, atau menghapus konektor Anda, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).
### Masalah otentikasi
+ **Sign-in gagal (Aplikasi OAuth default atau aplikasi Custom OAuth)** — Verifikasi bahwa akun Zoom Anda aktif dan Anda dapat masuk ke [zoom.us](https://zoom.us) di situs web Zoom secara langsung. Untuk aplikasi Custom OAuth, konfirmasikan bahwa URI pengalihan di aplikasi Zoom cocok dengan URL callback Amazon Quick.
+ **Kredensi klien tidak valid (aplikasi OAuth Kustom)** — Verifikasi bahwa ID Klien dan rahasia Klien cocok dengan nilai di aplikasi Zoom Anda. Anda dapat melihat kredensialnya dari setelan aplikasi di Marketplace Aplikasi Zoom.
+ **Izin tidak memadai** — Pastikan cakupan yang dikonfigurasi untuk aplikasi Zoom Anda menyertakan izin yang diperlukan untuk tindakan yang ingin Anda gunakan. Lihat [Cakupan yang direkomendasikan](#zoom-oauth-scopes).