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

# Integrasi Zendesk Suite
<a name="zendesk-integration"></a>

Kelola tiket dukungan Zendesk Anda langsung dari Amazon Quick menggunakan bahasa alami. Dengan konektor aksi Zendesk Suite, Anda dapat membuat, memperbarui, mencari, dan membuat daftar tiket dukungan tanpa meninggalkan Amazon Quick.

Zendesk Suite tersedia sebagai konektor bawaan di Amazon Quick. Untuk mengatur integrasi ini, selesaikan dua langkah berikut. Pertama, siapkan akun Zendesk Anda dengan akses yang diperlukan. Kemudian, buat konektor di Amazon Quick dan autentikasi dengan kredensi Zendesk Anda.

Konektor ini mendukung otentikasi pengguna OAuth dan otentikasi layanan kunci API. Untuk informasi tentang metode otentikasi yang didukung Amazon Quick, lihat[Metode autentikasi](quick-action-auth.md).

## Prasyarat
<a name="zendesk-integration-prerequisites"></a>

Sebelum Anda mengatur integrasi, verifikasi bahwa Anda memiliki sumber daya dan akses berikut.
+ Akun Zendesk aktif dengan peran admin.
+ Izin untuk mengakses tiket dan data dukungan di instans Zendesk Anda.
+ Langganan yang memenuhi persyaratan yang dijelaskan dalam[Siapkan integrasi di konsol](integration-console-setup-process.md).

## Verifikasi akun Zendesk Anda
<a name="zendesk-account-setup"></a>

Sebelum Anda mengonfigurasi Amazon Quick, verifikasi bahwa akun Zendesk Anda memenuhi persyaratan berikut.
+ Akun Zendesk Anda aktif dan Anda dapat masuk ke [halaman masuk Zendesk](https://www.zendesk.com/login/) di situs web Zendesk.
+ Tiket dan data dukungan yang ingin Anda akses dapat diakses ke akun Anda.

## Konfigurasikan akun Zendesk
<a name="zendesk-configure-account"></a>

Metode otentikasi aplikasi OAuth Kustom di Amazon Quick memerlukan klien OAuth yang dikonfigurasi di Zendesk. Metode otentikasi kunci API memerlukan token API.

### Untuk mengkonfigurasi klien OAuth
<a name="zendesk-configure-oauth"></a>

1. **Dalam instance Zendesk Anda, navigasikan ke **Pusat Admin**, lalu **Aplikasi dan integrasi**, lalu klien **OAuth** di bawah API.**

1. Pilih **Tambahkan Klien OAuth**.

1. Lengkapi formulir dengan bidang-bidang berikut:
   + **Nama** — Masukkan nama untuk aplikasi Anda.
   + **Deskripsi** — Masukkan deskripsi singkat.
   + **Identifier** - Masukkan pengenal unik untuk klien OAuth.
   + **Redirect URL — Enter**. `https://{{region}}.quicksight.aws.amazon.com/sn/oauthcallback` Ganti {{region}} dengan AWS Wilayah Anda, misalnya,`us-east-1`.

1. Pilih **Simpan**. Zendesk menghasilkan rahasia klien.
**penting**  
Rekam rahasia klien sekarang. Anda tidak dapat mengambilnya setelah Anda meninggalkan halaman ini.

1. Setelah Anda menangkap rahasia, pilih **Simpan** lagi untuk membuat klien OAuth.

Pengenal dan rahasia berfungsi sebagai ID Klien dan Rahasia Klien saat Anda mengonfigurasi konektor tindakan di Amazon Quick dengan metode otentikasi aplikasi OAuth Kustom.

Untuk informasi selengkapnya, lihat [Menggunakan otentikasi OAuth dengan aplikasi Anda](https://support.zendesk.com/hc/en-us/articles/4408845965210-Using-OAuth-authentication-with-your-application) di situs web Zendesk.

### Untuk mengonfigurasi token API
<a name="zendesk-configure-api-token"></a>

1. Arahkan ke **Pusat Admin**, lalu **Aplikasi dan integrasi**, lalu **token API**.

1. Pilih **Tambahkan token API**.

1. Untuk **Deskripsi**, masukkan deskripsi singkat untuk token API.

1. Pilih **Simpan**. Zendesk menghasilkan token API.
**penting**  
Rekam token API sekarang. Anda tidak dapat mengambilnya setelah Anda meninggalkan halaman ini.

Jika Anda memilih metode otentikasi kunci API di Amazon Quick, gunakan token API ini sebagai nilai kunci API.

Untuk informasi selengkapnya, lihat [Mengelola akses token API ke Zendesk API](https://support.zendesk.com/hc/en-us/articles/4408889192858-Managing-API-token-access-to-the-Zendesk-API) di situs web Zendesk.

## Siapkan integrasi di Amazon Quick
<a name="zendesk-integration-setup"></a>

Setelah Anda memverifikasi akses akun Zendesk Anda, buat konektor di Amazon Quick.

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

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

1. Pilih **Zendesk Suite** dari opsi yang tersedia. 

1. Dalam dialog **Zendesk Suite**, masukkan bidang berikut:
   + **Nama — Nama** deskriptif untuk konektor Zendesk Anda.
   + **Deskripsi (Opsional)** — Pilih **\+ Tambahkan Deskripsi** untuk menambahkan catatan tentang bagaimana konektor ini akan digunakan.
   + **Jenis koneksi** - Pilih **Jaringan publik**.

1. Pilih metode otentikasi Anda dan konfigurasikan pengaturan konektor:
   + **Aplikasi OAuth khusus** - Masukkan bidang berikut untuk instance Zendesk Anda:
     + **URL dasar**
     + **ID Klien**
     + **Rahasia Klien**
     + **URL Token**
     + **URL Otorisasi**
     + **URL pengalihan**
   + **API Key** - Masukkan kolom berikut:
     + **URL dasar**
     + **Kunci API** (token API Zendesk)
     + **Email** yang terkait dengan akun Zendesk Anda

1. Pilih **Berikutnya**.

1. Tinjau tindakan untuk Zendesk Suite dan pilih **Berikutnya**.

1. Tentukan siapa yang dapat mengakses konektor:
   + Untuk berbagi dengan tim, masukkan nama tim atau email grup.
   + Untuk menjaganya tetap pribadi, biarkan bidang kosong.
   + Untuk berbagi dengan semua pengguna, alihkan **Semua orang di organisasi Anda**.

1. Pilih **Terbitkan**.

Konektor muncul di panel **yang tersedia** dengan status **Terhubung**.

## Tindakan yang tersedia
<a name="zendesk-integration-actions"></a>

Setelah Anda mengatur konektor, Anda dapat menggunakan tindakan manajemen tiket berikut.


**Tindakan Zendesk Suite tersedia**  

| Tindakan | Deskripsi | 
| --- | --- | 
| Buat Tiket | Buat tiket baru | 
| Daftar Hasil Pencarian | Cari tiket | 
| Daftar Tiket | Lihat semua tiket | 
| Tunjukkan Tiket | Lihat detail tiket | 
| Perbarui Tiket | Edit detail tiket | 

**catatan**  
Tindakan yang dapat Anda gunakan bergantung pada izin yang dikonfigurasi di akun Zendesk Anda.

## Pemecahan masalah
<a name="zendesk-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="zendesk-troubleshooting-auth"></a>
+ **Sign-in gagal** — Verifikasi bahwa akun Zendesk Anda aktif dan Anda dapat masuk ke [halaman masuk Zendesk](https://www.zendesk.com/login/) di situs web Zendesk. Jika organisasi Anda menggunakan sistem masuk tunggal (SSO), konfirmasikan bahwa penyedia identitas Anda dikonfigurasi dengan benar.
+ **Akses ditolak** — Konfirmasikan bahwa pengguna Zendesk Anda memiliki peran admin dengan izin untuk mengakses tiket dan data dukungan. Untuk koneksi kunci API, verifikasi bahwa token API valid dan alamat email terkait sudah benar.