Konfigurasi Zendesk

Halaman ini menjelaskan cara menyiapkan autentikasi dan izin sebelum membuat penyimpanan data Zendesk.

Mengaktifkan akses token

Agar Zendesk dapat mengautentikasi dan berinteraksi dengan instance Zendesk Anda, Anda harus mengaktifkan akses token. Ikuti langkah-langkah berikut untuk mengaktifkan akses token:

  1. Buka instance Zendesk Anda dan login dengan akun administrator.
  2. Di menu navigasi, luaskan Apps and integrations, lalu pilih API configuration dari APIs.
  3. Centang kotak Izinkan akses token API.
  4. Klik Simpan.

Menyiapkan autentikasi dan izin

Untuk integrasi yang aman menggunakan OAuth 2.0, Anda harus mendaftarkan aplikasi di Zendesk untuk mendapatkan client ID dan rahasia klien yang diperlukan.

Membuat klien OAuth dan mendapatkan kredensial autentikasi

Untuk membuat klien OAuth di Zendesk dan mendapatkan kredensial autentikasi, ikuti langkah-langkah berikut:

  1. Buka instance Zendesk Anda dan login dengan akun administrator.

  2. Klik ikon Produk Zendesk, lalu pilih Admin Center.

    Antarmuka Zendesk Admin Center.
    Pusat Admin Zendesk

  3. Di menu navigasi, luaskan Aplikasi dan integrasi, lalu pilih Klien OAuth dari API.

  4. Klik Tambahkan klien OAuth.

  5. Masukkan detail klien berikut:

    • Nama: Masukkan nama deskriptif untuk aplikasi Anda.
    • Opsional: Deskripsi: Masukkan deskripsi singkat.
    • Opsional: Perusahaan: Masukkan nama perusahaan Anda.
    • Opsional: Logo: Berikan logo, yang muncul di layar izin.
    • ID Unik (ID Klien): Berikan nama unik untuk klien Anda. Anda dapat mengedit saran awal, tetapi harus unik.
    • Jenis klien: Pilih Publik untuk aplikasi yang berjalan di browser atau di perangkat seluler, atau Rahasia untuk aplikasi yang berjalan di server yang aman.
    • URL pengalihan (Wajib): Masukkan https://vertexaisearch.cloud.google.com/oauth-redirect. Ini adalah URL yang menjadi tujuan pengalihan Zendesk setelah otorisasi, yang menerima kode otorisasi.

  6. Klik Simpan untuk mendapatkan rahasia klien.

    • ID Klien: Nilai dari kolom ID Unik.
    • Client secret: Kolom Secret baru akan muncul. Salin rahasia ini dan segera simpan di lokasi yang aman. Untuk keamanan, rahasia lengkap hanya ditampilkan satu kali. Jika Anda kehilangan kunci tersebut, Anda harus membuatnya kembali.
    Rahasia klien yang dibuat ditampilkan di antarmuka.
    Kredensial klien yang dibuat

  7. Klik Simpan lagi untuk menyelesaikan perubahan.

Menyiapkan izin

Untuk menyiapkan izin yang diperlukan, ikuti langkah-langkah berikut:

  1. Buka instance Zendesk Anda dan login dengan akun administrator.
  2. Klik ikon Produk Zendesk, lalu pilih Admin Center.
  3. Di menu navigasi, luaskan Aplikasi dan integrasi, lalu pilih Klien OAuth dari Koneksi.
  4. Klik Add client.

  5. Masukkan detail klien berikut:

    • Nama: Masukkan nama deskriptif. ID resource tidak dapat diubah.
    • Jenis pemberian OAuth: Pilih Kode otorisasi.
    • Client ID: Masukkan client ID yang diperoleh dari bagian Membuat klien OAuth di Zendesk.
    • Rahasia Klien: Masukkan nilai rahasia klien yang diperoleh dari bagian Membuat klien OAuth di Zendesk.
    • URL otorisasi: Endpoint otorisasi biasanya dalam format https://<var>your-subdomain</var>.zendesk.com/oauth/authorize. Ganti <var>your-subdomain</var> dengan subdomain Zendesk Anda yang sebenarnya.
    • URL token: Endpoint token biasanya dalam format https://<var>your-subdomain</var>.zendesk.com/oauth/token. Ganti <var>your-subdomain</var> dengan subdomain Zendesk Anda yang sebenarnya.
      Kolom untuk memasukkan cakupan API di Pusat Admin Zendesk.
      Menambahkan cakupan
    • Cakupan: Masukkan cakupan berikut yang dipisahkan dengan spasi, berdasarkan mode koneksi Anda:
    Mode koneksi Cakupan Tujuan Izin admin diperlukan
    Penelusuran gabungan read, users:read Memungkinkan penelusuran di seluruh data Zendesk. Tidak

  6. Klik Simpan.