Integrasi chat Salesforce

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:

  • 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

    1. Login di URL instance Anda atau halaman login Salesforce dan perhatikan hal berikut:
    2. URL My Domain Salesforce Anda. Ikuti langkah-langkah berikut untuk menemukan URL Domain Saya:
      1. Buka panel menu > menu Penyiapan.
      2. Klik Penyiapan.
      3. Di kotak Quick Find, masukkan My Domain. Nama domain dalam format berikut: MY-DOMAIN-NAME.develop.my.salesforce.com.
    3. 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. 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.

  • Backend integrasi Agent Assist

    1. Ikuti petunjuk untuk menyiapkan integrasi.
    2. Sebelum menjalankan skrip deployment, konfigurasi variabel lingkungan berikut dengan deploy.sh atau dalam file .env di root project:
    3. AUTH_OPTION: Tetapkan ini ke SalesforceLWC.
    4. 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://.
    5. SALESFORCE_ORGANIZATION_ID: Anda mencatat nilai ini dalam prasyarat 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. 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.

  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 rahasia 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 External Client App Manager > New External Client App > Create, lalu masukkan informasi berikut.
    2. Nama Aplikasi Klien Eksternal: lwc auth
    3. Nama API: lwc_auth
    4. Email Kontak: your_email@example.com
    5. API (Aktifkan Setelan OAuth) > Aktifkan OAuth: Dipilih
    6. API (Enable OAuth Settings) > Callback URL: https://login.salesforce.com/services/oauth2/callback
    7. API (Enable OAuth Settings) > Selected OAuth Scopes: Mengakses layanan URL identitas
    8. API (Aktifkan Setelan OAuth) > Aktifkan Alur Kredensial Klien: Dipilih
    9. Klik Buat.
  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 Nama API: ui_connector
    1. 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://<var>UI_CONNECTOR_SUBDOMAIN</var>.<var>GCP_REGION</var>.run.app
    2. Centang semua kotak di bagian CSP Directives.
    3. Klik Simpan & Baru.
  6. Masukkan Nama API: salesforce_domain
    1. Masukkan URL Domain Salesforce Anda dengan format berikut: https://<var>YOUR_SUBDOMAIN</var>.my.salesforce.com.
    2. Centang semua kotak di bagian CSP Directives.
    3. 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. Di kotak Quick Find, masukkan Trusted URLs, lalu klik New Trusted URL.
    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://<var>UI_CONNECTOR_SUBDOMAIN</var>.us-central1.run.app.
    3. Centang semua kotak di bagian CSP Directives.
    4. Klik Simpan & Baru.
    5. Masukkan Nama API: twilio_flex.
    6. Masukkan URL https://flex.twilio.com.
    7. Centang semua kotak di bagian CSP Directives.
    8. Klik Simpan & Baru.
    9. Masukkan Nama API: salesforce_domain.
    10. Masukkan URL domain Salesforce Anda dengan format berikut: https://<var>YOUR_SUBDOMAIN</var>.my.salesforce.com.
    11. Centang semua kotak di bagian CSP Directives.
    12. Klik Simpan.
  2. Buka menu bar > menu Penyiapan, lalu klik Penyiapan. Masukkan penelusuran Quick Find untuk Queues, lalu klik New.
    1. Masukkan informasi sebagai berikut:
    2. Label: Messaging Queue
    3. Nama Antrean: Messaging_Queue
    4. Konfigurasi Pemilihan Rute: Messaging_Routing_Configuration
    5. Klik Objek yang Didukung, lalu tambahkan Pengguna Pesan dan Sesi Pesan.
    6. Klik Anggota Antrean, lalu tambahkan Pengguna: Pengguna Login Anda.
    7. Klik Simpan.
  3. 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.
  4. 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 Pengguna Chat yang Ditingkatkan.
    4. Klik Simpan.
    5. Temukan Penugasan Set Izin di halaman.
    6. Klik Edit Penugasan, lalu pilih Messaging Agent Permission Set.
    7. Klik Tambahkan > Simpan.
  5. 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: Saluran Pesan.
    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.
  6. 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:
    3. Nama: Messaging Embedded Service Deployment
    4. Nama Developer: Messaging_Embedded_Service_Deployment
    5. Domain: example.com
    6. Channel: Channel Pesan
    7. Klik Simpan. Tunggu hingga deployment selesai.
    8. Di setelan Embedded Service Deployment, klik Publish.
    9. 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 Penyiapan, klik menu Peluncur Aplikasi, 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 lebih lanjut, lihat Panduan Penyiapan Chat yang Lebih Baik untuk 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 pada 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://<var>UI_CONNECTOR_ENDPOINT</var>.<var>GCP_REGION</var>.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/<var>GCP_PROJECT_ID</var>/locations/<var>GCP_REGION</var>/conversationProfiles/<var>CONVERSATION_PROFILE_ID</var>)
    • consumerKey: Kunci konsumen aplikasi klien eksternal dari langkah 3
    • consumerSecret: Rahasia pengguna aplikasi klien eksternal dari langkah 3