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

# ZoomInfo integrasi
<a name="zoominfo-integration"></a>

Dengan konektor ZoomInfo tindakan, Anda dapat mencari data perusahaan dan kontak, serta menanyakan data firmografis dan maksud langsung di Amazon Quick melalui bahasa alami.

Amazon Quick mendukung beberapa metode otentikasi untuk ZoomInfo. 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 ZoomInfo akun mereka.
+ Aplikasi **OAuth khusus - Menggunakan aplikasi** OAuth yang dikelola pelanggan. Opsi ini memberi organisasi Anda kontrol penuh atas konfigurasi OAuth.
+ **Service-to-Service OAuth** — Menggunakan kredensi klien untuk otentikasi server-ke-server tanpa interaksi pengguna. Cocokkan untuk alur kerja otomatis.
+ **API Key** — Menggunakan kunci API untuk otentikasi.

Untuk informasi selengkapnya tentang metode otentikasi yang didukung Amazon Quick, lihat[Metode autentikasi](quick-action-auth.md).

## Sebelum Anda mulai
<a name="zoominfo-integration-prerequisites"></a>

Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.
+  ZoomInfo Akun aktif dengan akses ke produk data yang ingin Anda kueri.
+ Untuk **aplikasi Custom OAuth** atau OAuth: kredensi **Service-to-Service OAuth** dari administrator Anda. ZoomInfo ZoomInfo menggunakan Okta untuk OAuth.
+ Untuk **Kunci API**: Kunci ZoomInfo-issued API.
+ Untuk persyaratan berlangganan Amazon Quick, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).

## Mengkonfigurasi ZoomInfo
<a name="zoominfo-source-setup"></a>

Jika Anda menggunakan otentikasi **aplikasi OAuth Default**, lewati bagian ini dan lanjutkan ke. [Menyiapkan konektor di Amazon Quick](#zoominfo-quicksuite-setup)

Untuk aplikasi Custom OAuth atau otentikasi Service-to-Service OAuth, bekerja sama dengan ZoomInfo administrator Anda untuk mendaftarkan klien OAuth di ZoomInfo penyewa Okta dan menambahkan URL callback Amazon Quick sebagai URI pengalihan. `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` Ganti {{{region}}} dengan AWS Wilayah Anda (misalnya,`us-east-1`). Untuk petunjuk langkah demi langkah, lihat [Ringkasan ZoomInfo MCP](https://docs.zoominfo.com/docs/zi-api-mcp-overview/) dan [Panduan Portal Pengembang](https://docs.zoominfo.com/docs/app-creation-developer-portal-guide) dalam ZoomInfo dokumentasi. Rekam ID Klien dan Rahasia Klien — Anda memerlukannya saat mengonfigurasi Amazon Quick. Untuk autentikasi API Key, buat kunci API dari ZoomInfo akun Anda.

## Menyiapkan konektor di Amazon Quick
<a name="zoominfo-quicksuite-setup"></a>

### Connect dari tab Tersedia
<a name="zoominfo-quick-connect"></a>

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 **ZoomInfo**dan pilih **Connect**.

1.  ZoomInfo Selesaikan alur masuk dan berikan izin yang diminta.

Untuk mengonfigurasi konektor dengan salah satu metode otentikasi lainnya, gunakan tab **Buat untuk tim Anda** seperti yang dijelaskan di bawah ini.

### Buat dari tab Buat untuk tim Anda
<a name="zoominfo-full-setup"></a>

1. Di konsol Amazon Quick, pilih **Konektor**.

1. Pilih tab **Buat untuk tim Anda**.

1. Temukan dan pilih **ZoomInfo**.

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:
      + **ID Klien** — ID klien dari klien ZoomInfo OAuth Anda.
      + **Klien OAuth Publik** (Opsional) - Pilih opsi ini jika klien ZoomInfo OAuth Anda dikonfigurasi sebagai klien publik (tidak ada rahasia klien).
      + **Rahasia klien — Rahasia** klien dari klien ZoomInfo OAuth Anda.
      + **URL Token** — Titik akhir token. Default: `https://okta-login.zoominfo.com/oauth2/default/v1/token`
      + **URL otorisasi** — Titik akhir otorisasi. Default: `https://okta-login.zoominfo.com/oauth2/default/v1/authorize`
      + **Redirect URL** — Pre-filled dengan URL callback Amazon Quick.

   1. Untuk **Service-to-ServiceOAuth**, konfigurasikan bidang berikut:
      + **ID Klien** — ID klien dari klien ZoomInfo OAuth Anda.
      + **Rahasia klien — Rahasia** klien dari klien ZoomInfo OAuth Anda.
      + **URL Token** — Titik akhir token. Default: `https://okta-login.zoominfo.com/oauth2/default/v1/token`

   1. Untuk **API Key**, konfigurasikan bidang berikut:
      + **API Key** — Kunci ZoomInfo API.
      + **Email** (Opsional) — Alamat email yang terkait dengan kunci API.

1. Pilih **Berikutnya**.

1. Jika Anda memilih aplikasi **OAuth Default atau aplikasi** **Custom OAuth, jendela otorisasi** akan terbuka. ZoomInfo 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
<a name="zoominfo-integration-actions"></a>

Setelah Anda mengatur konektor, tindakan yang diekspos oleh ZoomInfo tersedia. Untuk melihat rangkaian tindakan saat ini untuk konektor Anda, buka tampilan **Tindakan yang tersedia** konektor di konsol Amazon Quick.

## Mengelola dan memecahkan masalah
<a name="zoominfo-integration-troubleshooting"></a>

Untuk mengedit, membagikan, atau menghapus konektor Anda, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).

### Masalah otentikasi
<a name="zoominfo-troubleshooting-auth"></a>
+ **Sign-in gagal (Aplikasi OAuth default atau aplikasi Custom OAuth)** — Verifikasi bahwa akun Anda ZoomInfo aktif. Untuk aplikasi Custom OAuth, konfirmasikan bahwa URI pengalihan di ZoomInfo klien OAuth Anda cocok dengan URL callback Amazon Quick.
+ **Kredensi klien tidak valid (aplikasi OAuth khusus atau Service-to-Service OAuth)** — Verifikasi bahwa ID Klien dan rahasia Klien cocok dengan nilai di klien OAuth Anda. ZoomInfo 
+ **Otentikasi Kunci API gagal** — Verifikasi bahwa kunci API belum dicabut.