Gunakan Komponen Web Lightning (LWC) Salesforce untuk berintegrasi dengan modul UI Agent Assist untuk percakapan chat.
Sebelum memulai
Untuk mengintegrasikan modul UI Agent Assist dengan Salesforce, Anda memerlukan akses ke resource berikut:
-
Ikuti petunjuk penginstalan yang direkomendasikan untuk sistem operasi Anda.
-
Menginstal Salesforce CLI menggunakan
npm
diketahui menyebabkan masalah kompatibilitas. Untuk menghindari masalah ini, gunakan salah satu opsi penginstalanpkg
(macOS),exe
(Windows), atauTAR
(Linux). -
Instal perintah
gcloud
seperti yang diinstruksikan dan lakukan autentikasi menggunakangcloud auth login
. UI Salesforce
- Login di URL instance Anda atau halaman login Salesforce dan perhatikan hal berikut:
- URL My Domain Salesforce Anda. Ikuti langkah-langkah berikut untuk menemukan URL Domain Saya:
- Buka panel menu > menu Penyiapan.
- Klik Penyiapan.
- Masukkan penelusuran Quick Find untuk My Domain. Nama domain dalam format berikut:
MY-DOMAIN-NAME.develop.my.salesforce.com
.
- ID organisasi Salesforce Anda. Ikuti langkah-langkah berikut untuk menemukan ID organisasi:
- Buka panel menu > menu Penyiapan.
- Klik Penyiapan.
- Masukkan penelusuran Quick Find untuk "Informasi Perusahaan". Catatan: Langkah-langkah integrasi ini hanya telah diuji dengan Salesforce Developer Edition. Perbedaan lisensi fitur dan antarmuka Salesforce mungkin muncul jika Anda menggunakan edisi lain.
- URL My Domain Salesforce Anda. Ikuti langkah-langkah berikut untuk menemukan URL Domain Saya:
- Login di URL instance Anda atau halaman login Salesforce dan perhatikan hal berikut:
Backend integrasi Agent Assist
- Ikuti petunjuk untuk menyiapkan integrasi.
- Sebelum menjalankan skrip deployment, konfigurasi variabel lingkungan berikut dengan
deploy.sh
, atau dalam file.env
di root project:AUTH_OPTION
: Tetapkan ini keSalesforceLWC
.SALESFORCE_DOMAIN
: Nama domain yang mirip denganYOUR_SUBDOMAIN.develop.lightning.force.com
. Anda mencatat nilai ini dalam prasyarat UI Salesforce. Perhatikan bahwa Anda tidak boleh menyertakanhttps://
.SALESFORCE_ORGANIZATION_ID
: Anda mencatat nilai ini dalam prasyarat UI Salesforce.
Langkah 1: Siapkan project Anda
Untuk mulai mengintegrasikan modul UI Agent Assist, ikuti langkah-langkah berikut.
Jalankan kode berikut untuk meng-clone repositori integrasi Agent Assist dan membuka project Anda:
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations cd salesforce/aa-lwc
Download file JS, yang di-deploy nanti sebagai resource statis, dengan menjalankan perintah berikut:
npm run generate-static-resources npm install
Langkah 2: Siapkan lingkungan Anda
Anda dapat mengintegrasikan modul UI Agent Assist di lingkungan tertentu, seperti produksi atau pengembangan. Salesforce menyebut lingkungan ini sebagai Organisasi (org.).
Mengonfigurasi org Anda di konsol Salesforce
Dalam konsol Salesforce, ikuti langkah-langkah berikut untuk mengonfigurasi org Anda untuk integrasi Agent Assist.
- Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "Omni-Channel Settings", lalu klik Omni-Channel Settings.
- Centang Enable Omni-Channel.
- Pilih Otomatis masuk ke Omni-Channel di jendela atau tab baru.
- Klik Simpan.
- Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "Communities", lalu klik Digital Experiences > Settings.
- Centang Enable Experience Workspaces.
- Klik Simpan.
Mengonfigurasi org Anda dengan Salesforce CLI
Ikuti langkah-langkah berikut untuk menggunakan Salesforce CLI guna mengonfigurasi org Anda untuk integrasi Agent Assist.
Jalankan kode berikut dan autentikasi CLI menggunakan detail login Salesforce yang biasa Anda gunakan.
npm run login
Jalankan kode berikut untuk men-deploy LWC ke org.
npm run deploy
Langkah 3: Buat aplikasi klien eksternal
LWC Salesforce menggunakan alur OAuth 2.0 kredensial klien untuk mengautentikasi Anda. Aplikasi klien eksternal memungkinkan alur kredensial klien. Gunakan kunci konsumen dan rahasia konsumen aplikasi untuk mengonfigurasi LWC Salesforce guna mengautentikasi pengguna dengan Salesforce.
- Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "External Client App Manager".
- Klik Pengelola Aplikasi Klien Eksternal > Aplikasi Klien Eksternal Baru > Buat, lalu masukkan informasi berikut.
- Nama Aplikasi yang Terhubung:
lwc auth
- Nama API:
lwc_auth
- Email Kontak:
your_email@example.com
- API (Aktifkan Setelan OAuth) > Aktifkan OAuth: Dipilih
- API (Enable OAuth Settings) > Callback URL:
https://login.salesforce.com/services/oauth2/callback
- API (Enable OAuth Settings) > Selected OAuth Scopes: Mengakses layanan URL identitas
- API (Aktifkan Setelan OAuth) > Aktifkan Alur Kredensial Klien: Dipilih
- Nama Aplikasi yang Terhubung:
- Klik Buat.
- Klik Pengelola Aplikasi Klien Eksternal > Aplikasi Klien Eksternal Baru > Buat, lalu masukkan informasi berikut.
- Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "External Client App Manager".
- Klik nama aplikasi terhubung Anda > Edit.
- Buka OAuth Policies > OAuth Flows and External Client App Enhancements.
- Pastikan Enable Client Credentials Flow dipilih.
- Untuk Run As, masukkan nama pengguna login Anda.
- Klik Simpan.
- Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "External Client App Manager".
- Klik nama aplikasi terhubung Anda > Edit.
- Buka OAuth Settings > App Settings > Consumer Key and Secret.
- Masukkan kode verifikasi yang dikirim ke email Anda.
- Salin kunci konsumen dan rahasia konsumen ke tempat yang aman. Anda akan memerlukannya untuk langkah selanjutnya.
- Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "CORS", lalu klik Edit.
- Centang Aktifkan CORS untuk endpoint OAuth.
- Klik Simpan.
Untuk informasi tambahan tentang aplikasi yang terhubung, lihat referensi Salesforce berikut.
- Mengonfigurasi Setelan Aplikasi Terhubung Dasar
- Mengonfigurasi Aplikasi Terhubung untuk Alur Kredensial Klien OAuth 2.0
Langkah 4: Konfigurasi klien chat
Untuk menggunakan modul UI Agent Assist dengan Salesforce, Anda memerlukan klien chat di desktop agen.
Mengonfigurasi fitur pesan untuk dalam aplikasi & web
Ikuti langkah-langkah berikut untuk mengonfigurasi messenger Anda.
- Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "URL Tepercaya", lalu klik URL Tepercaya Baru.
- Masukkan Nama API:
ui_connector
. - Masukkan URL endpoint layanan Cloud Run konektor UI yang Anda deploy dengan backend integrasi Agent Assist. Anda dapat menemukan URL ini di konsol Cloud Run. Contoh:
https://UI_CONNECTOR_SUBDOMAIN.us-central1.run.app
. - Pilih semua opsi di CSP Directives.
- Klik Simpan & Baru.
- Masukkan Nama API:
twilio_flex
. - Masukkan URL
https://flex.twilio.com
. - Pilih semua opsi di CSP Directives.
- Klik Simpan & Baru.
- Masukkan Nama API:
salesforce_domain
. - Masukkan URL domain Salesforce Anda dengan format berikut:
https://YOUR_SUBDOMAIN.my.salesforce.com
. - Pilih semua opsi di CSP Directives.
- Klik Simpan.
- Masukkan Nama API:
- Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "Queues", lalu klik New.
- Masukkan informasi berikut:
- Label: Antrean Pesan
- Nama Antrean: Messaging_Queue
- Konfigurasi Pemilihan Rute: Messaging_Routing_Configuration
- Klik Objek yang Didukung, lalu tambahkan: "Pengguna Pesan, Sesi Pesan".
- Klik Anggota Antrean, lalu tambahkan: "Pengguna: Pengguna Login Anda".
- Klik Simpan.
- Masukkan informasi berikut:
- Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "Permission Sets".
- Klik Messaging Agents Permission Set.
- Klik Akses Status Kehadiran Layanan > Edit.
- Pilih status Sibuk dan Online - Pesan.
- Klik Tambahkan > Simpan.
- Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "Pengguna", lalu klik Pengguna.
- Klik nama pengguna Anda dan pastikan Service Cloud User diaktifkan.
- Temukan Penetapan Lisensi Set Izin di halaman.
- Klik Edit Tugas, lalu centang Pesan untuk Pengguna Aplikasi dan Web.
- Klik Simpan.
- Temukan Penugasan Set Izin di halaman.
- Klik Edit Penugasan, lalu pilih Messaging Agent Permission Set.
- Klik Tambahkan > Simpan.
- Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "Setelan Pesan", lalu klik Channel Baru.
- Pilih Messaging untuk Aplikasi Dalam Aplikasi dan Web.
- Masukkan Nama: Channel Pesan.
- Klik Simpan.
- Tetapkan Jenis Perutean ke "Omni-Queue" dan Antrean ke "Antrean Pesan".
- Klik Simpan dan buka Setelan Pesan.
- Klik nama saluran pesan Anda, lalu klik Aktifkan.
- Setelah membaca, setujui Persyaratan dan Ketentuan.
- Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "Embedded Service Deployments", lalu klik New Deployment.
- Klik Messaging for In-App and Web > Next > Web > Next.
- Isi detail berikut:
- Nama: Deployment Layanan Tersemat Messaging
- Nama Developer: Messaging_Embedded_Service_Deployment
- Domain: example.com
- Channel: Channel Pesan
- Klik Simpan. Tunggu hingga deployment selesai.
- Di setelan Embedded Service Deployment, klik Publish.
- Klik Muat ulang, lalu Pengujian Pesan.
Menguji pesan untuk dalam aplikasi & web
Ikuti langkah-langkah berikut untuk menguji messenger Anda.
- Klik Test Messaging.
- Setelah tab baru dimuat, klik balon ucapan untuk memulai percakapan pengujian baru.
- Kirim pesan, seperti
"Test"
. - Buka tab browser Salesforce.
- Di toolbar Setup, klik menu App Launcher, lalu pilih Service Console.
- Klik Omni-Channel di toolbar utilitas.
- Setel status Anda ke Online - Pesan.
- Terima pesan masuk. Tindakan ini akan membuka tab baru di Service Console untuk percakapan. Anda tidak dapat melihat transkrip chat.
- Buka panel menu > menu Penyiapan.
- Klik Edit Halaman.
- Dari menu Komponen, tarik Percakapan yang Disempurnakan ke Panel Percakapan.
- Klik Simpan > Aktifkan > Tetapkan sebagai Default Organisasi > Desktop > Kembali .
- Muat ulang halaman.
- Klik Omni-Channel di toolbar utilitas.
- Setel status Anda ke Online - Pesan.
- Balas pesan "Test" untuk memvalidasi bahwa fitur pesan berfungsi.
Jika Anda mengalami masalah dan memerlukan informasi lebih lanjut, lihat Panduan Penyiapan Salesforce Messaging untuk Dalam Aplikasi dan Web yang komprehensif.
Langkah 5: Instal LWC Salesforce
Ikuti langkah-langkah berikut untuk menambahkan LWC Salesforce ke halaman sesi pesan menggunakan Editor Lightning Experience. Lanjutkan percakapan pengujian dari Langkah 4.
- Buka panel menu > menu Penyiapan, lalu klik Edit Halaman.
Dari sidebar Komponen, pindahkan
agentAssistContainerModule
ke sidebar.Klik komponen yang Anda tempatkan di langkah sebelumnya.
Isi kolom formulir sebagai berikut untuk menambahkan detail konfigurasi.
- endpoint: URL Konektor UI Backend Integrasi Agen Anda, seperti URL dari konsol Cloud Run, seperti:
https://UI-CONNECTOR-ENDPOINT.GCP-REGION.run.app
- fitur: Fitur Agent Assist diaktifkan di profil percakapan Anda, seperti
CONVERSATION_SUMMARIZATION
,KNOWLEDGE_ASSIST_V2
,SMART_REPLY
,danAGENT_COACHING
conversationProfile
: Nama resource profil percakapan Agent Assist Anda (contoh:projects/GCP-PROJECT-ID/locations/GCP-REGION/conversationProfiles/CONVERSATION-PROFILE-ID
)- consumerKey: Kunci konsumen aplikasi terhubung dari langkah 3
- consumerSecret: Rahasia konsumen aplikasi terhubung dari langkah 3
- endpoint: URL Konektor UI Backend Integrasi Agen Anda, seperti URL dari konsol Cloud Run, seperti: