Se usó la API de Cloud Translation para traducir esta página.

Integración del chat de Salesforce

Usa el componente web de Lightning (LWC) de Salesforce 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

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
1. Accede a la URL de tu instancia o a la página de acceso de Salesforce y ten en cuenta lo siguiente:
2. 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 del dominio tiene el siguiente formato: MY-DOMAIN-NAME.develop.my.salesforce.com.
3. 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 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:
3. AUTH_OPTION: Configura esto como SalesforceLWC.
4. 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://.
5. SALESFORCE_ORGANIZATION_ID: Anotaste este valor en el requisito previo de Salesforce.

Paso 1: Configura tu proyecto

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 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.

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 Automatically log agents into Omni-Channel in the new window or tab.
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 login details 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.
2. External Client App Name: lwc auth
3. Nombre de la API: lwc_auth
4. Correo electrónico de contacto: your_email@example.com
5. API (Enable OAuth Settings) > Enable OAuth: Seleccionado
6. API (Enable OAuth Settings) > URL de devolución de llamada: https://login.salesforce.com/services/oauth2/callback
7. API (Enable OAuth Settings) > Selected OAuth Scopes: Accede al servicio de URL de identidad.
8. API (Enable OAuth Settings) > Enable Client Credentials Flow: Seleccionado
9. 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 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.

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 el nombre de la API: ui_connector.
1. 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://<var>UI_CONNECTOR_SUBDOMAIN</var>.<var>GCP_REGION</var>.run.app.
2. Selecciona todas las casillas de verificación en Directivas de CSP.
3. Haz clic en Guardar y crear otro.
Ingresa el nombre de la API: salesforce_domain.
1. Ingresa la URL de tu dominio de Salesforce con el siguiente formato: https://<var>YOUR_SUBDOMAIN</var>.my.salesforce.com.
2. Selecciona todas las casillas de verificación en Directivas de CSP.
3. 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.

Configura 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. En el cuadro Búsqueda rápida, ingresa URLs de confianza 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://<var>UI_CONNECTOR_SUBDOMAIN</var>.us-central1.run.app.
3. Selecciona todas las casillas de verificación 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 casillas de verificación 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://<var>YOUR_SUBDOMAIN</var>.my.salesforce.com.
11. Selecciona todas las casillas de verificación en Directivas de CSP.
12. Haz clic en Guardar.
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:
2. Etiqueta: Messaging Queue
3. Nombre de la fila: Messaging_Queue
4. Configuración de enrutamiento: Messaging_Routing_Configuration
5. Haz clic en Supported Objects y, luego, agrega Messaging User y Messaging Session.
6. Haz clic en Miembros de la fila y, luego, agrega Usuario: Tu usuario de acceso.
7. 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 asignaciones y, luego, selecciona Usuario de chat mejorado.
4. Haz clic en Guardar.
5. Busca Permission Set Assignments en la página.
6. Haz clic en Edit Assignments y, luego, selecciona Messaging Agent Permission Set.
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: Canal de mensajería.
3. Haz clic en Guardar.
4. Establece Tipo de enrutamiento 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.
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 Embedded Service y, luego, haz clic en Nueva implementación.
1. Haz clic en Enhanced Chat > Next > Web > Next.
2. Completa los siguientes detalles:
3. Nombre: Implementación del servicio integrado de mensajería
4. Nombre del desarrollador: Messaging_Embedded_Service_Deployment
5. Dominio: example.com
6. Canal: Canal de mensajería
7. Haz clic en Guardar. Espera a que se complete la implementación.
8. En la configuración de Embedded Service Deployment, haz clic en Publicar.
9. Haz clic en Actualizar y, luego, en Probar mensajería.

Prueba 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 servicios.
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 servicios 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 del conector de la IU de tu backend de integración de agentes, como una URL de la consola de Cloud Run, como https://<var>UI_CONNECTOR_ENDPOINT</var>.<var>GCP_REGION</var>.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: Es el nombre del recurso de tu perfil de conversación de Agent Assist (por ejemplo, projects/<var>GCP_PROJECT_ID</var>/locations/<var>GCP_REGION</var>/conversationProfiles/<var>CONVERSATION_PROFILE_ID</var>).
- consumerKey: 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.