Esta página se ha traducido con Cloud Translation API.

Integración de chat de Salesforce

Usa el componente web Lightning de Salesforce (LWC) para integrar módulos de la interfaz de usuario de Asistente para agentes en conversaciones de chat.

Antes de empezar

Para integrar los módulos de la interfaz de usuario de Asistente con agente en Salesforce, necesitas acceder 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 siguiendo las instrucciones y autentícate con gcloud auth login.
Salesforce
1. Inicia sesión en la URL de tu instancia o en la página de inicio de sesión de Salesforce y anota lo siguiente:
2. La URL Mi dominio de Salesforce. Sigue estos pasos para encontrar la URL de Mi dominio:
  1. Ve a la barra de menú > menú Configuración.
  2. Haz clic en Configurar.
  3. En el cuadro Búsqueda rápida, introduce Mi dominio. El nombre de dominio tiene el siguiente formato: MY-DOMAIN-NAME.develop.my.salesforce.com.
3. Tu ID de organización de Salesforce. Sigue estos pasos para encontrar el ID de la organización:
  1. Ve a la barra de menú > menú Configuración.
  2. Haz clic en Configurar.
  3. En el cuadro Búsqueda rápida, introduce Información de la empresa. Nota: Estos pasos de integración solo se han probado con Salesforce Developer Edition. Si usas otra edición, puede que haya diferencias en las licencias de las funciones y en la interfaz de Salesforce.
Backend de la 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: asigna el valor SalesforceLWC.
4. SALESFORCE_DOMAIN: un nombre de dominio similar a YOUR_SUBDOMAIN.develop.lightning.force.com. Has anotado este valor en el requisito previo de Salesforce. Ten en cuenta que no debes incluir https://.
5. SALESFORCE_ORGANIZATION_ID: Has anotado este valor en el requisito previo de Salesforce.

Paso 1: Configura tu proyecto

Para empezar a integrar los módulos de la interfaz de usuario de Asistente, 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
```
Descarga los archivos JS, que se implementarán más adelante como recursos estáticos, ejecutando los siguientes comandos:
```
npm run generate-static-resources
npm install
```

Paso 2: Configura tu entorno

Puedes integrar módulos de la interfaz de usuario de Asistente en un entorno específico, como el de producción o el de desarrollo. Salesforce llama organizaciones a estos entornos.

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

Ve a la barra de menú > menú Configuración y, a continuación, haz clic en Configuración. En el cuadro Búsqueda rápida, introduce Configuración omnicanal y, a continuación, haz clic en Configuración omnicanal.
1. Selecciona Habilitar omnicanal.
2. Seleccione Registrar automáticamente a los agentes en Omnicanal en la nueva ventana o pestaña.
3. Haz clic en Guardar.
Ve a la barra de menú > menú Configuración y, a continuación, haz clic en Configuración. En el cuadro Búsqueda rápida, introduce Comunidades y, a continuación, haz clic en Experiencias digitales > Configuración.
1. Selecciona Habilitar espacios de trabajo de experiencias.
2. Haz clic en Guardar.

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

Ejecuta el siguiente código y autentica la CLI con las credenciales de inicio de sesión 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 aplicación cliente externa

El LWC de Salesforce usa el flujo de credenciales de cliente de OAuth 2.0 para autenticarte. Una aplicación cliente externa habilita el flujo de credenciales de cliente. Usa la clave de consumidor y el secreto de consumidor de la aplicación para configurar el componente web ligero (LWC) de Salesforce y autenticar a los usuarios con Salesforce.

Ve a la barra de menú > menú Configuración y, a continuación, haz clic en Configuración. En el cuadro Búsqueda rápida, introduce Gestor de aplicaciones cliente externas.
1. Haga clic en Gestor de aplicaciones de cliente externas > Nueva aplicación de cliente externa > Crear y, a continuación, introduzca la siguiente información.
2. Nombre de la aplicación de cliente externa: lwc auth
3. Nombre de la API: lwc_auth
4. Correo de contacto: your_email@example.com
5. API (Habilitar ajustes de OAuth) > Habilitar OAuth: seleccionado
6. API (Enable OAuth Settings) > Callback URL (API [Habilitar ajustes de OAuth] > URL de retrollamada): https://login.salesforce.com/services/oauth2/callback
7. API (Habilitar ajustes de OAuth) > Permisos de OAuth seleccionados: acceder al servicio de URL de identidad
8. API (Enable OAuth Settings) > Enable Client Credentials Flow: seleccionado
9. Haz clic en Crear.
Ve a la barra de menú > menú Configuración y, a continuación, haz clic en Configuración. En el cuadro Búsqueda rápida, introduce Gestor de aplicaciones cliente externas.
1. Haz clic en el nombre de tu aplicación cliente externa > Editar.
2. Ve a OAuth Policies > OAuth Flows and External Client App Enhancements (Políticas de OAuth > Mejoras de flujos de OAuth y aplicaciones cliente externas).
3. Asegúrate de que la opción Habilitar flujo de credenciales de cliente esté seleccionada.
4. En Ejecutar como, introduce tu nombre de usuario de inicio de sesión.
5. Haz clic en Guardar.
Ve a la barra de menú > menú Configuración y, a continuación, haz clic en Configuración. En el cuadro Búsqueda rápida, introduce Gestor de aplicaciones cliente externas.
1. Haz clic en el nombre de tu aplicación cliente externa > Editar.
2. Ve a Configuración de OAuth > Configuración de la aplicación > Clave y secreto del consumidor.
3. Introduce el código de verificación que se ha enviado a tu correo.
4. Copia la clave y el secreto del consumidor en un lugar seguro. Los necesitarás en un paso posterior.

Establecer políticas de seguridad de contenido y CORS

Ve a la barra de menú > menú Configuración y, a continuación, haz clic en Configuración.
En el cuadro Búsqueda rápida, introduce CORS y, a continuación, haz clic en Editar.
1. Selecciona Habilitar CORS para los endpoints de OAuth.
2. Haz clic en Guardar.
Ve a la barra de menú > menú Configuración y, a continuación, haz clic en Configuración.
En el cuadro Búsqueda rápida, introduce URLs de confianza y, a continuación, haz clic en Nueva URL de confianza.
Introduce el nombre de la API: ui_connector
1. Introduce la URL del endpoint del servicio Cloud Run del conector de interfaz de usuario que has implementado con el backend de integración de Asistente. 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 Directivas de CSP.
3. Haz clic en Guardar y crear.
Introduce el nombre de la API: salesforce_domain
1. Introduce 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 Directivas de CSP.
3. Haz clic en Guardar.

Paso 4: Configura el cliente de chat

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

Configurar Chat mejorado

Sigue estos pasos para configurar tu mensajero.

Ve a la barra de menú > menú Configuración y, a continuación, haz clic en Configuración. En el cuadro Búsqueda rápida, introduce URLs de confianza y, a continuación, haz clic en Nueva URL de confianza.
1. Introduce el nombre de la API: ui_connector.
2. Introduce la URL del endpoint del servicio Cloud Run del conector de interfaz de usuario que has implementado con el backend de integración de Asistente. 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 Directivas de CSP.
4. Haz clic en Guardar y crear.
5. Introduce el nombre de la API: twilio_flex.
6. Escribe la URL https://flex.twilio.com.
7. Selecciona todas las casillas de Directivas de CSP.
8. Haz clic en Guardar y crear.
9. Introduce el nombre de la API: salesforce_domain.
10. Introduce 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 Directivas de CSP.
12. Haz clic en Guardar.
Ve a la barra de menú > menú Configuración y, a continuación, haz clic en Configuración. En Búsqueda rápida, busca Colas y, a continuación, haz clic en Nueva.
1. Introduce la siguiente información:
2. Etiqueta: Cola de mensajes
3. Nombre de la cola: Messaging_Queue
4. Configuración de enrutamiento: Messaging_Routing_Configuration
5. Haga clic en Objetos admitidos y, a continuación, añada Usuario de mensajería y Sesión de mensajería.
6. Haz clic en Miembros de la cola y, a continuación, añade Usuario: tu usuario de inicio de sesión.
7. Haz clic en Guardar.
Ve a la barra de menú > menú Configuración y, a continuación, haz clic en Configuración. En el cuadro Búsqueda rápida, introduce Conjuntos de permisos.
1. Haz clic en Messaging Agents Permission Set (Conjunto de permisos de agentes de mensajería).
2. Haz clic en Acceso a los estados de presencia del servicio > Editar.
3. Selecciona los estados No disponible y En línea - Mensajes.
4. Haz clic en Añadir > Guardar.
Ve a la barra de menú > menú Configuración y, a continuación, haz clic en Configuración. En el cuadro Búsqueda rápida, introduce Usuarios y, a continuación, haz clic en Usuarios.
1. Haz clic en tu nombre de usuario y comprueba que la opción Usuario de Service Cloud esté habilitada.
2. Busca Asignaciones de licencias de conjuntos de permisos en la página.
3. Haz clic en Editar asignaciones y, a continuación, selecciona Usuario de chat mejorado.
4. Haz clic en Guardar.
5. Busca Asignaciones de conjuntos de permisos en la página.
6. Haz clic en Editar asignaciones y, a continuación, selecciona Conjunto de permisos de agente de mensajería.
7. Haz clic en Añadir > Guardar.
Ve a la barra de menú > menú Configuración y, a continuación, haz clic en Configuración. En el cuadro Búsqueda rápida, introduce Configuración de mensajería y, a continuación, haz clic en Nuevo canal.
1. Selecciona Chat mejorado.
2. Escribe el nombre: Messaging Channel.
3. Haz clic en Guardar.
4. En Tipo de enrutamiento, seleccione Cola omnicanal y, en Cola, seleccione Cola de mensajes.
5. Haz clic en Guardar y ve a Configuración de mensajería.
6. Haz clic en el nombre del canal de mensajería y, a continuación, en Activar.
7. Después de leerlos, acepta los Términos y Condiciones.
Ve a la barra de menú > menú Configuración y, a continuación, haz clic en Configuración. En el cuadro Búsqueda rápida, introduce Implementaciones de servicio insertado y, a continuación, haz clic en Nueva implementación.
1. Haz clic en Enhanced Chat (Chat mejorado) > Next (Siguiente) > Web > Next (Siguiente).
2. Rellena los siguientes datos:
3. Nombre: Despliegue de servicio insertado 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 (Implementación de servicio insertado), haz clic en Publish (Publicar).
9. Haz clic en Actualizar y, a continuación, en Mensajes de prueba.

Probar la función de chat mejorada

Sigue estos pasos para probar tu mensajero.

Haz clic en Test Messaging (Probar mensajería).
Cuando se cargue la nueva pestaña, haz clic en la burbuja de diálogo para iniciar una conversación de prueba.
Envía un mensaje, como Prueba.
Ve a la pestaña del navegador de Salesforce.
En la barra de herramientas Configuración, haz clic en el menú Lanzador de aplicaciones y, a continuación, selecciona Consola de servicios.
En la barra de herramientas de utilidades, haz clic en Omnicanal.
Cambia tu estado a En línea - Mensajería.
Acepta el mensaje entrante. Se abrirá una nueva pestaña en la consola de servicio de la conversación. No puedes ver la transcripción del chat.
Ve a la barra de menú > menú Configuración.
Haz clic en Editar página.
En el menú Componentes, arrastra el componente Conversación mejorada al panel Conversación.
Haz clic en Guardar > Activar > Asignar como predeterminado de la organización > Escritorio > Atrás .
Actualiza la página.
En la barra de herramientas de utilidades, haz clic en Omnicanal.
Cambia tu estado a En línea - Mensajería.
Responde al mensaje Prueba para comprobar que la mensajería funciona.

Si te quedas atascado y necesitas más información, consulta la guía de configuración de Asistencia Mejorada de Salesforce.

Paso 5: Instala el componente web Lightning de Salesforce

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

Vaya a la barra de menú > menú Configuración y, a continuación, haga clic en Editar página.
En la barra lateral Componentes, mueva el agentAssistContainerModule a la barra lateral.

Nota: El comando npm deploy ha proporcionado este componente.
Haga clic en el componente que ha colocado en el paso anterior.
Rellena los campos del formulario como se indica a continuación para añadir los detalles de configuración.
- Endpoint: la URL del conector de la interfaz de usuario de backend de integración del agente, como una URL de la consola de Cloud Run, por ejemplo: 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 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 aplicación cliente externa del paso 3
- consumerSecret el secreto de consumidor de la aplicación cliente externa del paso 3