Integrasi chat Salesforce

Integrasi chat ini menggunakan Komponen Web Lightning (LWC) Salesforce untuk berintegrasi dengan modul UI Agent Assist untuk percakapan chat.

Berikut ringkasan umum integrasi chat:

Arsitektur untuk integrasi chat Agent Assist dengan Salesforce

Sebelum memulai

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

  • Node.js: Ikuti petunjuk penginstalan yang direkomendasikan untuk sistem operasi Anda.

  • Salesforce CLI: Ikuti petunjuk penginstalan yang direkomendasikan untuk sistem operasi Anda.

  • Google Cloud CLI: Instal perintah gcloud seperti yang diinstruksikan dan lakukan autentikasi menggunakan gcloud auth login.

  • Salesforce: Login di URL instance Anda atau halaman login Salesforce dan catat berikut ini:

    • URL My Domain Salesforce Anda. Ikuti langkah-langkah berikut untuk menemukan URL My Domain:
      1. Buka panel menu > menu Penyiapan.
      2. Klik Penyiapan.
      3. Di kotak Quick Find, masukkan My Domain. Nama domainnya berformat berikut: MY-DOMAIN-NAME.develop.my.salesforce.com.
    • ID organisasi Salesforce Anda. Ikuti langkah-langkah berikut untuk menemukan ID organisasi:
      1. Buka panel menu > menu Penyiapan.
      2. Klik Penyiapan.
      3. Di kotak Quick Find, masukkan Company Information.

  • Backend integrasi Agent Assist:

    1. Ikuti petunjuknya untuk menyiapkan integrasi.
    2. 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 YOUR_SUBDOMAIN.develop.lightning.force.com. Anda mencatat nilai ini dalam prasyarat Salesforce. Perhatikan bahwa Anda tidak boleh menyertakan https://.
      • SALESFORCE_ORGANIZATION_ID: Anda mencatat nilai ini dalam prasyarat Salesforce.

Langkah 1: Siapkan project pengembangan Salesforce 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 untuk mendownload file JavaScript modul UI yang akan Anda deploy nanti sebagai Resource Statis. Salesforce memerlukan resource statis untuk memuat JavaScript pihak ketiga. Selain itu, batas 5 MB diberlakukan untuk file resource statis, sehingga file JavaScript diupload sebagai file ZIP.

    npm run generate-static-resources
npm install

Langkah 2: Siapkan lingkungan Salesforce 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 agar dapat terintegrasi dengan Agent Assist.

  1. Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Di kotak Quick Find, masukkan Omni-Channel Settings, lalu klik Omni-Channel Settings.
    1. Pilih Aktifkan Omni-Channel.
    2. Pilih Otomatis masuk ke Omni-Channel di jendela atau tab baru.
    3. Klik Simpan.
  2. Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Di kotak Quick Find, masukkan Communities, lalu klik Digital Experiences > Settings.
    1. Pilih Aktifkan Ruang Kerja Experience.
    2. Klik Simpan.

Mengonfigurasi org Anda dengan Salesforce CLI

Ikuti langkah-langkah berikut untuk menggunakan Salesforce CLI guna mengonfigurasi org 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 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 secret konsumen aplikasi untuk mengonfigurasi LWC Salesforce guna mengautentikasi pengguna dengan Salesforce.

  1. Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Di kotak Quick Find, masukkan External Client App Manager.
    1. Klik Pengelola Aplikasi Klien Eksternal > Aplikasi Klien Eksternal Baru > Buat, lalu masukkan informasi berikut.
      • Nama Aplikasi Klien Eksternal: lwc auth
      • Nama API: lwc_auth
      • Email Kontak: your_email@example.com
      • API (Aktifkan Setelan OAuth) > Aktifkan OAuth: Dipilih
      • API (Aktifkan Setelan OAuth) > URL Panggilan Balik: https://login.salesforce.com/services/oauth2/callback
      • API (Enable OAuth Settings) > Selected OAuth Scopes: Access the identity URL service
      • API (Aktifkan Setelan OAuth) > Aktifkan Alur Kredensial Klien: Dipilih
    2. Klik Create.
  2. Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Di kotak Quick Find, masukkan External Client App Manager.
    1. Klik nama aplikasi klien eksternal Anda > Edit.
    2. Buka OAuth Policies > OAuth Flows and External Client App Enhancements.
    3. Pastikan Enable Client Credentials Flow dipilih.
    4. Untuk Run As, masukkan nama pengguna login Anda.
    5. Klik Simpan.
  3. Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Di kotak Quick Find, masukkan External Client App Manager.
    1. Klik nama aplikasi klien eksternal Anda > Edit.
    2. Buka OAuth Settings > App Settings > Consumer Key and Secret.
    3. Masukkan kode verifikasi yang dikirim ke email Anda.
    4. Salin kunci konsumen dan rahasia konsumen ke tempat yang aman. Anda akan memerlukannya untuk langkah selanjutnya.

Menetapkan kebijakan keamanan konten dan CORS

  1. Buka menu bar > menu Penyiapan, lalu klik Penyiapan.
  2. Di kotak Quick Find, masukkan CORS, lalu klik Edit.
    1. Pilih Aktifkan CORS untuk endpoint OAuth.
    2. Klik Simpan.
  3. Buka menu bar > menu Penyiapan, lalu klik Penyiapan.
  4. Di kotak Quick Find, masukkan Trusted URLs, lalu klik New Trusted URL.
  5. Masukkan informasi berikut:
    • Nama API: ui_connector
    • URL: 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. Misalnya: https://UI_CONNECTOR_SUBDOMAIN.GCP_REGION.run.app.
    • Petunjuk CSP: Centang semua kotak.
    • Klik Simpan & Baru.
  6. Masukkan informasi berikut:
    • Nama API: ui_connector_wss
    • URL: Masukkan URL Secure WebSockets untuk endpoint layanan UI Connector Anda: wss://UI_CONNECTOR_SUBDOMAIN.GCP_REGION.run.app.
    • Petunjuk CSP: Centang semua kotak.
    • Klik Simpan & Baru.
  7. Masukkan informasi berikut:
    • Nama API: salesforce_domain
    • URL: Masukkan URL Domain Salesforce Anda dengan format berikut: https://YOUR_SUBDOMAIN.my.salesforce.com.
    • Petunjuk CSP: Centang semua kotak.
    • Klik Simpan.

Langkah 4: Konfigurasi klien chat

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

Mengonfigurasi Chat yang ditingkatkan

Ikuti langkah-langkah berikut untuk mengonfigurasi messenger Anda.

  1. Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk Queues, lalu klik New.
    1. Masukkan informasi berikut:
      • Label: Messaging Queue
      • Nama Antrean: Messaging_Queue
      • Konfigurasi Perutean: Messaging_Routing_Configuration
    2. Klik Supported Objects, lalu tambahkan Messaging User dan Messaging Session.
    3. Klik Anggota Antrean, lalu tambahkan Pengguna: Pengguna Login Anda.
    4. Klik Simpan.
  2. Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Di kotak Quick Find, masukkan Permission Sets.
    1. Klik Messaging Agents Permission Set.
    2. Klik Akses Status Kehadiran Layanan > Edit.
    3. Pilih status Sibuk dan Online - Pesan.
    4. Klik Tambahkan > Simpan.
  3. Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Di kotak Quick Find, masukkan Pengguna, lalu klik Pengguna.
    1. Klik nama pengguna Anda dan pastikan Service Cloud User diaktifkan.
    2. Temukan Penugasan Lisensi Set Izin di halaman.
    3. Klik Edit Penugasan, lalu pilih Enhanced Chat User.
    4. Klik Simpan.
    5. Temukan Penugasan Set Izin di halaman.
    6. Klik Edit Penugasan, lalu pilih Setel Izin Agen Pesan.
    7. Klik Tambahkan > Simpan.
  4. Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Di kotak Quick Find, masukkan Messaging Settings, lalu klik New Channel.
    1. Pilih Chat yang Ditingkatkan.
    2. Masukkan Nama: Messaging Channel.
    3. Klik Simpan.
    4. Tetapkan Routing Type ke Omni-Queue dan Queue ke Messaging Queue.
    5. Klik Simpan dan buka Setelan Pesan.
    6. Klik nama saluran pesan Anda, lalu klik Aktifkan.
    7. Setelah membaca, setujui Persyaratan dan Ketentuan.
  5. Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Di kotak Quick Find, masukkan Embedded Service Deployments, lalu klik New Deployment.
    1. Klik Enhanced Chat > Next > Web > Next.
    2. Isi detail berikut:
      • Nama: Messaging Embedded Service Deployment
      • 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 Muat ulang, lalu Pengujian Pesan.

Menguji Chat yang ditingkatkan

Ikuti langkah-langkah berikut untuk menguji messenger Anda.

  1. Klik Test Messaging.
  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. Setel status Anda ke Online - Pesan.
  8. Terima pesan masuk. Tindakan ini akan membuka tab baru di Service Console untuk percakapan. Anda tidak dapat melihat transkrip chat.
  9. Buka panel menu > menu Penyiapan.
  10. Klik Edit Halaman.
  11. Dari menu Komponen, tarik komponen Percakapan yang Disempurnakan ke panel Percakapan.
  12. Klik Simpan > Aktifkan > Tetapkan sebagai Default Org > Desktop > Kembali .
  13. Muat ulang halaman.
  14. Klik Omni-Channel di toolbar utilitas.
  15. Setel status Anda ke Online - Pesan.
  16. Balas pesan Test untuk memvalidasi bahwa fitur pesan berfungsi.

Jika Anda mengalami masalah dan memerlukan informasi selengkapnya, lihat Panduan Penyiapan Chat Enhanced Salesforce yang komprehensif.

Langkah 5: Instal Komponen Web Lightning Salesforce

Ikuti langkah-langkah berikut untuk menambahkan LWC Salesforce 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 Komponen, pindahkan agentAssistContainerModule ke sidebar.

  3. Klik komponen yang Anda tempatkan di langkah sebelumnya.

  4. 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, dan AGENT_COACHING
    • channel: Menunjukkan bahwa channel tersebut chat.
    • platform: Menunjukkan bahwa platformnya adalah messaging.
    • conversationProfile: Nama resource profil percakapan Agent Assist Anda (contoh: projects/GCP_PROJECT_ID/locations/GCP_REGION/conversationProfiles/CONVERSATION_PROFILE_ID)
    • consumerKey: Kunci konsumen aplikasi klien eksternal dari Langkah 3.
    • consumerSecret: Rahasia konsumen aplikasi klien eksternal dari Langkah 3.