Integración en Salesforce

Usa el componente web de Salesforce Lightning (LWC) para integrar los módulos de la IU de Agent Assist en conversaciones de chat.

Antes de comenzar

Para integrar los módulos de la IU de Agent Assist con Salesforce, necesitas acceso a los siguientes recursos:

  • Node.js

    Sigue las instrucciones de instalación recomendadas para tu sistema operativo.

  • CLI de Salesforce

    Se sabe que la instalación de la CLI de Salesforce con npm causa problemas de compatibilidad. Para evitar estos problemas, usa una de las opciones de instalación pkg (macOS), exe (Windows) o TAR (Linux).

  • CLI de gcloud

    Instala el comando gcloud según las instrucciones y autentícate con gcloud auth login.

  • IU de Salesforce

    • Accede a tu URL de instancia o a la página de acceso de Salesforce y ten en cuenta lo siguiente:
      • La URL de Mi dominio de Salesforce. Sigue estos pasos para encontrar la URL de Mi dominio:
        1. Navega a la barra de menú > menú Configuración.
        2. Haz clic en Configuración.
        3. Ingresa una búsqueda de Búsqueda rápida para Mi dominio. El nombre del dominio tiene el siguiente formato: MY-DOMAIN-NAME.develop.my.salesforce.com.
      • El ID de tu organización de Salesforce Sigue estos pasos para encontrar el ID de la organización:
        1. Navega a la barra de menú > menú Configuración.
        2. Haz clic en Configuración.
        3. Ingresa "Información de la empresa" en la Búsqueda rápida. Nota: Estos pasos de integración solo se probaron con Salesforce Developer Edition. Si usas otra edición, es posible que surjan diferencias en las licencias de las funciones y en la interfaz de Salesforce.
  • Backend de integración de Agent Assist

    1. Sigue las instrucciones para configurar la integración.
    2. Antes de ejecutar la secuencia de comandos de implementación, configura las siguientes variables de entorno con deploy.sh o en un archivo .env en la raíz del proyecto:
      • AUTH_OPTION: Configura esto como SalesforceLWC.
      • SALESFORCE_DOMAIN: Es un nombre de dominio similar a YOUR_SUBDOMAIN.develop.lightning.force.com. Anotaste este valor en el requisito previo de la IU de Salesforce. Ten en cuenta que no debes incluir https://.
      • SALESFORCE_ORGANIZATION_ID: Anotaste este valor en el requisito previo de la IU de Salesforce.

Paso 1: Configura tu proyecto

Para comenzar a integrar los módulos de la IU de Agent Assist, sigue estos pasos.

  1. Ejecuta el siguiente código para clonar el repositorio de integración de Agent Assist y abrir tu proyecto:

    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
    cd salesforce/aa-lwc
    
  2. Ejecuta los siguientes comandos para descargar los archivos JS, que se implementarán más adelante como recursos estáticos:

    npm run generate-static-resources
    npm install
    

Paso 2: Configura tu entorno

Puedes integrar módulos de la IU de Agent Assist en un entorno específico, como el de producción o el de desarrollo. Salesforce llama a estos entornos organizaciones (orgs).

Configura tu organización en la consola de Salesforce

En la consola de Salesforce, sigue estos pasos para configurar tu organización para la integración de Agent Assist.

  1. Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. Ingresa "Configuración de Omni-Channel" en la Búsqueda rápida y, luego, haz clic en Configuración de Omni-Channel.
    1. Marca Habilitar Omni-Channel.
    2. Selecciona Automatically log agents into Omni-Channel in the new window or tab.
    3. Haz clic en Guardar.
  2. Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. Ingresa una búsqueda de Búsqueda rápida para "Comunidades" y, luego, haz clic en Experiencias digitales > Configuración.
    1. Marca Habilitar Experience Workspaces.
    2. Haz clic en Guardar.

Configura tu organización con la CLI de Salesforce

Sigue estos pasos para usar la CLI de Salesforce y configurar tu organización para la integración de Agent Assist.

  1. Ejecuta el siguiente código y autentica la CLI con login details de Salesforce que usas normalmente.

    npm run login
    
  2. Ejecuta el siguiente código para implementar el LWC en la organización.

    npm run deploy
    

Paso 3: Crea una app cliente externa

El LWC de Salesforce usa el flujo de credenciales de cliente de OAuth 2.0 para autenticarte. Una app cliente externa habilita el flujo de credenciales de cliente. Usa la clave y el secreto del consumidor de la app para configurar el LWC de Salesforce y autenticar a los usuarios con Salesforce.

  1. Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. Ingresa "Administrador de la aplicación cliente externa" en la Búsqueda rápida.
    1. Haz clic en External Client App Manager > New External Client App > Create y, luego, ingresa la siguiente información.
      • Nombre de la app conectada: lwc auth
      • Nombre de la API: lwc_auth
      • Correo electrónico de contacto: your_email@example.com
      • API (Enable OAuth Settings) > Enable OAuth: Seleccionado
      • API (Enable OAuth Settings) > URL de devolución de llamada: https://login.salesforce.com/services/oauth2/callback
      • API (Enable OAuth Settings) > Selected OAuth Scopes: Accede al servicio de URL de identidad.
      • API (Enable OAuth Settings) > Enable Client Credentials Flow: Seleccionado
    2. Haz clic en Crear.
  2. Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. Ingresa "Administrador de la aplicación cliente externa" en la Búsqueda rápida.
    1. Haz clic en el nombre de la app conectada > Editar.
    2. Navega a Políticas de OAuth > Mejoras en los flujos de OAuth y en la app del cliente externo.
    3. Asegúrate de que esté seleccionada la opción Habilitar el flujo de credenciales del cliente.
    4. En Ejecutar como, ingresa tu nombre de usuario de acceso.
    5. Haz clic en Guardar.
  3. Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. Ingresa "Administrador de la aplicación cliente externa" en la Búsqueda rápida.
    1. Haz clic en el nombre de la app conectada > Editar.
    2. Navega a Configuración de OAuth > Configuración de la app > Clave y secreto del consumidor.
    3. Ingresa el código de verificación que se envió a tu correo electrónico.
    4. Copia la clave de consumidor y el secreto de consumidor en un lugar seguro. Los necesitarás para un paso posterior.
  4. Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. Ingresa una búsqueda de Búsqueda rápida para “CORS” y, luego, haz clic en Editar.
    1. Consulta Habilita CORS para los extremos de OAuth.
    2. Haz clic en Guardar.

Para obtener más información sobre las apps conectadas, consulta los siguientes recursos de Salesforce.

Paso 4: Configura el cliente de chat

Para usar los módulos de la IU de Agent Assist con Salesforce, necesitas un cliente de chat en el escritorio del agente.

Configura la mensajería para la Web y las aplicaciones

Sigue estos pasos para configurar tu Messenger.

  1. Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. Ingresa "URLs de confianza" en la Búsqueda rápida y, luego, haz clic en Nueva URL de confianza.
    1. Ingresa el Nombre de la API: ui_connector.
    2. Ingresa la URL del extremo del servicio de Cloud Run del conector de la IU que implementaste con el backend de integración de Agent Assist. Puedes encontrar esta URL en la consola de Cloud Run. Por ejemplo: https://UI_CONNECTOR_SUBDOMAIN.us-central1.run.app.
    3. Selecciona todas las opciones en Directivas de CSP.
    4. Haz clic en Guardar y crear otro.
    5. Ingresa el Nombre de la API: twilio_flex.
    6. Ingresa la URL https://flex.twilio.com.
    7. Selecciona todas las opciones en Directivas de CSP.
    8. Haz clic en Guardar y crear otro.
    9. Ingresa el Nombre de la API: salesforce_domain.
    10. Ingresa la URL de tu dominio de Salesforce con el siguiente formato: https://YOUR_SUBDOMAIN.my.salesforce.com.
    11. Selecciona todas las opciones en Directivas de CSP.
    12. Haz clic en Guardar.
  2. Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. Ingresa una búsqueda de Búsqueda rápida para "Filas" y, luego, haz clic en Nuevo.
    1. Ingresa la siguiente información:
      • Etiqueta: Fila de mensajes
      • Nombre de la fila: Messaging_Queue
      • Configuración de enrutamiento: Messaging_Routing_Configuration
    2. Haz clic en Supported Objects y, luego, agrega "Messaging User, Messaging Session".
    3. Haz clic en Queue Members y, luego, agrega "User: Your Login User".
    4. Haz clic en Guardar.
  3. Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. Ingresa una búsqueda de Búsqueda rápida para "Conjuntos de permisos".
    1. Haz clic en Messaging Agents Permission Set.
    2. Haz clic en Service Presence Statuses Access > Edit.
    3. Selecciona los estados Ocupado y En línea - Mensajes.
    4. Haz clic en Agregar > Guardar.
  4. Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. Ingresa una búsqueda de Búsqueda rápida para "Usuarios" y, luego, haz clic en Usuarios.
    1. Haz clic en tu nombre de usuario y verifica que Usuario de Service Cloud esté habilitado.
    2. Busca Permission Set License Assignments en la página.
    3. Haz clic en Editar asignaciones y, luego, marca Mensajería para usuarios web y en la app.
    4. Haz clic en Guardar.
    5. Busca Permission Set Assignments en la página.
    6. Haz clic en Editar asignaciones y, luego, selecciona Conjunto de permisos del agente de mensajería.
    7. Haz clic en Agregar > Guardar.
  5. Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. Ingresa una búsqueda de Búsqueda rápida para "Configuración de mensajería" y, luego, haz clic en Nuevo canal.
    1. Selecciona Messaging for In-App and Web.
    2. Ingresa el Nombre: Canal de mensajería.
    3. Haz clic en Guardar.
    4. Establece Routing Type en "Omni-Queue" y Queue en "Messaging Queue".
    5. Haz clic en Guardar y navega a Configuración de mensajería.
    6. Haz clic en el nombre de tu canal de mensajería y, luego, en Activar.
    7. Después de leerlos, acepta los Términos y Condiciones.
  6. Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. Ingresa una búsqueda de Búsqueda rápida para "Implementaciones de servicio integrado" y, luego, haz clic en Nueva implementación.
    1. Haz clic en Messaging for In-App and Web > Next > Web > Next.
    2. Completa los siguientes detalles:
      • Nombre: Implementación del servicio integrado de mensajería
      • Nombre del desarrollador: Messaging_Embedded_Service_Deployment
      • Dominio: example.com
      • Canal: Canal de mensajería
    3. Haz clic en Guardar. Espera a que se complete la implementación.
    4. En la configuración de Embedded Service Deployment, haz clic en Publicar.
    5. Haz clic en Actualizar y, luego, en Probar mensajería.

Prueba de mensajes para la Web y las aplicaciones

Sigue estos pasos para probar tu Messenger.

  1. Haz clic en Test Messaging.
  2. Después de que se cargue la pestaña nueva, haz clic en la burbuja de diálogo para iniciar una conversación de prueba nueva.
  3. Envía un mensaje, como "Test".
  4. Navega a la pestaña del navegador de Salesforce.
  5. En la barra de herramientas Configuración, haz clic en el menú Selector de aplicaciones y, luego, selecciona Consola de servicios.
  6. Haz clic en Omnicanal en la barra de herramientas de utilidades.
  7. Establece tu estado como En línea - Mensajes.
  8. Acepta el mensaje entrante. Se abrirá una pestaña nueva en la Consola de servicio para la conversación. No puedes ver la transcripción del chat.
  9. Navega a la barra de menú > menú Configuración.
  10. Haz clic en Editar página.
  11. En el menú Components, arrastra Enhanced Conversation al panel Conversation.
  12. Haz clic en Guardar > Activar > Asignar como predeterminado de la organización > Escritorio > Atrás .
  13. Actualiza la página.
  14. Haz clic en Omnicanal en la barra de herramientas de utilidades.
  15. Establece tu estado como En línea - Mensajes.
  16. Responde el mensaje de "Prueba" para validar que la mensajería funciona.

Si tienes problemas y necesitas más información, consulta la Guía de configuración de Salesforce Messaging para aplicaciones y la Web.

Paso 5: Instala el LWC de Salesforce

Sigue estos pasos para agregar el LWC de Salesforce a una página de sesión de mensajería con el Editor de Lightning Experience. Continúa con la conversación de prueba del paso 4.

  1. Navega a la barra de menú > menú Configuración y, luego, haz clic en Editar página.
  2. En la barra lateral Components, mueve el elemento agentAssistContainerModule a la barra lateral.

  3. Haz clic en el componente que colocaste en el paso anterior.

  4. Completa los campos del formulario de la siguiente manera para agregar detalles de configuración.

    • endpoint: Es la URL del conector de la IU de tu backend de integración de agentes, como una URL de la consola de Cloud Run, como https://UI-CONNECTOR-ENDPOINT.GCP-REGION.run.app.
    • funciones: Funciones de Agent Assist habilitadas en tu perfil de conversación, como CONVERSATION_SUMMARIZATION,KNOWLEDGE_ASSIST_V2,SMART_REPLY y AGENT_COACHING
    • conversationProfile: Es el nombre del recurso de tu perfil de conversación de Agent Assist (por ejemplo, projects/GCP-PROJECT-ID/locations/GCP-REGION/conversationProfiles/CONVERSATION-PROFILE-ID).
    • consumerKey: Es la clave de consumidor de la app conectada del paso 3.
    • consumerSecret: El secreto del consumidor de la app conectada del paso 3