Integrazione della chat di Salesforce

Questa integrazione della chat utilizza un componente web Lightning (LWC) di Salesforce per l'integrazione con i moduli dell'interfaccia utente di Agent Assist per le conversazioni in chat.

Ecco una panoramica generale dell'integrazione della chat:

Architettura per l'integrazione della chat di Agent Assist con Salesforce

Prima di iniziare

Per integrare i moduli dell'interfaccia utente di Agent Assist con Salesforce, devi prima configurare le risorse richieste.

Passaggio 1: configura il progetto di sviluppo di Salesforce

Per iniziare a integrare i moduli dell'interfaccia utente di Assistente agente, segui questi passaggi.

  1. Esegui il seguente codice per clonare il repository di integrazione di Agent Assist e aprire il progetto:

    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
cd salesforce/aa-lwc

  2. Esegui i seguenti comandi per scaricare i file JavaScript dei moduli dell'interfaccia utente che eseguirai il deployment in un secondo momento come risorse statiche. Salesforce richiede risorse statiche per caricare JavaScript di terze parti. Applica anche un limite di 5 MB per i file di risorse statiche, quindi i file JavaScript vengono caricati come file zip.

    npm run generate-static-resources
npm install

Passaggio 2: configura l'ambiente Salesforce

Puoi integrare i moduli dell'interfaccia utente di Agent Assist in un ambiente specifico, ad esempio di produzione o di sviluppo. Salesforce chiama questi ambienti organizzazioni (org).

Configura l'organizzazione nella console Salesforce

Nella console Salesforce, segui questi passaggi per configurare l'organizzazione per l'integrazione di Assistente agente.

  1. Fai clic su Configurazione > Configurazione. Nella casella Ricerca rapida, inserisci Impostazioni Omni-Channel, quindi fai clic su Impostazioni Omni-Channel.
    1. Seleziona Attiva Omni-Channel.
    2. Seleziona Esegui automaticamente l'accesso degli agenti a Omni-Channel nella nuova finestra o scheda.
    3. Fai clic su Salva.
  2. Fai clic su Configurazione > Configurazione. Nella casella Ricerca rapida, inserisci Community, quindi fai clic su Esperienze digitali > Impostazioni.
    1. Seleziona Attiva workspace di Experience Cloud.
    2. Fai clic su Salva.

Configura l'organizzazione con l'interfaccia a riga di comando di Salesforce

Segui questi passaggi per utilizzare l'interfaccia a riga di comando di Salesforce per configurare l'organizzazione per l'integrazione di Assistente agente.

  1. Esegui il seguente codice e autentica l'interfaccia a riga di comando utilizzando i dettagli di accesso a Salesforce che utilizzi normalmente.

    npm run login

  2. Esegui il seguente codice per eseguire il deployment del componente web Lightning nell'organizzazione.

    npm run deploy

Passaggio 3: crea un'app client esterna

Il componente web Lightning di Salesforce utilizza il flusso OAuth 2.0 delle credenziali client per autenticarti. Un'app client esterna consente il flusso delle credenziali client. Utilizza la chiave utente e il secret utente dell'app per configurare il componente web Lightning di Salesforce in modo da autenticare gli utenti con Salesforce.

  1. Fai clic su Configurazione > Configurazione. Nella casella Ricerca rapida, inserisci Gestione app client esterna.
    1. Fai clic su Gestione app client esterna > Nuova app client esterna > Crea, quindi inserisci le seguenti informazioni.
      • Nome app client esterna: lwc auth
      • Nome API: lwc_auth
      • Email di contatto: your_email@example.com
      • API (Attiva impostazioni OAuth) > Attiva OAuth: selezionato
      • API (Attiva impostazioni OAuth) > URL di callback: https://login.salesforce.com/services/oauth2/callback
      • API (Attiva impostazioni OAuth) > Ambiti OAuth selezionati: accedi al servizio URL identità
      • API (Attiva impostazioni OAuth) > Abilita flusso credenziali client: selezionato
    2. Fai clic su Crea.
  2. Fai clic su Configurazione > Configurazione. Nella casella Ricerca rapida, inserisci Gestione app client esterna.
    1. Fai clic sul nome dell'app client esterna > Modifica.
    2. Vai a Policy OAuth > Flussi OAuth e miglioramenti dell'app client esterna.
    3. Assicurati che l'opzione Abilita flusso credenziali client sia selezionata.
    4. In Esegui come, inserisci il nome utente di accesso.
    5. Fai clic su Salva.
  3. Fai clic su Configurazione > Configurazione. Nella casella Ricerca rapida, inserisci Gestione app client esterna.
    1. Fai clic sul nome dell'app client esterna > Modifica.
    2. Vai a Impostazioni OAuth > Impostazioni app > Chiave utente e secret.
    3. Inserisci il codice di verifica inviato al tuo indirizzo email.
    4. Copia la chiave utente e il secret utente in un luogo sicuro. Ti serviranno per un passaggio successivo.

Stabilisci policy CORS e di sicurezza dei contenuti

  1. Fai clic su Configurazione > Configurazione.
  2. Nella casella Ricerca rapida, inserisci CORS, quindi fai clic su Modifica.
    1. Seleziona Attiva CORS per gli endpoint OAuth.
    2. Fai clic su Salva.
  3. Fai clic su Configurazione > Configurazione.
  4. Nella casella Ricerca rapida, inserisci URL attendibili, quindi fai clic su Nuovo URL attendibile.
  5. Inserisci le seguenti informazioni:
    • Nome API: ui_connector
    • URL: inserisci l'URL dell'endpoint del servizio Cloud Run del connettore dell'interfaccia utente di cui hai eseguito il deployment con il backend di integrazione di Agent Assist. Puoi trovare questo URL nella console Cloud Run. Ad esempio: https://UI_CONNECTOR_SUBDOMAIN.GCP_REGION.run.app.
    • Direttive CSP: seleziona tutte le caselle di controllo.
    • Fai clic su Salva e nuovo.
  6. Inserisci le seguenti informazioni:
    • Nome API: ui_connector_wss
    • URL: inserisci l'URL Secure WebSockets per l'endpoint del servizio del connettore dell'interfaccia utente: wss://UI_CONNECTOR_SUBDOMAIN.GCP_REGION.run.app.
    • Direttive CSP: seleziona tutte le caselle di controllo.
    • Fai clic su Salva e nuovo.
  7. Inserisci le seguenti informazioni:
    • Nome API: salesforce_domain
    • URL: inserisci l'URL del tuo dominio Salesforce nel seguente formato: https://YOUR_SUBDOMAIN.my.salesforce.com.
    • Direttive CSP: seleziona tutte le caselle di controllo.
    • Fai clic su Salva.

Passaggio 4: configura il client di chat

Per utilizzare i moduli dell'interfaccia utente di Agent Assist con Salesforce, devi avere un client chat sul desktop dell'agente.

Configura la chat avanzata

Segui questi passaggi per configurare il messenger.

  1. Fai clic su Configurazione > Configurazione. Inserisci una ricerca Ricerca rapida per Code, quindi fai clic su Nuova.
    1. Inserisci le seguenti informazioni:
      • Etichetta: Messaging Queue
      • Nome coda: Messaging_Queue
      • Configurazione di routing: Messaging_Routing_Configuration
    2. Fai clic su Oggetti supportati, quindi aggiungi Utente di messaggistica e Sessione di messaggistica.
    3. Fai clic su Membri della coda, quindi aggiungi Utente: il tuo utente di accesso.
    4. Fai clic su Salva.
  2. Fai clic su Configurazione > Configurazione. Nella casella Ricerca rapida, inserisci Set di autorizzazioni.
    1. Fai clic su Set di autorizzazioni degli agenti di messaggistica.
    2. Fai clic su Accesso agli stati di presenza del servizio > Modifica.
    3. Seleziona gli stati Occupato e Online - Messaggistica.
    4. Fai clic su Aggiungi > Salva.
  3. Fai clic su Configurazione > Configurazione. Nella casella Ricerca rapida, inserisci Utenti, quindi fai clic su Utenti.
    1. Fai clic sul tuo nome utente e verifica che l'opzione Utente di Service Cloud sia attivata.
    2. Trova Assegnazioni di licenze del set di autorizzazioni nella pagina.
    3. Fai clic su Modifica assegnazioni, quindi seleziona Enhanced Chat User.
    4. Fai clic su Salva.
    5. Trova Assegnazioni di set di autorizzazioni nella pagina.
    6. Fai clic su Modifica assegnazioni, quindi seleziona Set di autorizzazioni degli agenti di messaggistica.
    7. Fai clic su Aggiungi > Salva.
  4. Fai clic su Configurazione > Configurazione. Nella casella Ricerca rapida, inserisci Impostazioni di messaggistica, quindi fai clic su Nuovo canale.
    1. Seleziona Chat avanzata.
    2. Inserisci il Nome: Messaging Channel.
    3. Fai clic su Salva.
    4. Imposta Tipo di routing su Coda Omni-Channel e Coda su Coda di messaggistica.
    5. Fai clic su Salva e vai a Impostazioni di messaggistica.
    6. Fai clic sul nome del canale di messaggistica, quindi fai clic su Attiva.
    7. Dopo averli letti, accetta i Termini e condizioni.
  5. Fai clic su Configurazione > Configurazione. Nella casella Ricerca rapida, inserisci Implementazioni del servizio incorporato, quindi fai clic su Nuova implementazione.
    1. Fai clic su Chat avanzata > Avanti > Web > Avanti.
    2. Compila i seguenti dettagli:
      • Nome: Messaging Embedded Service Deployment
      • Nome sviluppatore: Messaging_Embedded_Service_Deployment
      • Dominio: example.com
      • Canale: Messaging Channel
    3. Fai clic su Salva. Attendi il completamento del deployment.
    4. Nelle impostazioni di Implementazione del servizio incorporato, fai clic su Pubblica.
    5. Fai clic su Aggiorna, quindi su Testa la messaggistica.

Testa la chat avanzata

Segui questi passaggi per testare il messenger.

  1. Fai clic su Testa la messaggistica.
  2. Dopo il caricamento della nuova scheda, fai clic sul fumetto per avviare una nuova conversazione di test.
  3. Invia un messaggio, ad esempio Test.
  4. Vai alla scheda del browser Salesforce.
  5. Fai clic sul menu Avvio app, quindi seleziona Service Console.
  6. Fai clic su Omni-Channel.
  7. Imposta lo stato su Online - Messaggistica.
  8. Accetta il messaggio in arrivo. Si apre una nuova scheda nella Service Console per la conversazione. Non puoi visualizzare la trascrizione della chat.
  9. Fai clic su Impostazioni e seleziona Modifica pagina.
  10. Dal menu Componenti, trascina il componente Conversazione avanzata nella sezione Conversazione.
  11. Fai clic su Salva > Attiva > Assegna come predefinito dell'organizzazione > Desktop > Indietro .
  12. Aggiorna la pagina.
  13. Fai clic su Omni-Channel.
  14. Imposta lo stato su Online - Messaggistica.
  15. Rispondi al messaggio Test per verificare che la messaggistica funzioni.

Se hai difficoltà e hai bisogno di ulteriori informazioni, consulta la guida completa alla configurazione della chat avanzata di Salesforce.

Passaggio 5: installa il componente web Lightning di Salesforce

Segui questi passaggi per aggiungere il componente web Lightning di Salesforce a una pagina della sessione di messaggistica utilizzando l' editor di Lightning Experience. Continua con la conversazione di test del passaggio 4.

  1. Fai clic su Impostazioni e seleziona Modifica pagina.

  2. Dall'elenco Componenti, trascina agentAssistContainerModule nella pagina.

  3. Fai clic sul componente che hai inserito nel passaggio precedente.

  4. Compila i campi del modulo come segue per aggiungere i dettagli di configurazione.

    • endpoint: l'URL del connettore dell'interfaccia utente del backend di integrazione dell'agente, ad esempio un URL della console Cloud Run, come: https://UI_CONNECTOR_ENDPOINT.GCP_REGION.run.app
    • channel: indica che il canale è chat.
    • platform: indica che la piattaforma è messaging.
    • conversationProfile: il nome della risorsa del profilo di conversazione di Agent Assist (ad esempio:projects/GCP_PROJECT_ID/locations/GCP_REGION/conversationProfiles/CONVERSATION_PROFILE_ID)
    • consumerKey: la chiave utente dell'app client esterna del passaggio 3.
    • consumerSecret: il secret utente dell'app client esterna del passaggio 3.
    • containerHeight: l'altezza del container di Agent Assist.