Complemento CX Companion de Salesforce

El complemento SF de UiPath CX Companion permite la integración lista para usar de CX Companion con Salesforce cuando se utilizan eventos externos. Lee las siguientes secciones para aprender a instalar y configurar el complemento.

Requisitos previos

Antes de comenzar, asegúrate de que:

• Tiene acceso al perfil de administrador del sistema .
  Nota: puedes utilizar tu organización o prueba actual de Salesforce en una organización de desarrollo.

• Tu edición de Salesforce es Enterprise, Ilimitada o Developer.

Instalar el paquete gestionado

1. Accede al listado de AppExchange.

   Sigue estos pasos para instalar el paquete gestionado UiPath-CX-Companion-SF-Plugin :

   1. Abre un navegador web y ve a Salesforce AgentExchange.
   2. En la barra de búsqueda, escribe: UiPath CX Companion SF Plugin.
   3. Haz clic en la lista de aplicaciones y selecciona Obtener ahora.
   4. Inicia sesión con tus credenciales de Salesforce.
   Importante:

   El complemento CX Companion SF está actualmente en vista previa, pendiente de aprobación de Salesforce. Puedes obtener la versión de vista previa de una de las siguientes maneras:

   • Descarga utilizando la URL del paquete gestionado: https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPa000002FWpeIAG
   • Descargar desde https://<yourSalesforceDomain>.lightning.force.com/packaging/installPackage.apexp?p0 p0=04tPa000002FWpeIAG
     donde <yourSalesforceDomain> es el dominio real de tu organización de Salesforce.
2. Elija dónde instalar y para quién.
   1. Selecciona en qué entorno quieres instalar:
      • Producción : elige esta opción si estás listo para utilizar la aplicación en tu entorno de Salesforce.
      • Sandbox : elige esta opción si quieres probar la aplicación antes de usarla en producción.

      Nota:

      Este paso no está disponible si utilizas la versión de vista previa del complemento.

   2. Selecciona Instalar para usuarios específicos.
      Puedes elegir que este paquete gestionado esté disponible para algunos o todos los usuarios.
   3. Selecciona "Reconozco que estoy instalando una aplicación que no es de Salesforce que no está autorizada para su distribución como parte del programa de socios AppExchange de Salesforce".
   4. Haz clic en Instalar.
   5. Aprobar el acceso de terceros para https://*.uipath.com, que permitirá el acceso de confianza a la aplicación CX Companion alojada en uipath.com.
   6. Una vez finalizada la instalación, haz clic en Listo.

      Después de la instalación, el paquete gestionado recién instalado Complemento SF de UiPath CX Companion se muestra en la lista Paquetes instalados.

      

Asignar permisos y caché de plataforma

1. Asignar conjuntos de permisos
   Sigue estos pasos para asegurarte de que los permisos necesarios están disponibles para los usuarios para los que has instalado el paquete gestionado.
   1. Ve a Configuración > Usuarios > Conjunto de permisos y localiza UiPath CX Companion.
   2. Selecciona Gestionar asignaciones > Añadir asignaciones.
   3. Selecciona los usuarios necesarios.
   4. Haz clic en Siguiente y, a continuación, en Asignar.
2. Asignar caché de plataforma
   Necesitamos configurar la caché de plataforma como memoria reutilizable para que esta aplicación almacene los datos del ID de registro de Salesforce activo. Asegúrate de que la caché de plataforma se asigna de la siguiente manera:
   1. Ve a Configuración > Caché de plataforma.
   2. Localiza CxCompanionCache y haz clic en Editar.
   3. Especifique la siguiente capacidad (MB)
      • Asignación de caché de sesión : organización o prueba (lo que esté disponible): 2
      • Asignación de caché de la organización : organización o prueba (la que esté disponible): 1

      Nota: para Salesforce Developer Edition (DE), si la capacidad de prueba no está disponible, puedes solicitarla haciendo clic en Solicitar capacidad de prueba.
   4. Haz clic en Guardar,
      

Conectar la aplicación CX Companion al complemento

1. Identifica la URL donde se aloja CX Companion. Para obtener información sobre cómo obtener la URL de la aplicación, consulta Configurar la aplicación CX Companion > Insertar la aplicación.
2. Configura una URL de confianza.

   Para permitir que el iframe de CX Companion se renderice dentro del componente web Lightning (LWC), la instancia de Salesforce debe estar configurada para confiar en el sitio donde se aloja CX Companion.

   1. Dirígete a Configuración > URL de confianza.
   2. Busca CXCompanion_Iframe en la lista y haz clic en Editar.
   3. Selecciona Contexto CSP como Todos.
   4. Selecciona las opciones connect-src y marco-src y haz clic en Guardar
3. Modifica los tipos de metadatos personalizados.

   El LWC requiere que se configuren metadatos personalizados para que CX Companion entregue contenido en la aplicación iframe de CX Companion.

   1. Ve a Configuración > Tipos de metadatos personalizados.
   2. Para la etiqueta Configuración de CX Companion, selecciona Gestionar registros. Esta etiqueta se crea automáticamente al instalar el paquete gestionado.
      
   3. Para la etiqueta Predeterminada , haz clic en Editar.
   4. Pega la URL de la aplicación de CX Companion en el campo URL de la aplicación .
   5. Mencione el origen de destino como el nombre de host de la URL de su CX Companion, por ejemplo https://cloud.uipath.com.
   6. Si CX Companion se inicia desde un botón de acción en una página de registro de SF, los siguientes campos definen las dimensiones de la ventana invocada. Estos pueden cambiarse según sea necesario. Los valores predeterminados son:
      • Ancho del componente Grabar acción: 1200
      • Grabar altura del componente de acción: 800

      Nota: Estas dimensiones y el título solo se aplicarán cuando CX Companion se configure como un botón de acción en la página de registro del objeto.
   7. Haz clic en Guardar,
      

Posicionar CX Companion

Hay dos opciones para colocar el botón de inicio de CX Companion en la IU de Salesforce:

• Como elemento de la barra de utilidades visible en todos los objetos.
• Como botón de acción en la página de registro de objetos.

Posición como elemento de la barra de utilidades

Sigue estos pasos para cada aplicación en la que quieras habilitar CX Companion (p. ej. consola de ventas). Esto garantizará que CX Companion sea visible en la bandeja de utilidades cuando el usuario esté en esa aplicación.

En las siguientes instrucciones, CX Companion se añade como elemento de la barra de utilidades en la consola de servicio.

1. Ve a Configuración > Gestor de aplicaciones.
2. Selecciona Editar para Consola de servicio.
3. En Elementos de utilidad (solo escritorio) en el panel izquierdo, haz clic en Añadir elemento de utilidad.
   • Busca el componente web Lightning cxCompanion en la ventana emergente y selecciónalo.
   • Introduzca la etiqueta que aparecerá en la barra de utilidades (p. ej. CX Companion) y selecciona un icono apropiado.
   • Especifica la Anchura del panel (recomendado 1000 px) y la Altura del panel (recomendado 520 px).
   • Selecciona Habilitar botón Actualizar que aparece dentro del LWC y permite que CX Companion se actualice con datos del objeto SF activo.

   • Haz clic en Guardar.

     
4. Para Alineación de la barra de utilidades, selecciona la alineación deseada y luego haz clic en Guardar.
   • Si seleccionas Predeterminado, la barra de utilidades aparece en la parte inferior izquierda de la pantalla.
   • Si seleccionas Duplicado, la barra de utilidades aparece en la parte inferior derecha de la pantalla.

Posición como botón de acción en la página de registro del objeto

Sigue estos pasos para cada objeto en el que quieras crear el nuevo botón de acción para la página Registro de objetos. Las siguientes instrucciones te guiarán para añadir CX Companion como botón de acción en la página Registro de caso.

1. Ve a Configuración > Gestor de objetos para crear una nueva acción para un objeto.
2. Busque un objeto para el que desee añadir una acción rápida (p. ej. case) y ábralo.
3. Selecciona Botones, Enlaces y Acciones en el panel izquierdo y, a continuación, haz clic en Nueva acción.
4. Para Tipo de acción, selecciona Componente web Lightning.
5. Para el componente web Lightning, selecciona uipathsf:cxCompanionRecordAction.
6. En el cuadro Etiqueta , introduce la etiqueta que aparecerá en el botón (p. ej. CX Companion) y selecciona un icono apropiado. El campo Nombre se rellenará automáticamente.

7. Haz clic en Guardar.

   
8. Ve a Configuración > Gestor de objetos para añadir esta acción a una página de registro lightning.
9. Busque un objeto para el que desee añadir una acción rápida (p. ej. case) y ábralo.
10. Haz clic en Páginas de registro de Lightning en el panel izquierdo.
11. Ve a cualquier página de registro de Salesforce y haz clic en Editar.
12. Selecciona el panel destacado en la página de registro y, en el panel derecho, haz clic en Añadir acción para añadir una acción dinámica.
13. Busca CX Companion y haz clic en Listo.

14. Haz clic en Guardar.

    
15. Se añade un botón en la página de registro del caso que inicia CX Companion en una nueva ventana emergente.
    Nota: Las dimensiones y el título de la ventana de CX Companion estarán determinados por lo que se especificó en el paso anterior Modificar tipos de metadatos personalizados.

Pasar campos de objetos de SF a CX Companion

Sigue estos pasos para configurar los campos de objeto desde la aplicación CX Companion Setup.

1. Haz clic en Iniciador de aplicación, busca y selecciona la aplicación Configuración de CX Companion.
2. Selecciona la pestaña Configuración de objetos de CX Companion .
3. En el menú desplegable Objeto , selecciona cualquier objeto que hayas habilitado previamente con CX Companion (p. ej. Objeto de cuenta).
   Si el objeto que quieres añadir no está disponible en el menú desplegable Objeto:
   1. Selecciona la opción Otro.
   2. Especifica el ID de registro de Salesforce (15 o 18 dígitos) del objeto en el cuadro de texto y luego haz clic en Recuperar metadatos. Por ejemplo, para añadir el objeto Contacto , introduce el ID de registro SF de cualquier contacto válido, p. ej. 003Ox00000eUIKSIA4 en el cuadro de texto.
   3. Ahora se muestran los campos para el objeto. Continúa con el paso 4.
4. En la sección Campos , selecciona los campos que deben enviarse a CX Companion. Asegúrese de que los usuarios finales tengan permisos de acceso a los campos seleccionados.
   
5. Selecciona hasta dos campos de la sección Encabezado que se mostrarán como encabezado de CX Companion.
6. Haz clic en Guardar para guardar la configuración. Los valores pueden tardar un tiempo en guardarse y en reflejarse los cambios en CX Companion.