Integración del chat de Salesforce

Esta integración de chat usa un componente web de Lightning (LWC) de Salesforce para integrarse con los módulos de la IU de Asistente de agente para conversaciones de chat.

A continuación, se incluye una descripción general de la integración del chat:

Arquitectura para la integración del chat de Agent Assist con Salesforce

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: Sigue las instrucciones de instalación recomendadas para tu sistema operativo.
Google Cloud CLI: Instala el comando gcloud según las instrucciones y autentícate con gcloud auth login.
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. En el cuadro Búsqueda rápida, ingresa Mi dominio. El nombre de dominio tiene el siguiente formato: MY-DOMAIN-NAME.develop.my.salesforce.com.
- Es 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. En el cuadro Búsqueda rápida, ingresa Información de la empresa.
Nota: Estos pasos de integración solo se probaron con la edición para desarrolladores de Salesforce. 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 Salesforce. Ten en cuenta que no debes incluir https://.
  - SALESFORCE_ORGANIZATION_ID: Anotaste este valor en el requisito previo de Salesforce.

Paso 1: Configura tu proyecto de desarrollo de Salesforce

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

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
```
Ejecuta los siguientes comandos para descargar los archivos JavaScript de los módulos de la IU que implementarás más adelante como recursos estáticos. Salesforce requiere recursos estáticos para cargar JavaScript de terceros. También aplica un límite de 5 MB para los archivos de recursos estáticos, por lo que los archivos JavaScript se suben como un archivo ZIP.
```
npm run generate-static-resources
npm install
```

Paso 2: Configura tu entorno de Salesforce

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.

Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. En el cuadro Búsqueda rápida, ingresa Configuración de Omni-channel y, luego, haz clic en Configuración de Omni-channel.
1. Selecciona Habilitar Omni-Channel.
2. Selecciona Acceder automáticamente a Omni-Channel en la nueva ventana o pestaña.
3. Haz clic en Guardar.
Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. En el cuadro Búsqueda rápida, ingresa Comunidades y, luego, haz clic en Experiencias digitales > Configuración.
1. Selecciona 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.

Ejecuta el siguiente código y autentica la CLI con los detalles de acceso de Salesforce que usas normalmente.
```
npm run login
```
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.

Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. En el cuadro Búsqueda rápida, ingresa Administrador de la aplicación cliente externa.
1. Haz clic en External Client App Manager > New External Client App > Create y, luego, ingresa la siguiente información.
  - Nombre de la app del cliente externa: 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 a la URL del servicio de identidad.
  - API (Enable OAuth Settings) > Enable Client Credentials Flow: Seleccionado
2. Haz clic en Crear.
Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. En el cuadro Búsqueda rápida, ingresa Administrador de la aplicación cliente externa.
1. Haz clic en el nombre de tu app cliente externa > Editar.
2. Navega a OAuth Policies > OAuth Flows and External Client App Enhancements.
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.
Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. En el cuadro Búsqueda rápida, ingresa Administrador de la aplicación cliente externa.
1. Haz clic en el nombre de tu app cliente externa > Editar.
2. Navega a OAuth Settings > App Settings > Consumer Key and Secret.
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 en un paso posterior.

Establece políticas de seguridad del contenido y de CORS

Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración.
En el cuadro Búsqueda rápida, ingresa CORS y, luego, haz clic en Editar.
1. Selecciona Habilita CORS para los extremos de OAuth.
2. Haz clic en Guardar.
Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración.
En el cuadro Búsqueda rápida, ingresa URLs de confianza y, luego, haz clic en Nueva URL de confianza.
Ingresa la siguiente información:
- Nombre de la API: ui_connector
- URL: Ingresa la URL del extremo del servicio de Cloud Run del conector de IU que implementaste con el backend de tu integración de Agent Assist. Puedes encontrar esta URL en la consola de Cloud Run. Por ejemplo: https://UI_CONNECTOR_SUBDOMAIN.GCP_REGION.run.app.
- Directivas de CSP: Selecciona todas las casillas de verificación.
- Haz clic en Guardar y crear otro.
Ingresa la siguiente información:
- Nombre de la API: ui_connector_wss
- URL: Ingresa la URL de Secure WebSockets para el extremo de tu servicio de UI Connector: wss://UI_CONNECTOR_SUBDOMAIN.GCP_REGION.run.app.
- Directivas de CSP: Selecciona todas las casillas de verificación.
- Haz clic en Guardar y crear otro.
Ingresa la siguiente información:
- Nombre de la API: salesforce_domain
- URL: Ingresa la URL de tu dominio de Salesforce con el siguiente formato: https://YOUR_SUBDOMAIN.my.salesforce.com.
- Directivas de CSP: Selecciona todas las casillas de verificación.
- Haz clic en Guardar.

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.

Cómo configurar el chat mejorado

Sigue estos pasos para configurar tu Messenger.

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: Messaging Queue
  - Nombre de la cola: Messaging_Queue
  - Configuración de enrutamiento: Messaging_Routing_Configuration
2. Haz clic en Supported Objects y, luego, agrega Messaging User y Messaging Session.
3. Haz clic en Miembros de la fila y, luego, agrega Usuario: Tu usuario de acceso.
4. Haz clic en Guardar.
Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. En el cuadro Búsqueda rápida, ingresa 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.
Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. En el cuadro Búsqueda rápida, ingresa 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 tareas y, luego, selecciona Enhanced Chat User.
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.
Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. En el cuadro Búsqueda rápida, ingresa Configuración de mensajería y, luego, haz clic en Canal nuevo.
1. Selecciona Chat mejorado.
2. Ingresa el Nombre: Messaging Channel.
3. Haz clic en Guardar.
4. Establece Tipo de enrutamiento en Omni-Queue y Cola en Cola de mensajería.
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.
Navega a la barra de menú > menú Configuración y, luego, haz clic en Configuración. En el cuadro Búsqueda rápida, ingresa Implementaciones de servicio integrado y, luego, haz clic en Nueva implementación.
1. Haz clic en Enhanced Chat > Next > Web > Next.
2. Completa los siguientes detalles:
  - Nombre: Messaging Embedded Service Deployment
  - 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.

Probar el Chat mejorado

Sigue estos pasos para probar tu Messenger.

Haz clic en Test Messaging.
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.
Envía un mensaje, como Prueba.
Navega a la pestaña del navegador de Salesforce.
En la barra de herramientas Configuración, haz clic en el menú Selector de aplicaciones y, luego, selecciona Consola de servicio.
Haz clic en Omnicanal en la barra de herramientas de utilidades.
Establece tu estado como En línea - Mensajes.
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.
Navega a la barra de menú > menú Configuración.
Haz clic en Editar página.
En el menú Components, arrastra el componente Enhanced Conversation al panel Conversation.
Haz clic en Guardar > Activar > Asignar como predeterminado de la organización > Escritorio > Atrás .
Actualiza la página.
Haz clic en Omnicanal en la barra de herramientas de utilidades.
Establece tu estado como En línea - Mensajes.
Responde el mensaje de Prueba para validar que la mensajería funcione.

Si tienes problemas y necesitas más información, consulta la Guía de configuración integral del chat mejorado de Salesforce.

Paso 5: Instala el componente web de Salesforce Lightning

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.

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

Nota: El comando npm deploy proporcionó este componente.
Haz clic en el componente que colocaste en el paso anterior.
Completa los campos del formulario de la siguiente manera para agregar detalles de configuración.
- endpoint: Es la URL de tu conector de IU del backend de integración del agente, como una URL de la consola de Cloud Run, como la siguiente: 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
- channel: Indica que el canal es chat.
- plataforma: Indica que la plataforma es messaging.
- conversationProfile: 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 cliente externa del paso 3.
- consumerSecret: Es el secreto del cliente externo de la app del paso 3.