Integrasi suara Salesforce dengan NiCE CXone

Arsitektur untuk integrasi Agent Assist dan NiCE CXone dengan Salesforce

Integrasi suara ini menggunakan Aplikasi Salesforce NiCE CXone Agent for Service Cloud Voice (BYOT) agar agen Anda dapat menerima panggilan NiCE CXone di Salesforce Service Cloud Voice.

Agent Assist menggunakan aliran panggilan suara dari NiCE CXone Agent Assist Hub untuk memberikan saran kepada agen Anda di Salesforce Lightning Service Console.

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. Catatan: Langkah-langkah integrasi ini telah diuji dengan Salesforce Developer Edition saja. Perbedaan lisensi fitur dan antarmuka Salesforce mungkin muncul jika Anda menggunakan edisi lain.
Backend integrasi Agent Assist
1. Ikuti petunjuknya untuk menyiapkan integrasi.
2. Sebelum menjalankan skrip deployment, konfigurasi 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. Jangan sertakan https://.
  - SALESFORCE_ORGANIZATION_ID: Anda mencatat nilai ini dalam prasyarat Salesforce.
Instance NiCE CXone
Lisensi add-on NiCE CXone Agent Assist Hub: Add-on NiCE CXone Agent Assist Hub memungkinkan instance NiCE CXone Anda mengirimkan aliran media panggilan suara ke Agent Assist Google Cloud. NiCE CXone adalah produk berlisensi. Detail selengkapnya tersedia di dokumentasi NiCE CXone Agent Assist Hub.

Langkah 1: Konfigurasi NiCE CXone Studio dan NiCE CXone Agent Assist Hub

Langkah ini menjelaskan semua konfigurasi yang diperlukan di instance NiCE CXone Anda.

Mengonfigurasi alur panggilan dengan NiCE CXone Studio

Pada langkah ini, Anda akan mengonfigurasi alur panggilan terprogram dengan NiCE CXone Studio untuk merutekan panggilan masuk ke agen Anda dan mengirimkan aliran media panggilan ke Agent Assist. Konfigurasi alur panggilan ini dengan pemicu dan tindakan NiCE CXone Studio berikut, dalam urutan ini:

Login ke konsol NiCE CXone.
Buka menu Aplikasi ().
Buka Omnichannel Routing > Studio.
Di halaman Studio, buat Skrip Baru.

Konfigurasi alur panggilan ini dengan pemicu dan tindakan NiCE CXone Studio berikut:

Mulai: Pemicu ini diaktifkan saat panggilan masuk ke nomor telepon NiCE Point of Contact (POC) Anda.
Reqagent: Tindakan ini mengirimkan panggilan ke skill tertentu. Pilih keahlian yang terkait dengan agen yang ingin Anda terima panggilannya.
Musik: Tindakan ini memutar musik tunggu.
Tunggu: Tindakan ini menangguhkan alur kerja hingga pemicu lain diaktifkan.

Secara terpisah, tetapi dalam alur Studio yang sama, konfigurasikan apa yang terjadi saat agen menjawab panggilan masuk.

Onanswer: Pemicu ini diaktifkan saat agen dalam skill.
Ziptone: Memutar bunyi bip saat agen mengangkat telepon di desktop agen NiCE CXone (seperti softphone NiCE CXone Agent for Service Cloud Voice (BYOT)).
Agent Assist: Tindakan ini bertanggung jawab untuk membuat percakapan dan mengirimkan aliran media panggilan masuk ke Dialogflow, sehingga modul LWC UI Agent Assist dapat merender transkrip dan saran Agent Assist (seperti PGKA, GKA, Pembinaan AI) di Salesforce. Lihat dokumentasi integrasi ini untuk mengetahui detail konfigurasi. Catatan: langkah ini memerlukan profil percakapan yang telah dikonfigurasi sebelumnya.

Anda juga dapat mengonfigurasi Agent Assist untuk panggilan keluar. Integrasi memerlukan pemicuan tindakan Agent Assist saat panggilan keluar dijawab oleh pihak jarak jauh. Meskipun penerapan yang tepat bergantung pada konfigurasi Anda, hal ini biasanya dapat dicapai dalam skrip Anda dengan menggunakan tindakan Placecall untuk memulai panggilan, dan menghubungkan tindakan Agent Assist ke cabang OnAnswer dari Placecall. Lihat dokumentasi bantuan NiCE CXone Studio untuk mengetahui informasi selengkapnya tentang Placecall, Onanswer, dan Agent Assist.

Catatan detail akun NiCE CXone

Ikuti langkah ini untuk mengumpulkan detail akun NiCE CXone Anda. Anda akan memerlukan informasi ini untuk mengonfigurasi Agen NiCE CXone untuk Service Cloud Voice (BYOT) di Salesforce nanti.

Catat nomor Unit Bisnis NiCE dari konsol NiCE CXone. Di project Salesforce Anda (yang akan Anda clone pada langkah berikutnya), di ServiceCloudVoicePlatformService.js, perbarui CONFIG.niceBusNo untuk mencerminkan nomor Unit Bisnis NiCE Anda. Hal ini akan memungkinkan modul UI Agent Assist LWC menentukan conversationName yang dibuat oleh NiCE CXone Agent Assist Hub (lihat metode generateNiCEConversationName dalam file yang sama untuk detailnya).
Catat nomor telepon Kontak (POC) NiCE dari konsol NiCE CXone. Ini adalah nomor yang akan dihubungi pelanggan Anda untuk berbicara dengan agen Anda, dan yang akan Anda gunakan untuk menguji integrasi Agent Assist ini.

Langkah 2: Siapkan project pengembangan Salesforce 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
```
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.
```
npm run generate-static-resources
npm install
```

Perbarui ServiceCloudVoicePlatformService.js dengan nomor Unit Bisnis NiCE yang Anda catat di langkah sebelumnya:

const CONFIG = {
// For this.platform = "servicecloudvoice-nice", the NiCE Business Unit Number
// https://help.nicecxone.com/content/acd/businessunits/managebusinessunit.htm
niceBusNo: 1234567 // Make sure this matches your NiCE CXone Business Unit Number.
};

Langkah 3: 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 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 4: Buat aplikasi klien eksternal

LWC Salesforce menggunakan alur OAuth 2.0 kredensial klien untuk mengautentikasi Anda. Aplikasi klien eksternal mengaktifkan 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.
Di kotak Quick Find, masukkan External Client App Manager.
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
Klik Create.
Buka menu bar > menu Penyiapan, lalu klik Penyiapan.
Di kotak Quick Find, masukkan External Client App Manager.
Klik nama aplikasi klien eksternal 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. Di kotak Quick Find, masukkan External Client App Manager.
Klik nama aplikasi klien eksternal 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 berikutnya.

Menetapkan kebijakan keamanan konten dan CORS

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

Langkah 5: Instal NiCE CXone Agent for Service Cloud Voice (BYOT)

Salesforce menyediakan lisensi add-on Service Cloud Voice, yang memungkinkan integrasi softphone pihak ketiga dengan instance Salesforce Anda. NiCE CXone menyediakan add-on Service Cloud Voice yang disebut NiCE CXone Agent for Service Cloud Voice (BYOT). Ikuti dokumentasi NiCE untuk menyiapkan Agen NiCE CXone untuk Service Cloud Voice (BYOT) di instance Salesforce yang mendukung SCV.

Langkah 6: Instal Komponen Web Lightning Salesforce

Ikuti langkah-langkah berikut untuk menggunakan Lightning Experience Editor guna menambahkan Komponen Web Lightning Salesforce ke halaman kontak tempat NiCE CXone Agent for Service Cloud Voice (BYOT) terbuka saat ada panggilan baru.

Buka Konsol Layanan.
Login ke NiCE CXone Agent for Service Cloud Voice (BYOT) di panel utilitas.
Hubungi nomor POC NiCE yang terkait dengan akun NiCE yang Anda gunakan untuk login.
Terima panggilan masuk. Tindakan ini akan membuka tab rekaman Panggilan Voice baru.
Klik menu Penyiapan > Edit Halaman.
Klik Template > Ubah.
1. Pilih Header dan Dua Wilayah yang Sama.
2. Klik Berikutnya.
3. Petakan setiap wilayah ke wilayah baru.
4. Klik Done.
Dari sidebar Komponen, pindahkan agentAssistContainerModule ke sidebar. Catatan: Perintah npm deploy menyediakan komponen ini.
Klik komponen yang Anda tempatkan di langkah sebelumnya dan 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, dan AGENT_COACHING. Perhatikan bahwa beberapa fitur, seperti SMART_REPLY, tidak tersedia untuk voice.
- channel: Menunjukkan bahwa integrasi adalah voice.
- platform: Menunjukkan bahwa platformnya adalah servicecloudvoice-nice.
- 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 4.
- consumerSecret: Rahasia pengguna aplikasi klien eksternal dari Langkah 4.

Langkah 7: Uji integrasi

Anda dapat menguji integrasi suara dengan panggilan uji ke pusat panggilan Salesforce.

Login ke NiCE CXone Agent for Service Cloud Voice (BYOT) dari widget Omni-Channel di panel utilitas Konsol Layanan.
Hubungi nomor POC NiCE CXone Anda. Anda dapat menemukannya di konsol NiCE CXone.
Di Konsol Layanan, terima panggilan masuk. Layar akan membuka rekaman Panggilan Suara baru.
Di rekaman Panggilan Voice, Komponen Web Lightning Salesforce akan dimuat di sidebar.
Uji kedua sisi percakapan, pastikan transkripsi dan fitur Agent Assist berfungsi seperti yang telah Anda konfigurasi di profil percakapan di konsol Agent Assist.

Integrasi suara Salesforce dengan NiCE CXone Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.