Dokumen ini memberikan petunjuk tentang penginstalan aplikasi Zendesk dengan Contact Center AI Platform (CCAI Platform).
Prasyarat
Memiliki akses sebagai administrator ke portal CCAI Platform.
Memiliki akun Zendesk dengan paket Professional atau Enterprise.
Telah mendownload file aplikasi Zendesk:
Mulai
Aplikasi Zendesk bersifat pribadi. Aplikasi ini tidak tercantum di Zendesk App Marketplace publik. Anda dapat menghubungi perwakilan Zendesk untuk mendapatkan dan menginstalnya ke akun Zendesk Anda.
Penginstalan
Ikuti petunjuk di bawah untuk merujuk ke situs aplikasi Zendesk Mengupload dan menginstal aplikasi pribadi di Zendesk.
Mengupload dan menginstal aplikasi pribadi di Zendesk Support
Klik Setelan untuk membuka Pusat Admin.
Pilih Apps and Integrations > Zendesk Support App > Private App.
Klik Upload Aplikasi Pribadi.
Masukkan Nama untuk aplikasi. Contoh: (Call V1.4) (Chat V1.3)
Klik Pilih file dan pilih file zip untuk aplikasi pribadi Anda (ujet-zendesk-call-v1.4.zip atau ujet-zendesk-chat-v1.3.zip).
Klik Upload.
Di jendela yang muncul, klik Setuju dan upload Aplikasi ini.
Masukkan subdomain akun Anda.
Saat diminta, klik Instal.
Setelah proses selesai, aplikasi pribadi Anda akan muncul dalam daftar aplikasi yang diinstal di halaman Kelola Aplikasi.
Ulangi langkah-langkah jika aplikasi Panggilan dan Chat perlu diinstal.
Item konfigurasi berikut perlu disetel:
Nama Aplikasi: Sebaiknya gunakan Panggilan dan Chat.
Konfigurasi Aplikasi
Subdomain: Masukkan subdomain akun Anda. Misalnya: Instance, yaitu, instance.uc1.ccaiplatform.com.
Nama Domain: Biarkan sebagai nilai default: ue1.ccaipplatfrom.com.
Mengelola aplikasi
Aplikasi dapat dikelola melalui portal Zendesk.
Mengubah setelan aplikasi
Anda dapat mengubah setelan aplikasi yang diinstal, atau mengupdate aplikasi menggunakan link berikut dari Zendesk: Mengelola aplikasi yang diinstal.
Mengubah setelan untuk aplikasi, termasuk judul:
Di halaman Aplikasi Saya > Saat Ini Terinstal, temukan aplikasi yang ingin Anda ubah.
Klik menu opsi di aplikasi tempat Anda ingin mengubah setelan, lalu pilih Ubah setelan.
Lakukan perubahan yang Anda inginkan, lalu klik Perbarui. Perubahan Anda telah disimpan.
Anda juga dapat mengupdate aplikasi:
Di halaman Aplikasi Saya > Aplikasi Pribadi, temukan aplikasi yang ingin Anda update.
Klik menu Opsi, lalu pilih Perbarui.
Upload file ZIP yang telah diperbarui.
Menyiapkan klien OAuth
Aplikasi Zendesk menggunakan OAuth 2.0 untuk mengautentikasi permintaan API ke Zendesk. Anda harus menyiapkan klien OAuth untuk Aplikasi Zendesk.
Ikuti petunjuk ini atau lihat link berikut dari Zendesk: Menggunakan autentikasi OAuth dengan aplikasi Anda.
Mendaftarkan Aplikasi Anda
Di Pusat Admin Zendesk Support, klik Aplikasi dan Integrasi > Zendesk API.
Klik tab Klien OAuth di halaman Channels/API, lalu klik Tambahkan Klien OAuth di daftar klien.
Lengkapi kolom berikut untuk membuat klien:
Nama Klien: Masukkan nama untuk aplikasi Anda. Nama ini adalah nama yang akan dilihat pengguna saat diminta untuk memberikan akses ke aplikasi Anda, dan saat mereka memeriksa daftar aplikasi pihak ketiga yang memiliki akses ke Zendesk mereka.
Deskripsi: opsional. Ini adalah deskripsi singkat aplikasi Anda yang akan dilihat pengguna saat diminta untuk memberikan akses ke aplikasi tersebut.
Perusahaan: Opsional. Ini adalah nama perusahaan yang akan dilihat pengguna saat diminta untuk memberikan akses ke aplikasi Anda. Informasi ini dapat membantu mereka memahami siapa yang mereka beri akses.
Logo: Opsional. Ini adalah logo yang akan dilihat pengguna saat diminta untuk memberikan akses ke aplikasi Anda. Gambar dapat berupa JPG, GIF, atau PNG. Untuk hasil terbaik, upload gambar persegi. Gambar akan diubah ukurannya untuk halaman otorisasi.
ID Unik: Kolom ini diisi otomatis dengan versi nama yang Anda masukkan untuk aplikasi Anda yang diformat ulang. Anda dapat mengubahnya.
URL pengalihan: Masukkan URL yang harus digunakan Zendesk untuk mengirimkan keputusan pengguna terkait pemberian akses ke aplikasi Anda. URL harus absolut dan bukan relatif, https (kecuali localhost atau 127.0.0.1), dan dipisahkan dengan baris baru.
Jenis klien: Setelan ini harus disetel ke Rahasia. Jika setelan ini disetel ke Publik, Anda akan menerima pesan error Permintaan Otorisasi Tidak Valid saat mencoba memberikan otorisasi atau melakukan autentikasi di portal Platform CCAI atau adaptor agen.
Klik Simpan.
Setelah halaman dimuat ulang, kolom Secret baru yang telah diisi otomatis akan muncul. Ini adalah nilai "client_secret" yang ditentukan dalam spesifikasi OAuth2.
Salin nilai Secret ke papan klip Anda dan simpan di tempat yang aman.
Mengalihkan URL
Tetapkan URL pengalihan klien OAuth sebagai berikut,
https://INSTANCE.ccaiplatform.com/v1/zendesk/oauth_callback
Anda harus mengganti INSTANCE dengan subdomain sebenarnya dari Platform CCAI Anda.
ID Unik dan Rahasia
Kolom ID Unik dan Rahasia akan otomatis diisi saat menambahkan klien OAuth baru. Ini adalah nilai client_id dan client_secret dalam spesifikasi OAuth2.
Anda dapat mengedit ID Unik jika mau, tetapi tidak dapat mengedit Secret.
Secret ditampilkan sepenuhnya hanya sekali saat menambahkan klien baru. Pastikan kunci ini tetap aman.
Mengonfigurasi setelan aplikasi
Bagian ini menguraikan setelan aplikasi tertentu.
Mengonfigurasi OAuth
Login ke portal CCAI Platform sebagai pengguna administrator.
Buka Setelan > Setelan Developer.
Pilih Agent Platform Zendesk di bagian CRM.
Tetapkan Zendesk Subdomain ke subdomain akun Zendesk Anda.
https://your_zendesk_subdomain.zendesk.comTetapkan OAuth Client ID ke Unique Identifier klien OAuth Zendesk Anda.
Tetapkan OAuth Client Secret ke Secret klien OAuth Zendesk Anda.
Klik Simpan.
Buat Token API**
Langkah-langkah berikut memungkinkan Anda membuat token API di Zendesk:
Di Pusat Admin Zendesk Support, klik Aplikasi dan Integrasi > Zendesk API.
Klik tab Setelan, dan pastikan Akses Token diaktifkan.
Klik tombol Add API Token di sebelah kanan Active API Tokens.
Secara opsional, masukkan deskripsi di bagian Deskripsi Token API. Token dibuat, dan ditampilkan untuk Anda:
Salin token, lalu tempelkan di tempat yang aman.
- Klik Save untuk kembali ke halaman API. Versi token yang dipangkas akan ditampilkan.
Mengonfigurasi token API
Bagian berikut memberikan panduan tentang cara mengonfigurasi token API Zendesk.
Menetapkan Token API di setelan Admin
Login ke portal Platform CCAI dengan akun administrator, lalu buka Setelan > Setelan Developer.
Tetapkan API Token ke token API yang disalin dari klien Zendesk Anda.
Membuat kolom pelanggan dan tiket
Aplikasi membuat kolom kustom dan mengisi nilainya. Kita perlu membuat akun yang memiliki peran administrator dan agen.
Di portal CCAI Platform, buka Setelan > Tim Agen & Pengelola.
Pilih Tambahkan admin.
Centang Admin ini juga merupakan agen.
Aktifkan akun dari email undangan.
Logout dari akun administrator saat ini dan login dengan akun baru.
Login ke Zendesk dengan peran Admin (bukan peran Agen).
Di Zendesk, login menggunakan widget dengan kredensial yang merupakan administrator dengan peran agen.
Klik Otorisasi.
Di portal Platform CCAI, buka Setelan > Setelan Developer.
Buka bagian CRM > Customer fields for Contact and Ticket.
Klik Create.
Periksa apakah kolom tiket kustom dibuat dari Zendesk dengan melihat:
Admin > Kelola > Kolom Pengguna
Admin > Kelola > Kolom Tiket
Kolom
Kolom Pengguna
- ID
Bidang Tiket
Verifikasi (Kotak Centang)
Masukan Teks Pelanggan (Teks multibaris)
Rating Kepuasan Pelanggan (Numerik): 1 hingga 5
Rating Pelanggan yang Dibagikan (Teks): Twitter atau Facebook
Kontrol Akses Berbasis Domain
Lihat Kontrol Akses Berbasis Domain untuk mengetahui langkah-langkah membatasi akses platform berdasarkan domain dan detail yang terkait dengan domain khusus CRM.