Panduan penginstalan Salesforce

Panduan penginstalan Salesforce untuk Salesforce versi 1.41.

Edisi Salesforce Professional, Enterprise, Performance, Unlimited, dan Developer semuanya terintegrasi dengan Contact Center AI Platform (CCAI Platform).

Peringatan: Salesforce versi Essentials tidak didukung.

Catatan: Kontrol akses berbasis domain memberikan kemampuan untuk menentukan dan mengontrol domain mana yang dapat menampilkan adaptor agen Platform CCAI. Ini adalah langkah penerapan prasyarat. Pastikan untuk menambahkan semua domain yang diperlukan di Setelan Developer Platform CCAI. Jika hal ini tidak dilakukan, adaptor agen dapat gagal. Menambahkan domain di Setelan Developer dapat menyebabkan gangguan sementara pada kemampuan adaptor. Oleh karena itu, sebaiknya lakukan tugas ini saat volume panggilan rendah atau selama periode pemeliharaan terjadwal. Untuk mengetahui informasi selengkapnya, lihat Kontrol akses berbasis domain.

Dukungan untuk Salesforce Classic & Lightning

Link penginstalan: Salesforce Enterprise 1.41

Langkah-langkah penginstalan

Adaptor Agen yang diinstal di Salesforce memungkinkan agen menerima panggilan dan chat langsung di Organisasi (Org.) Salesforce. Versi setelah 1.17 mendukung Pengalaman Klasik dan Lightning Experience.

Penginstalan terdiri dari langkah-langkah berikut:

1. Temukan ID Org dan Nama Org, lalu tambahkan ke portal

2. Menginstal aplikasi di Salesforce

3. Masukkan kunci konsumen dan secret aplikasi terhubung ke portal

4. Membuat aplikasi terhubung

5. Tempatkan kunci dan rahasia konsumen aplikasi terhubung di portal

6. Mengelola konfigurasi di Salesforce

7. Mengelola pusat panggilan

Data yang diperlukan untuk melakukan penginstalan

Nama Kolom	Tempat Menemukan	Tempat Memasukkan
ID Organisasi	Salesforce	Setelan Developer di Portal
Nama Organisasi	Salesforce	Setelan Developer di Portal
Kunci Pengguna Aplikasi Terhubung	Salesforce	Setelan Developer di Portal
Rahasia Pengguna Aplikasi Terhubung	Salesforce	Setelan Developer di Portal
Nama tenant	Admin Portal <companyName>.<domain>	Setelan Kustom di SFDC
Kunci Pelanggan	Setelan Developer	Setelan Kustom di SFDC
Rahasia	Setelan Developer	Setelan Kustom di SFDC
Aplikasi Terhubung	Aplikasi Terhubung Salesforce	Setelan Kustom di SFDC

Menemukan ID Org. dan Nama Org. serta Menambahkan ke Portal

Di bagian ini, Anda akan menyiapkan koneksi awal antara portal Platform CCAI dan Salesforce dengan menemukan informasi org yang diperlukan dan menambahkannya ke portal Platform CCAI.

Prasyarat

• Akses ke halaman Informasi Perusahaan dalam Salesforce.

• Pengguna dengan peran Admin yang ditetapkan di Portal untuk mengakses Setelan developer

Langkah-langkah penginstalan

1. Di Salesforce, buka Setup > Settings > Company Settings > Company Information.

   Tips: Gunakan kotak penelusuran Quick Find di Setelan Salesforce untuk membuka berbagai halaman dalam konfigurasi ini dengan cepat.

2. Temukan Nama Organisasi dan ID Organisasi Salesforce.com di Informasi Perusahaan.

3. Salin kedua nilai.

4. Di tab browser lain, buka portal Platform CCAI.

5. Buka Setelan > Setelan Developer > CRM > Platform Agen.

6. Pilih Salesforce.

7. Cari kolom ID Organisasi Salesforce dan Nama Organisasi Salesforce.

8. Masukkan Salesforce Organization ID ke kolom ID Organisasi Salesforce dan Salesforce Organization Name ke kolom Nama Organisasi Salesforce.

9. Klik Simpan.

Menginstal Aplikasi di Salesforce

Pada langkah ini, kita akan menginstal aplikasi di Salesforce.

Prasyarat

Pengguna Salesforce harus memiliki hak istimewa untuk menginstal paket ke dalam Organisasi.

1. Ambil link Penginstalan Paket.

2. Login ke Salesforce jika diminta untuk melakukannya.

3. Pilih Instal untuk Semua Pengguna.

   

4. Pilih Instal (atau Upgrade jika Org Anda menggunakan versi sebelumnya). Proses ini mungkin memerlukan waktu beberapa menit.

5. Setelah penginstalan selesai, klik Selesai.

   Untuk memverifikasi penginstalan paket di Salesforce, buka Platform Tools > Apps > Packaging > Installed Packages.

Membuat set izin kustom dan menerapkannya ke semua agen

Di bagian ini, Anda akan membuat set izin kustom (dengan persyaratan minimum yang diperlukan untuk integrasi), memperbaruinya dengan izin kasus dan kontak, serta menerapkannya ke semua agen yang menggunakan portal Platform CCAI.

Prasyarat

• Pengguna harus menjadi Admin Salesforce untuk mengonfigurasi bagian ini.

• Daftar agen yang akan menggunakan adaptor di Salesforce.

Langkah

1. Di Salesforce, buka Administration > Users > Permission Sets.

2. Temukan Set Izin CC_Agent, lalu klik link Clone.

3. Ganti nama Set Izin yang di-clone, lalu klik Simpan. Misalnya Company_Agent_Clone.

4. Dari layar Permission Sets, klik nama Set Izin yang baru dikloning.

5. Klik Setelan Objek di bagian Aplikasi.

6. Konfigurasi Setelan Objek untuk Akun, Kasus, Kontak, dan Prospek menggunakan tabel ini:

Objek	Baca	Buat	Edit	Hapus	Lihat Semua	Ubah Semua
Kasus	X	X	X		X
Kontak	X	X	X		X
Akun	X	X	X		X
Prospek	X	X	X		X

1. Untuk mengonfigurasi setelan ini, klik Nama Objek. Klik Edit (di bagian atas).

2. Gunakan kotak centang di bagian Object Permissions untuk mengaktifkan setiap izin yang diperlukan (Baca, Buat, Edit, dan Lihat Semua).

   

3. Klik Simpan.

4. Ulangi langkah-langkah ini untuk setiap empat objek (Akun, Kasus, Kontak, dan Prospek).

5. Konfigurasi izin kolom Type objek tasks.

   Catatan: Lewati langkah ini jika menggunakan objek Sesi Platform CCAI. Untuk informasi selengkapnya, lihat Salesforce: CCAI Platform Session Object Technical Details.

Objek	Kolom	Akses Baca	Akses Edit
Tasks	Jenis	X	X

![](images/16306536663c5d.png)

1. Setelah semua konfigurasi selesai, klik Kelola Penugasan.

2. Klik tombol Tambahkan Tugas.

   Tips: Anda dapat menambahkan set izin ke grup, bukan menambahkan pengguna secara manual. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Salesforce tentang Set Izin.

3. Centang kotak untuk memilih pengguna, lalu klik Tetapkan.

   

Membuat aplikasi terhubung

Buat aplikasi terhubung di Salesforce, langkah yang diperlukan untuk aplikasi versi 1.15 dan yang lebih baru.

Aplikasi Terhubung adalah aplikasi OAuth yang memungkinkan portal Platform CCAI berkomunikasi dengan Salesforce.

Prasyarat

• Salin URL Portal Anda. Strukturnya harus mengikuti ini:

  https://<tenant&>.<domain>.

Langkah

1. Di Salesforce, buka Setup > Apps > App Manager.

2. Klik tombol Aplikasi Terhubung Baru.

3. Perbarui kolom Informasi Dasar dengan konten:

   Catatan: Catat Nama Aplikasi Terhubung Anda karena Anda akan memerlukannya di langkah selanjutnya.

4. Di bagian API (Aktifkan Setelan OAuth), centang kotak Aktifkan Setelan OAuth dan perbarui setelan menggunakan tabel:

   Nama Kolom	Nilai Kolom
   Aktifkan Setelan OAuth	Dipilih (BENAR)
   URL callback	https://<tenant>.<domain>/v1/salesforce/oauth_callback
   Cakupan OAuth yang Dipilih	Mengakses layanan URL identitas (id, profile, email, address, phone) Mengelola data pengguna menggunakan API (API) Menjalankan permintaan kapan saja (refresh_token, offline_access)
   Mewajibkan Ekstensi Kunci Bukti untuk Pertukaran Kode (PKCE) untuk Alur Otorisasi yang Didukung	Tidak dipilih (False)
   Rahasia yang Diperlukan untuk alur web	Dipilih (BENAR)
   Memerlukan Rahasia untuk alur Token Refresh.	Dipilih (BENAR)

5. Di bagian Setelan Aplikasi Kanvas, perbarui setelan dengan berikut ini:

   Nama Kolom	Nilai Kolom
   Canvas	Dipilih (BENAR)
   URL Aplikasi Canvas	https://<tenant>.<domain>/v1/salesforce/start
   Metode Akses	Permintaan yang Ditandatangani (POST)
   Lokasi	Konsol Komponen Lightning Open CTI Halaman Visualforce

6. Buka bagian bawah halaman, lalu klik Simpan.

7. Klik Lanjutkan untuk menutup pesan konfirmasi dan tunggu hingga Aplikasi Terhubung dibuat.

   Catatan: Pembuatan Aplikasi Terhubung dapat memerlukan waktu hingga 10 menit. Jika aplikasi Anda tidak ditampilkan di Langkah 10, tunggu beberapa menit dan coba lagi.

8. Buka Penyiapan > Aplikasi > Aplikasi Terhubung > Kelola Aplikasi Terhubung.

9. Klik nama aplikasi dari layar Aplikasi Terhubung.

10. Klik Kelola.

11. Klik tombol Edit Kebijakan.

12. Di bagian kebijakan OAuth, pilih opsi Pengguna yang disetujui admin telah diotorisasi dari drop-down Pengguna yang Diizinkan:

    

13. Klik Simpan di bagian bawah halaman untuk kembali ke layar Kelola untuk Aplikasi Terhubung.

14. Buka bagian Profil, lalu klik Kelola Profil.

15. Di layar Profil Penetapan Aplikasi, pilih opsi profil yang akan digunakan perusahaan Anda, seperti Administrator Sistem atau profil lain yang dapat digunakan agen.

    Dalam contoh ini, kita memilih Pengguna Standar dan Administrator Sistem:

    

16. Klik Simpan untuk kembali ke tampilan kelola aplikasi yang terhubung.

    Aplikasi Terhubung telah dibuat.Untuk memverifikasi apakah aplikasi terhubung telah dibuat, periksa apakah aplikasi tercantum di Setelan > Aplikasi > Pengelola Aplikasi.

Masukkan Kunci dan Secret Konsumen Aplikasi Terhubung ke Portal Admin

Masukkan client_id key dan Secret ke Admin Portal Salesforce.

Prasyarat

• Selesaikan langkah-langkah di bagian sebelumnya Membuat aplikasi terhubung.

• Pengguna harus memiliki akses ke alamat email yang terkait dengan akun pengguna Salesforce untuk menerima email verifikasi identitas.

• Harus merupakan pengguna dengan peran administrator di portal CCAI Platform.

Langkah

1. Buka Penyiapan > Buat > Aplikasi > Aplikasi Terhubung dan temukan Aplikasi Terhubung Anda.

2. Klik panah di paling kanan baris.

3. Klik View.

4. Klik Kelola detail konsumen.

   

5. Verifikasi identitas Anda dengan memasukkan kode verifikasi yang dikirimkan ke alamat email Anda.

6. Salin nilai Kunci konsumen dan Rahasia konsumen yang ditampilkan.

   

7. Di portal Platform CCAI, buka Settings > Developer Settings, lalu temukan kolom Connected App Consumer Key dan Connected App Secret.

8. Tempelkan Consumer Secret ke kolom Connected APP Consumer Secret.

9. Tempelkan Consumer Key dari Salesforce ke kolom Connected APP Consumer Key.

10. Klik Simpan.

    Informasi Aplikasi Terhubung telah ditambahkan ke portal Platform CCAI.

Mengelola Konfigurasi di Salesforce

Konfigurasi Aplikasi versi 1.22 dan yang lebih baru.

Prasyarat

• Versi aplikasi untuk Salesforce 1.22 atau yang lebih baru diinstal untuk Org Salesforce.

• Dapatkan Kunci Perusahaan dan Kode Rahasia Perusahaan di Admin Portal dengan membuka Setelan > Setelan Developer.

• Aplikasi Terhubung dibuat (lihat bagian Membuat aplikasi terhubung di atas).

Langkah

1. Di Salesforce, buka Setup > Apps > Packaging > Installed Packages.

2. Temukan CC_Agent_App, lalu klik Configure.

3. Di tab baru yang terbuka, klik Add New Configuration.

4. Lengkapi kolom menggunakan nilai berikut:

   

   Nama Kolom	Nilai Kolom	Lokasi untuk Field
   Pemilik Penyiapan	Organisasi atau Profil	Jika Anda ingin menyetel setelan tingkat organisasi, pilih Organisasi. Jika Anda ingin menambahkan setelan tingkat profil, pilih Profil. Jika Anda memilih Profil, Anda dapat memilih profil yang akan menerapkan setelan.
   Organisasi		Nama organisasi Anda ditampilkan di sini dan bersifat hanya baca.
   Profil		Daftar profil Anda ditampilkan di sini dan Anda dapat memilih Profil jika Anda memilih Profil untuk Pemilik Penyiapan.
   CompanyKey	Kunci Perusahaan	Portal Platform CCAI > Setelan > Setelan Developer
   CompanySecret	Rahasia Perusahaan	Portal Platform CCAI > Setelan > Setelan Developer
   Tenant	Nama Tenant	Di portal CCAI Platform: https://<tenant>.<domain> Penting: hanya masukkan bagian <tenant> dari URL Portal di kolom ini. Catatan: Kolom ini memiliki batas 100 karakter.
   ConnectedApp	Nama API Aplikasi Terhubung	Cocokkan nama di Buat aplikasi terhubung (seperti CCaaS_Platform_Connected_App)

5. Jika memilih Profil dari drop-down Siapkan Pemilik, Anda dapat memilih profil yang akan diterapkan ke konfigurasi baru ini. Jika Organisasi dipilih dari Pemilik Penyiapan, kolom Profil akan dinonaktifkan.

6. Klik Simpan Konfigurasi dan Anda akan kembali ke layar daftar

7. Setelah konfigurasi selesai, tutup jendela browser.

Mengelola Pusat Panggilan

Konfigurasi Pusat Panggilan di Salesforce untuk memberi agen akses ke adaptor.

Prasyarat

• Paket telah diinstal (lihat bagian 2. Instal Aplikasi di Salesforce di atas)

Langkah

1. Di Salesforce, buka Setup > Feature Settings > Service > Call Center > Call Centers.

2. Cari dan klik Call Center yang berjudul Softphone_v2.

3. Klik Kelola Pengguna Pusat Panggilan.

4. Klik Tambahkan Pengguna Lainnya.

5. Gunakan kolom filter untuk menelusuri pengguna tertentu, lalu klik Temukan. Untuk melihat semua pengguna, klik Temukan.

6. Gunakan kotak centang di hasil penelusuran untuk memilih pengguna yang akan menggunakan Portal.

7. Klik Tambahkan ke Pusat Panggilan.

   Untuk memverifikasi hasilnya, buka Pusat Panggilan dan lihat bahwa pengguna tercantum.

Setelah Penginstalan

Siapkan konsol untuk Salesforce Classic atau Salesforce Lightning:

Penyiapan konsol untuk Salesforce Classic

Penyiapan konsol untuk Salesforce Lightning

Penyiapan konsol untuk Salesforce Classic

Konfigurasi Aplikasi Konsol untuk menggunakan adaptor di Pengalaman Salesforce Classic.

Prasyarat

• Menyelesaikan penginstalan Salesforce

• Organisasi dikonfigurasi untuk menggunakan pengalaman Salesforce Klasik.

Langkah

1. Di Salesforce, buka Setup > Build > Create > Apps.

2. Di layar Aplikasi, cari Sample Console, lalu klik Edit.

3. Untuk mengedit Konsol Contoh, buka kolom Choose Console Components, lalu pilih komponen UJET_Chat dari daftar Item yang Tersedia.

4. Klik Tambahkan untuk memindahkan komponen ke daftar Item yang Dipilih.

5. Buka bagian Tetapkan ke Profil, lalu centang kotak untuk profil dengan set izin yang Anda konfigurasi di bagian sebelumnya.

   

6. Klik Simpan.

7. Verifikasi bahwa adaptor ditampilkan di Konsol seperti yang diharapkan:

   Gunakan pemilih aplikasi di menu Penjualan di pojok kanan atas layar untuk memilih Sample Console:

   

Hasil

Salesforce disiapkan di Konsol Klasik Salesforce.

Penyiapan konsol untuk Salesforce Lightning

Konfigurasi Aplikasi Konsol untuk menggunakan adaptor di Salesforce Lightning Experience.

Prasyarat

• Organisasi menggunakan Lightning Experience.

• Harus memiliki profil Administrator Sistem atau menjadi pengguna yang dapat mengelola Aplikasi.

• Deployment domain untuk pengguna dengan Salesforce telah selesai.

Langkah

1. Di Salesforce, buka Setup > Apps > App Manager.

2. Temukan aplikasi Sales and/or Service Console yang memiliki Lightning di kolom Jenis Aplikasi.

3. Klik drop-down panah di paling kanan, lalu pilih Edit.

4. Klik Item Utilitas dari menu Setelan Aplikasi di sebelah kiri.

   

5. Klik Tambahkan Item Utilitas, lalu pilih opsi Open CTI Softphone.

6. Konfigurasi kolom Label.

   

7. Klik Tambahkan Item Utilitas lagi, lalu pilih Komponen Chat di bagian Dikelola Kustom.

8. Perbarui Label sesuai kebutuhan.

9. Konfigurasi Ikon sesuai kebutuhan.

10. Klik Simpan.

11. Ulangi Langkah 2-10 jika menginstal aplikasi konsol Lightning tambahan.

Panel utilitas telah dikonfigurasi dengan komponen. Untuk mengonfirmasi bahwa Salesforce disiapkan dengan Lightning Experience, periksa panel utilitas di konsol.