Integrazione della chat di Salesforce

Utilizza il componente web Lightning (LWC) di Salesforce per l'integrazione con i moduli dell'interfaccia utente di Agent Assist per le conversazioni di chat.

Prima di iniziare

Per integrare i moduli dell'interfaccia utente di Assistente agente con Salesforce, devi accedere alle seguenti risorse:

  • Node.js

    Segui le istruzioni di installazione consigliate per il tuo sistema operativo.

  • Salesforce CLI

    Segui le istruzioni di installazione consigliate per il tuo sistema operativo.

  • Google Cloud CLI

    Installa il comando gcloud come indicato e autenticati utilizzando gcloud auth login.

  • Salesforce

    1. Accedi all'URL dell'istanza o alla pagina di accesso di Salesforce e prendi nota di quanto segue:
    2. L'URL Il mio dominio di Salesforce. Per trovare l'URL del mio dominio, segui questi passaggi:
      1. Vai alla barra dei menu > menu Configurazione.
      2. Fai clic su Configurazione.
      3. Nella casella Ricerca rapida, inserisci Il mio dominio. Il nome di dominio ha il seguente formato: MY-DOMAIN-NAME.develop.my.salesforce.com.
    3. L'ID organizzazione Salesforce. Per trovare l'ID organizzazione, segui questi passaggi:
      1. Vai alla barra dei menu > menu Configurazione.
      2. Fai clic su Configurazione.
      3. Nella casella Ricerca rapida, inserisci Informazioni società. Nota: questi passaggi di integrazione sono stati testati solo con Salesforce Developer Edition. Se utilizzi un'altra versione, potrebbero verificarsi differenze nelle licenze delle funzionalità e nell'interfaccia di Salesforce.

  • Backend di integrazione di Agent Assist

    1. Segui le istruzioni per configurare l'integrazione.
    2. Prima di eseguire lo script di deployment, configura le seguenti variabili di ambiente con deploy.sh o in un file .env nella radice del progetto:
    3. AUTH_OPTION: imposta questo valore su SalesforceLWC.
    4. SALESFORCE_DOMAIN: un nome di dominio simile a YOUR_SUBDOMAIN.develop.lightning.force.com. Hai annotato questo valore nel prerequisito di Salesforce. Tieni presente che non devi includere https://.
    5. SALESFORCE_ORGANIZATION_ID: hai annotato questo valore nel prerequisito di Salesforce.

Passaggio 1: configura il progetto

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

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

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

  2. Scarica i file JS, che vengono implementati in un secondo momento come risorse statiche, eseguendo i seguenti comandi:

    npm run generate-static-resources
npm install

Passaggio 2: configura l'ambiente

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

Configurare l'organizzazione nella console Salesforce

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

  1. Vai alla barra dei menu > menu Configurazione, poi fai clic su Configurazione. Nella casella Ricerca rapida, inserisci Impostazioni omnicanale e poi fai clic su Impostazioni omnicanale.
    1. Seleziona Attiva Omni-Channel.
    2. Seleziona Accedi automaticamente a Omni-Channel per gli agenti nella nuova finestra o scheda.
    3. Fai clic su Salva.
  2. Vai alla barra dei menu > menu Configurazione, poi fai clic su Configurazione. Nella casella Ricerca rapida, inserisci Community, quindi fai clic su Esperienze digitali > Impostazioni.
    1. Seleziona Enable Experience Workspaces (Attiva spazi di lavoro dell'esperienza).
    2. Fai clic su Salva.

Configurare l'organizzazione con la CLI di Salesforce

Segui questi passaggi per utilizzare la CLI di Salesforce per configurare l'organizzazione per l'integrazione di Assistente agente.

  1. Esegui il seguente codice e autentica la CLI utilizzando le credenziali di accesso a Salesforce che utilizzi normalmente.

    npm run login

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

    npm run deploy

Passaggio 3: crea un'app client esterna

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

  1. Vai alla barra dei menu > menu Configurazione, poi fai clic su Configurazione. Nella casella Ricerca rapida, inserisci Gestione app client esterna.
    1. Fai clic su External Client App Manager > New External Client App > Create, poi inserisci le seguenti informazioni.
    2. Nome dell'app client esterna: lwc auth
    3. Nome API: lwc_auth
    4. Email di contatto: your_email@example.com
    5. API (Enable OAuth Settings) (API (Abilita impostazioni OAuth)) > Enable OAuth (Abilita OAuth): selezionato
    6. API (Enable OAuth Settings) > Callback URL: https://login.salesforce.com/services/oauth2/callback
    7. API (Enable OAuth Settings) (API (Abilita impostazioni OAuth)) > Selected OAuth Scopes (Ambiti OAuth selezionati): accedi al servizio URL identità
    8. API (Enable OAuth Settings) > Enable Client Credentials Flow (API (Abilita impostazioni OAuth) > Abilita flusso credenziali client): selezionato
    9. Fai clic su Crea.
  2. Vai alla barra dei menu > menu Configurazione, poi fai clic su Configurazione. Nella casella Ricerca rapida, inserisci Gestione app client esterna.
    1. Fai clic sul nome dell'app client esterna > Modifica.
    2. Vai a OAuth Policies (Norme OAuth) > OAuth Flows and External Client App Enhancements (Miglioramenti dei flussi OAuth e dell'app client esterno).
    3. Assicurati che l'opzione Abilita flusso credenziali client sia selezionata.
    4. In Esegui come, inserisci il tuo nome utente di accesso.
    5. Fai clic su Salva.
  3. Vai alla barra dei menu > menu Configurazione, poi fai clic su Configurazione. Nella casella Ricerca rapida, inserisci Gestione app client esterna.
    1. Fai clic sul nome dell'app client esterna > Modifica.
    2. Vai a OAuth Settings (Impostazioni OAuth) > App Settings (Impostazioni app) > Consumer Key and Secret (Chiave e secret del consumer).
    3. Inserisci il codice di verifica inviato al tuo indirizzo email.
    4. Copia la chiave utente e il secret consumer in un luogo sicuro. Ti serviranno per un passaggio successivo.

Stabilisci criteri CORS e di sicurezza dei contenuti

  1. Vai alla barra dei menu > menu Configurazione, poi fai clic su 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. Vai alla barra dei menu > menu Configurazione, poi fai clic su Configurazione.
  4. Nella casella Ricerca rapida, inserisci URL attendibili, quindi fai clic su Nuovo URL attendibile.
  5. Inserisci il nome API: ui_connector
    1. Inserisci l'URL dell'endpoint del servizio Cloud Run del connettore UI di cui hai eseguito il deployment con il backend dell'integrazione di Agent Assist. Puoi trovare questo URL nella console Cloud Run. Ad esempio https://<var>UI_CONNECTOR_SUBDOMAIN</var>.<var>GCP_REGION</var>.run.app.
    2. Seleziona tutte le caselle di controllo in Direttive CSP.
    3. Fai clic su Salva e nuovo.
  6. Inserisci il nome API: salesforce_domain
    1. Inserisci l'URL del tuo dominio Salesforce nel seguente formato: https://<var>YOUR_SUBDOMAIN</var>.my.salesforce.com.
    2. Seleziona tutte le caselle di controllo in Direttive CSP.
    3. Fai clic su Salva.

Passaggio 4: configura il client di chat

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

Configurare la chat avanzata

Per configurare il messenger, segui questi passaggi.

  1. Vai alla barra dei menu > menu Configurazione, poi fai clic su Configurazione. Nella casella Ricerca rapida, inserisci URL attendibili, quindi fai clic su Nuovo URL attendibile.
    1. Inserisci il nome API: ui_connector.
    2. Inserisci l'URL dell'endpoint del servizio Cloud Run del connettore UI di cui hai eseguito il deployment con il backend dell'integrazione di Agent Assist. Puoi trovare questo URL nella console Cloud Run. Ad esempio: https://<var>UI_CONNECTOR_SUBDOMAIN</var>.us-central1.run.app.
    3. Seleziona tutte le caselle di controllo in Direttive CSP.
    4. Fai clic su Salva e nuovo.
    5. Inserisci il nome API: twilio_flex.
    6. Inserisci l'URL https://flex.twilio.com.
    7. Seleziona tutte le caselle di controllo in Direttive CSP.
    8. Fai clic su Salva e nuovo.
    9. Inserisci il nome API: salesforce_domain.
    10. Inserisci l'URL del tuo dominio Salesforce nel seguente formato: https://<var>YOUR_SUBDOMAIN</var>.my.salesforce.com.
    11. Seleziona tutte le caselle di controllo in Direttive CSP.
    12. Fai clic su Salva.
  2. Vai alla barra dei menu > menu Configurazione, poi fai clic su Configurazione. Inserisci una ricerca Ricerca rapida per Code, poi fai clic su Nuovo.
    1. Inserisci le seguenti informazioni:
    2. Etichetta: Messaging Queue
    3. Nome coda: Messaging_Queue
    4. Configurazione del routing: Messaging_Routing_Configuration
    5. Fai clic su Oggetti supportati, quindi aggiungi Utente messaggistica e Sessione di messaggistica.
    6. Fai clic su Membri della coda, quindi aggiungi Utente: il tuo utente di accesso.
    7. Fai clic su Salva.
  3. Vai alla barra dei menu > menu Configurazione, poi fai clic su Configurazione. Nella casella Ricerca rapida, inserisci Set di autorizzazioni.
    1. Fai clic su Messaging Agents Permission Set (Set di autorizzazioni per gli 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.
  4. Vai alla barra dei menu > menu Configurazione, poi fai clic su 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 Service Cloud sia attivata.
    2. Trova Permission Set License Assignments (Assegnazioni licenze set di autorizzazioni) nella pagina.
    3. Fai clic su Modifica assegnazioni, poi seleziona Utente chat avanzata.
    4. Fai clic su Salva.
    5. Trova Permission Set Assignments (Assegnazioni set di autorizzazioni) nella pagina.
    6. Fai clic su Modifica assegnazioni e poi seleziona Set di autorizzazioni agente di messaggistica.
    7. Fai clic su Aggiungi > Salva.
  5. Vai alla barra dei menu > menu Configurazione, poi fai clic su Configurazione. Nella casella Ricerca rapida, inserisci Impostazioni di messaggistica e poi fai clic su Nuovo canale.
    1. Seleziona Chat avanzata.
    2. Inserisci il Nome: Canale di messaggistica.
    3. Fai clic su Salva.
    4. Imposta Tipo di routing su Omni-Queue e Coda su Coda di messaggistica.
    5. Fai clic su Salva e vai a Impostazioni di messaggistica.
    6. Fai clic sul nome del tuo canale di messaggistica, poi su Attiva.
    7. Dopo averli letti, accetta i Termini e condizioni.
  6. Vai alla barra dei menu > menu Configurazione, poi fai clic su Configurazione. Nella casella Ricerca rapida, inserisci Deployment del servizio incorporato, quindi fai clic su Nuovo deployment.
    1. Fai clic su Chat avanzata > Avanti > Web > Avanti.
    2. Inserisci i seguenti dettagli:
    3. Nome: Deployment del servizio di messaggistica incorporato
    4. Nome sviluppatore: Messaging_Embedded_Service_Deployment
    5. Dominio: example.com
    6. Canale: Canale di messaggistica
    7. Fai clic su Salva. Attendi il completamento del deployment.
    8. Nelle impostazioni di Embedded Service Deployment, fai clic su Pubblica.
    9. Fai clic su Aggiorna, poi su Test Messaging (Test messaggistica).

Testare la chat avanzata

Segui questi passaggi per testare il tuo messenger.

  1. Fai clic su Test Messaging (Prova 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. Nella barra degli strumenti Configurazione, fai clic sul menu Avvio app, quindi seleziona Service Console (Service Console).
  6. Fai clic su Omnicanale nella barra degli strumenti delle utilità.
  7. Imposta il tuo stato su Online - Messaggi.
  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. Vai alla barra dei menu > menu Configurazione.
  10. Fai clic su Modifica pagina.
  11. Dal menu Componenti, trascina il componente Conversazione avanzata nel riquadro Conversazione.
  12. Fai clic su Salva > Attiva > Assegna come predefinito dell'organizzazione > Desktop > Indietro .
  13. Aggiorna la pagina.
  14. Fai clic su Omnicanale nella barra degli strumenti delle utilità.
  15. Imposta il tuo stato su Online - Messaggi.
  16. Rispondi al messaggio Test per verificare che la messaggistica funzioni.

Se hai difficoltà e hai bisogno di maggiori 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 (LWC) di Salesforce a una pagina della sessione di messaggistica utilizzando l'editor Lightning Experience. Continua con la conversazione di test del passaggio 4.

  1. Vai alla barra dei menu > menu Configurazione, poi fai clic su Modifica pagina.

  2. Dalla barra laterale Componenti, sposta agentAssistContainerModule nella barra laterale.

  3. Fai clic sul componente inserito nel passaggio precedente.

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

    • Endpoint: l'URL del connettore UI del backend di integrazione dell'agente, ad esempio un URL della console Cloud Run, come: https://<var>UI_CONNECTOR_ENDPOINT</var>.<var>GCP_REGION</var>.run.app
    • Funzionalità: funzionalità di Agent Assist attivate nel profilo di conversazione, ad esempio CONVERSATION_SUMMARIZATION,KNOWLEDGE_ASSIST_V2,SMART_REPLY e AGENT_COACHING
    • channel: indica che il canale è chat.
    • platform: indica che la piattaforma è messaging.
    • conversationProfile: il nome della risorsa del profilo di conversazione di Agent Assist (esempio: projects/<var>GCP_PROJECT_ID</var>/locations/<var>GCP_REGION</var>/conversationProfiles/<var>CONVERSATION_PROFILE_ID</var>)
    • consumerKey: la chiave utente dell'app client esterna del passaggio 3
    • consumerSecret: il segreto consumatore dell'app client esterna del passaggio 3