Integrasi Salesforce

Integrasikan modul UI Agent Assist dengan Salesforce untuk memberikan saran real-time kepada agen manusia Anda selama percakapan chat layanan pelanggan.

Komponen Web Lightning (LWC) Agent Assist menghadirkan fitur Agent Assist ke Desktop Agen Salesforce Anda. Fitur ini memberikan bantuan real-time kepada perwakilan layanan pelanggan untuk membantu mereka menyelesaikan masalah pelanggan dengan lebih cepat, menampilkan respons yang siap dikirim, dan menyarankan jawaban atas pertanyaan pelanggan dari pusat informasi terpusat.

LWC, yang dikembangkan oleh Salesforce, adalah framework JS modern untuk menentukan logika dan template komponen. LWC Agent Assist di-deploy ke dan ditayangkan dari instance Salesforce Anda. Layanan ini menawarkan keamanan yang ditingkatkan dan terintegrasi langsung dengan data dan API Salesforce.

Sebelum memulai

Untuk mengintegrasikan modul UI Agent Assist dengan Salesforce, Anda memerlukan akses ke resource berikut:

  • Node.js

    Google telah menguji dan merekomendasikan Node.js 18.20.4. Ada masalah kompatibilitas umum dengan Node.js 20.18.0.

  • Salesforce CLI

    Instal menggunakan kode berikut: (sudo) npm install -g @salesforce/cli.

  • Gcloud CLI

    Instal perintah gcloud seperti yang diinstruksikan dan lakukan autentikasi menggunakan gcloud auth login.

  • UI Salesforce

    • Login di URL instance atau login.salesforce.com dan perhatikan hal berikut:
      • "URL Domain Saya" Salesforce Anda. Temukan ini dengan membuka panel menu > Menu penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "My Domain". Nama domain menggunakan format berikut: MY-DOMAIN-NAME.develop.my.salesforce.com
      • ID organisasi Salesforce Anda. Temukan ini dengan membuka menu > Menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "Informasi Perusahaan".

  • Backend integrasi Agent Assist

    • Ikuti petunjuk untuk menyiapkan integrasi.
    • Sebelum menjalankan skrip deployment, konfigurasikan variabel lingkungan berikut dengan deploy.sh, atau dalam file .env di root project:
      • AUTH_OPTION: Tetapkan ini ke SalesforceLWC.
      • SALESFORCE_DOMAIN: Nama domain yang mirip dengan berikut: YOUR_SUBDOMAIN.develop.lightning.force.com. Anda mencatat nilai ini di prasyarat UI Salesforce. Perhatikan bahwa Anda tidak boleh menyertakan https://.
      • SALESFORCE_ORGANIZATION_ID: Anda mencatat nilai ini di prasyarat UI Salesforce.

Langkah 1: Siapkan project Anda

Untuk mulai mengintegrasikan modul UI Agent Assist, ikuti langkah-langkah berikut.

  1. 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

  2. Jalankan perintah berikut, yang akan mendownload file JavaScript modul UI untuk di-deploy nanti sebagai Resource Statis (diperlukan oleh Salesforce untuk memuat JS pihak ketiga):

    npm run generate-static-resources
npm install

Langkah 2: Menyiapkan lingkungan Anda

Anda dapat mengintegrasikan modul UI Agent Assist di lingkungan tertentu, seperti produksi atau pengembangan. Salesforce menyebut lingkungan ini sebagai Organisasi (org).

Mengonfigurasi organisasi di konsol Salesforce

Di dalam konsol Salesforce, ikuti langkah-langkah berikut untuk mengonfigurasi organisasi Anda untuk integrasi Agent Assist.

  1. Buka panel menu > Menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "Omni-Channel Settings", lalu klik Omni-Channel Settings.
    1. Centang Enable Omni-Channel.
    2. Pilih Otomatis login agen ke Omni-Channel di jendela atau tab baru.
    3. Klik Simpan.
  2. Buka panel menu > Menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Penelusuran Cepat untuk "Komunitas", lalu klik Pengalaman Digital > Setelan.
    1. Centang Enable Experience Workspaces.
    2. Klik Simpan.

Mengonfigurasi organisasi dengan Salesforce CLI

Ikuti langkah-langkah berikut untuk menggunakan Salesforce CLI guna mengonfigurasi organisasi Anda untuk integrasi Agent Assist.

  1. Jalankan kode berikut dan autentikasi CLI menggunakan detail login Salesforce yang biasa Anda gunakan.

    npm run login

  2. Jalankan kode berikut untuk men-deploy LWC ke organisasi.

    npm run deploy

Langkah 3: Buat aplikasi terhubung

LWC Agent Assist menggunakan alur kredensial klien OAuth 2.0 untuk mengautentikasi Anda. Aplikasi (aplikasi) terhubung memungkinkan alur kredensial klien. Gunakan kunci konsumen dan secret konsumen aplikasi untuk mengonfigurasi LWC Agent Assist guna mengautentikasi pengguna dengan Salesforce.

  1. Buka panel menu > Menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "App Manager".
    1. Klik Aplikasi Terhubung Baru > Buat Aplikasi Terhubung > Lanjutkan, lalu masukkan informasi berikut.
      • Nama Aplikasi Terhubung: lwc auth
      • Nama API: lwc_auth
      • Email Kontak: email_anda@example.com
      • Aktifkan Setelan OAuth: dicentang
      • URL Callback: https://login.salesforce.com/services/oauth2/callback
      • Cakupan OAuth yang Dipilih: Mengakses layanan URL identitas
      • Enable Client Credentials Flow: dicentang
    2. Klik Simpan.
  2. Buka panel menu > Menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Penelusuran Cepat untuk "Kelola Aplikasi yang Terhubung".
    1. Klik nama aplikasi yang terhubung > Edit Kebijakan.
    2. Buka Alur Kredensial Klien.
    3. Untuk Run As, klik kaca pembesar, lalu pilih nama pengguna Anda.
    4. Klik Simpan.
  3. Buka panel menu > Menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "App Manager".
    1. Temukan lwc auth, lalu klik .
    2. Klik Lihat > Kelola Detail Konsumen.
    3. Masukkan kode verifikasi yang dikirim ke email Anda.
    4. Salin kunci konsumen dan secret konsumen di tempat yang aman. Anda akan memerlukannya untuk langkah berikutnya.
  4. Buka panel menu > Menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "CORS", lalu klik Edit.
    1. Centang Aktifkan CORS untuk endpoint OAuth.
    2. Klik Simpan.

Untuk informasi tambahan tentang aplikasi terhubung, lihat referensi Salesforce berikut.

Langkah 4: Konfigurasikan klien chat

Untuk menggunakan modul UI Agent Assist dengan Salesforce, Anda memerlukan klien chat di desktop agen.

Mengonfigurasi Messaging untuk Dalam Aplikasi & Web

Ikuti langkah-langkah berikut untuk mengonfigurasi messenger Anda.

  1. Buka panel menu > Menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Penelusuran Cepat untuk "URL Tepercaya", lalu klik URL Tepercaya Baru.
    1. Masukkan Nama API: ui_connector
    2. 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.gcp-region.run.app.
    3. Centang semua kotak di Perintah CSP.
    4. Klik Save & New.
    5. Masukkan Nama API: salesforce_domain
    6. Masukkan URL domain Salesforce Anda dengan format berikut: https://YOUR_SUBDOMAIN.my.salesforce.com.
    7. Centang semua kotak di Perintah CSP.
    8. Klik Simpan.
  2. Buka panel menu > Menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "Antrean", lalu klik New.
    1. Masukkan informasi berikut.
      • Label: Antrean Pesan
      • Nama Antrean: Messaging_Queue
      • Konfigurasi Pemilihan Rute: Messaging_Routing_Configuration
    2. Klik Objek yang Didukung, lalu tambahkan: "Pengguna Messaging, Sesi Messaging".
    3. Klik Anggota Antrean, lalu tambahkan: "Pengguna: Pengguna Login Anda".
    4. Klik Simpan.
  3. Buka panel menu > Menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "Permission Sets".
    1. Klik Messaging Agents Permission Set.
    2. Klik Service Presence Statuses Access > Edit.
    3. Pilih status Sibuk dan Online - Pesan.
    4. Klik Tambahkan > Simpan.
  4. Buka panel menu > Menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Penelusuran Cepat untuk "Pengguna", lalu klik Pengguna.
    1. Klik nama pengguna Anda dan pastikan Service Cloud User diaktifkan.
    2. Temukan Penambahan Lisensi Setelan Izin di halaman.
    3. Klik Edit Tugas, lalu centang Pesan untuk Pengguna Dalam Aplikasi dan Web.
    4. Klik Simpan.
    5. Temukan Penetapan Setelan Izin di halaman.
    6. Klik Edit Tugas, lalu pilih Set Izin Agen Pesan.
    7. Klik Tambahkan > Simpan.
  5. Buka panel menu > Menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "Messaging Settings", lalu klik New Channel.
    1. Pilih Messaging for In-App and Web.
    2. Masukkan Nama: Messaging Channel.
    3. Klik Simpan.
    4. Tetapkan Jenis Pemilihan Rute ke "Omni-Antrean" dan Antrean ke "Antrean Pesan".
    5. Klik Simpan dan buka Setelan Pesan.
    6. Klik nama saluran pesan Anda, lalu klik Aktifkan.
    7. Setelah membaca, setujui Persyaratan dan Ketentuan.
  6. Buka panel menu > Menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk "Embedded Service Deployments", lalu klik New Deployment.
    1. Klik Messaging for In-App and Web > Next > Web > Next.
    2. Isi detail berikut:
      • Nama: Deployment Layanan Tersemat Messaging
      • Nama Developer: Messaging_Embedded_Service_Deployment
      • Domain: example.com
      • Channel: Channel Pesan
    3. Klik Simpan. Tunggu hingga deployment selesai.
    4. Di setelan Embedded Service Deployment, klik Publish.
    5. Klik Refresh, lalu Test Messaging.

Menguji Messaging untuk Dalam Aplikasi & Web

Ikuti langkah-langkah berikut untuk menguji messenger Anda.

  1. Klik Uji Pesan.
  2. Setelah tab baru dimuat, klik balon ucapan untuk memulai percakapan pengujian baru.
  3. Kirim pesan, seperti "Test".
  4. Buka tab browser Salesforce.
  5. Di toolbar Setup, klik menu App Launcher, lalu pilih Service Console.
  6. Klik Omni-Channel di toolbar utilitas.

  7. Tetapkan status Anda ke Online - Messaging.

    Anda akan mendapatkan percakapan masuk. Terima. Tindakan ini akan membuka tab baru di Konsol Layanan untuk percakapan. Anda tidak dapat melihat transkrip chat.

  8. Buka panel menu > Menu Penyiapan, lalu klik Edit Halaman.

  9. Dari menu Komponen, tarik Enhanced Conversation ke Panel Conversation.

  10. Klik Save > Activate > Assign as Org Default > Desktop > .

  11. Muat ulang halaman.

  12. Klik Omni-Channel di toolbar utilitas.

  13. Tetapkan status Anda ke Online - Messaging.

  14. Balas pesan "Uji" untuk memvalidasi bahwa fitur pesan berfungsi.

Jika Anda mengalami kesulitan dan memerlukan informasi selengkapnya, lihat Panduan Penyiapan Salesforce Messaging untuk Dalam Aplikasi dan Web yang komprehensif.

Langkah 5: Instal LWC Agent Assist

Ikuti langkah-langkah berikut untuk menambahkan LWC Agent Assist ke halaman sesi pesan menggunakan Editor Lightning Experience. Lanjutkan percakapan pengujian dari Langkah 4.

  1. Buka panel menu > Menu Penyiapan, lalu klik Edit Halaman.

  2. Dari sidebar Components, pindahkan agentAssistContainerModule ke sidebar.

  3. 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. Misalnya, URL dari konsol Cloud Run, seperti: https://UI-CONNECTOR-ENDPOINT.GCP-REGION.run.app.
    • features: Fitur Agent Assist yang akan disertakan. Fitur ini harus diaktifkan di profil percakapan Anda. Beberapa fitur yang tersedia mencakup CONVERSATION_SUMMARIZATION,KNOWLEDGE_ASSIST_V2,SMART_REPLY,dan AGENT_COACHING.
    • conversationProfile: Nama resource profil percakapan Agent Assist Anda. Misalnya, 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.