Menyiapkan pengalaman tersemat di Salesforce

2025-04-01

Anda dapat menyematkan agen AI yang telah dikonfigurasi sebelumnya langsung ke desktop Salesforce dengan kesadaran kontekstual tentang platform yang mendasarinya. Integrasi ini membantu agen AI memberikan respons yang lebih baik, dan membantu lebih merampingkan alur kerja untuk perwakilan layanan pelanggan Anda.

Prasyarat

Sebelum memulai, Anda harus memiliki lingkungan dan konsol berikut:

Instans Copilot untuk Layanan yang terhubung ke lingkungan Salesforce.
Lingkungan produksi Salesforce atau lingkungan uji coba dengan akses ke konsol Layanan Salesforce.

Selain itu, agar perwakilan layanan Anda dapat menggunakan Copilot for Service di Salesforce, Anda harus menetapkan peran Agen Pengguna Dasar dan Multisaluran kepada mereka. Pelajari lebih lanjut di Menetapkan peran keamanan kepada pengguna.

Mengintegrasikan agen layanan yang telah dikonfigurasi sebelumnya

Lakukan langkah-langkah di Navigasi untuk menyalin URL widget Copilot yang dapat disematkan dimulai setelah <iframe src=>. Sebagai contoh, https://copilotforservice-test.azureedge.net/widget/index.html?dynamicsUrl=https://XXXXXX.crm10.dynamics.com. Simpan URL secara lokal, di mana Anda dapat menyalin dan menempelkannya di bidang URL Adaptor CTI jika Anda menggunakan softphone CTI atau di jika CFS_WIDGET_URL Anda menggunakan komponen kustom.

Anda dapat mengintegrasikan agen layanan yang telah dikonfigurasi sebelumnya di Salesforce dengan salah satu cara berikut.

Softphone CTI
Komponen khusus

Buka konsol Layanan Salesforce, lalu pilih ikon Penyiapan (roda gigi) di sudut kanan atas.
Di bidang pencarian, ketik pusat panggilan, lalu di hasil pencarian, pilih Pusat Panggilan.
Jika Anda menyiapkan widget ini untuk pertama kalinya, Anda mungkin melihat halaman dengan pesan yang bertuliskan,Sapa ke Pusat Panggilan Salesforce.
Pilih Lanjutkan.

Buka editor teks, lalu salin kode XML berikut ke dalamnya dan simpan secara lokal sebagai CopilotForServiceConfig.xml.

  <callCenter>
  <section sortOrder="0" name="reqGeneralInfo" label="General Information">
  <item sortOrder="0" name="reqInternalName" label="InternalName">CopilotForService</item>
  <item sortOrder="1" name="reqDisplayName" label="Display Name">Copilot For Service</item>
  <item sortOrder="2" name="reqAdapterUrl" label="CTI Adapter URL">https://TobeUpdated.ms</item>
  <item sortOrder="3" name="reqUseApi" label="Use CTI API">true</item>
  <item sortOrder="4" name="reqSoftphoneHeight" label="Softphone Height">600</item>
  <item sortOrder="5" name="reqSoftphoneWidth" label="Softphone Width">450</item>
  <item sortOrder="6" name="reqSalesforceCompatibilityMode" label="Salesforce Compatibility Mode">Classic_and_Lightning</item>
  </section>
 </callCenter>

Pilih Impor Pilih>File, lalu navigasikan ke dan pilih file CopilotForServiceConfig.xml yang Anda simpan di langkah 4.
Pilih impor.
Pilih Edit, lalu di bidang URL Adaptor CTI, tempelkan URL untuk URL widget Copilot for Service yang Anda simpan di Langkah 1.
Pilih Simpan.
Lakukan langkah-langkah berikut untuk menambahkan pengguna Salesforce:
1. Di konsol Layanan Salesforce, pilih Kelola Pengguna>Pusat Panggilan Tambahkan lebih banyak pengguna.
2. Tambahkan setiap pengguna Salesforce yang ingin Anda akses widget Copilot for Service.
Lakukan langkah-langkah berikut untuk menambahkan utilitas softphone:
1. Pilih Penyiapan, lalu cari dan pilih Pengelola Aplikasi.
2. Temukan aplikasi Service Console , pilih segitiga terbalik pada baris yang sama, lalu pilih Edit.
3. Pilih Item Utilitas>Tambahkan Item Utilitas.
4. Cari dan pilih Buka CTI Softphone.
5. Ketik nama untuk widget Anda, seperti "Microsoft Copilot untuk Layanan".
6. Atur lebar menjadi 450 dan tinggi menjadi 600.
7. Pilih Simpan.
Lakukan langkah-langkah berikut untuk mengaktifkan popup:
1. Di Salesforce, buka konsol layanan dari halaman Aplikasi .
2. Aktifkan popup dengan memilih Selalu izinkan pop-up dan pengalihan dari <url>.
3. Pilih Selesai.
4. Refresh browser Anda. Add-on Copilot for Service sekarang akan tersedia di toolbar konsol agen Anda.

Lakukan langkah-langkah berikut untuk mengonfigurasi widget Copilot for Service di Salesforce:

Buka konsol Layanan Salesforce dan pilih ikon Roda Gigi.
Pilih Konsol Pengembang dari menu drop-down. Jika tidak dimuat, salin URL dari jendela pop-up dan buka di tab baru.

Di Konsol Pengembang, pilih File>kelas> Apex Baru. Tentukan nama sebagai ObjectService dan pilih Buat, lalu tempelkan kode berikut ke editor:

public class ObjectService {
  @AuraEnabled
  public static String getObjectType(String objectId) {
    Id conId = objectId;
    return String.valueOf(conId.getSobjectType());
  }
}

Lakukan langkah-langkah berikut untuk membuat komponen petir:

Pilih File>komponen> Lightning Baru.
Tentukan nama untuk komponen. Misalnya, CopilotForService.
Pilih Pengontrol dari panel bundel yang ditampilkan saat komponen dibuat, lalu tempel kode berikut:

({
  onTabFocused : function(component, event, helper) {
    var currentTabId = event.getParam('currentTabId');
    var previousTabId = event.getParam('previousTabId');
    var workspaceAPI = component.find("workspace");
    if(currentTabId) {       
      workspaceAPI.getTabInfo({
        tabId : currentTabId
      }).then(function(response) {
        var action = component.get("c.getObjectType");
        var recordId = response.recordId;
        action.setParams({"objectId": recordId});
        action.setCallback(this, function(response) {
          var state = response.getState();
          if(state === "SUCCESS") {
            component.set("v.objectType",response.getReturnValue());
            var type = response.getReturnValue();          
            console.log("Object details:", recordId, type);
            var objectType = 0;
            if (type == 'Case') {
              objectType = 1;
            } else if (type == 'EmailMessage') {
              objectType = 2;
            } else if (type == "LiveChatTranscript") {
              objectType = 8;
            }

            console.log("iframe: ", document.querySelector('iframe.CFSLightning'));
            // Invoke adapter to navigate based on objectid and objecttype
            document.querySelector('iframe.CFSLightning').contentWindow.postMessage({
              messageType: "onPageNavigateFromSFLightningComponent",
              messageData: JSON.stringify({
                value: JSON.stringify({
                  objectId: recordId,
                  objectType: objectType,
                  sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850"
                })
              })
            }, "*");
          } else {
            console.log('Problem updating the case, response state: ' + state);
          }
        });
        $A.enqueueAction(action);
      });
    } else {
      // When user navigates to the entity list page, switch to global session
      console.log("global!");
      document.querySelector('iframe.CFSLightning').contentWindow.postMessage({
        messageType: "onPageNavigateFromSFLightningComponent",
        messageData: JSON.stringify({
          value: JSON.stringify({
            objectId: "",
            objectType: 0,
            sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850"
          })
        })
      }, "*");
    }
  }
})

Pilih Simpan.
Pilih Komponen, lalu salin kode berikut:

<aura:component controller="ObjectService" implements="force:lightningQuickAction,force:hasRecordId,flexipage:availableForAllPageTypes" access="global">
  <aura:attribute name="recordId" type="Id" />
  <aura:attribute name="objectType" type="String" />
  <lightning:workspaceAPI aura:id="workspace" />        
  <aura:handler event="lightning:tabFocused" action="{! c.onTabFocused }"/>
  <iframe class="CFSLightning" src="{! '{CFS_WIDGET_URL}'}" width="100%" height="100%" />   
</aura:component>

Perbarui {CFS_WIDGET_URL} ke URL untuk URL widget Copilot for Service yang Anda simpan di langkah sebelumnya.

Lakukan langkah-langkah berikut untuk menambahkan komponen kustom ke bilah utilitas:
1. Pilih Penyiapan, lalu cari dan pilih Pengelola Aplikasi.
2. Cari lalu pilih aplikasi Service Console . Pilih Edit.
3. Pilih Item Utilitas>Tambahkan Item Utilitas.
4. Cari dan pilih komponen lightening kustom di Custom,CopilotForService dalam contoh kami.
5. Tentukan nama untuk widget. Misalnya, Microsoft Copilot untuk Layanan.
6. Atur lebar menjadi 450 dan tinggi menjadi 600.
7. Pilih Simpan.
Lakukan langkah-langkah berikut untuk mengaktifkan popup:
1. Di Salesforce, buka konsol layanan dari halaman Aplikasi .
2. Aktifkan popup dengan memilih Selalu izinkan pop-up dan pengalihan dari <url>.
3. Pilih Selesai.
4. Refresh browser Anda. Add-on Copilot for Service sekarang akan tersedia di toolbar konsol agen Anda.
Lakukan langkah-langkah berikut untuk mengizinkan widget Copilot for Service:
1. Telusuri URL Tepercaya di kotak pencarian di Penyiapan, lalu pilih URL tepercaya.
2. Pilih URL Tepercaya Baru untuk menambahkan URL tepercaya baru.
  - Tentukan CopilotforService sebagai nama API dan URL sebagai "*.azureedge.net"
3. Pilih semua kotak centang di Direktif CSP, lalu pilih Simpan.

Bagikan melalui

Menyiapkan pengalaman tersemat di Salesforce

Prasyarat

Mengintegrasikan agen layanan yang telah dikonfigurasi sebelumnya

Saran dan Komentar

Sumber Daya Tambahan: