Complemento CX Companion de Salesforce

Instala y configura el complemento de Salesforce de UiPath CX Companion para integrar CX Companion con Salesforce utilizando eventos externos.

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

Before you begin, make sure that:

• Tiene acceso al perfil de administrador del sistema .

  Nota:

  Puede utilizar su organización de Salesforce actual o probar 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. Select the app listing, and then select Get It Now.

4. Inicia sesión con tus credenciales de Salesforce.

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

   You can choose to make this managed package available to some or all users. 3. Select “I acknowledge that I’m installing a Non-Salesforce Application that is not authorized for distribution as part of Salesforce’s AppExchange Partner Program.”. 4. Select Install. 5. Approve Third-Party Access for https://*.uipath.com, which will enable trusted access to the CX Companion App hosted on uipath.com. 6. After the installation finishes, select Done.

   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. Select Next, and then select Assign.

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. Locate CxCompanionCache and select Edit.
   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. Selecciona 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. Find CXCompanion_Iframe in the list, and select Edit.
   3. Selecciona Contexto CSP como Todos.
   4. Select the options connect-src and frame-src and select Save

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. For the Default label, select Edit. 4. Paste your CX Companion’s app URL in the App URL field. 5. Mention the Target Origin as the hostname of your CX Companion’s URL, e.g. https://cloud.uipath.com. 6. If CX Companion is launched from an action button in a SF record page, the following fields define the dimensions of the invoked window. These can be changed as needed. The default values are:

   • 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. Select Save,

   

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. Under Utility Items (Desktop Only) on the left panel, select Add Utility Item.

   • 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.
   • Selecciona Guardar.

   

4. For Utility Bar Alignment, select the desired alignment, and then select Save.

   • 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. Select Buttons, Links, and Actions on the left panel, and then, select New Action.

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. Selecciona 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. Select Lightning Record Pages on left hand panel.

11. Go to any Salesforce record page, and select Edit.

12. Select the highlight panel on the record page and, on the right panel, select Add Action to add a dynamic action.

13. Search for CX Companion and select Done.

14. Selecciona 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. Select App Launcher, search for and select the app CX Companion Setup.

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. Specify the Salesforce record ID (15 or 18 digits) of the object in the text box, and then select Retrieve Metadata. For example, to add the Contact object, enter any valid contact’s SF record ID, e.g. 003Ox00000eUIKSIA4 in the text box.
   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. Select Save to save the configuration. It may take some time for the values to be saved and for the changes to be reflected in CX Companion.