Configurar la integración con Salesforce conecta tu base de conocimientos de Document360 con tu consola de Salesforce. Una vez configurado, los agentes de soporte pueden buscar artículos, obtener recomendaciones y crear contenido de la base de conocimientos directamente desde Salesforce. Este artículo te guía en cada paso del proceso de configuración, desde la instalación de la app Document360 en Salesforce hasta la autorización de la conexión desde tu portal Document360.
Antes de que empieces
- Necesitas una cuenta de la plataforma Lightning de Salesforce. Si no tienes uno, regístrate para una prueba gratuita en la página de registro de Salesforce. Si ya tienes una cuenta, salta a Instalar la app Document360 en Salesforce.
- Debes ser administrador tanto en tu organización de Salesforce como en tu proyecto de Document360.
- La integración con Salesforce es una compra adicional. Ve a Configuración > Extensiones en tu portal Document360 y haz clic en Comprar ahora en la casilla de Salesforce antes de empezar.
Cómo configurar la integración con Salesforce
La puesta en marcha de la integración implica cinco etapas. Complétalos en orden:
- Crea una cuenta de Salesforce (sáltate si ya tienes una)
- Instala la app Document360 en Salesforce
- Configurar la configuración del Administrador de aplicaciones
- Añadir una página de Visualforce
- Conceder acceso a las apps a los perfiles de usuario
- Autorizar la integración desde Document360
Crea una cuenta de Salesforce
Si ya tienes una cuenta en la plataforma Lightning de Salesforce, sáltate esta sección.
- Ve a la página de registro de Salesforce.
- Introduce los datos requeridos y haz clic en Iniciar mi prueba gratuita.
- Visita la página de precios de Salesforce para elegir y comprar un plan que se adapte a tus necesidades.
- Revisa tu correo electrónico registrado para ver si hay un mensaje que contenga tu enlace de verificación, la URL de la cuenta y el nombre de usuario. Haz clic en Verificar cuenta en el correo.
- Introduce el código de verificación desde el correo de seguimiento y haz clic en Verificar.
El código de verificación llega en un correo electrónico separado del correo inicial del enlace de verificación.
Eres redirigido a la página principal de Salesforce.
Instala la app Document360 en Salesforce
- Ve al listado de Document360 en AppExchange.
- Haz clic en Pruébalo.
- Inicia sesión con tu cuenta de Trailblazer.
- Selecciona el entorno donde quieres instalar la app:
- Instalar en Producción — instala Document360 en el entorno de producción de tu proyecto Salesforce.
- Instalar en Sandbox — instala Document360 en el entorno sandbox de tu proyecto Salesforce.
- Revisa los detalles de la instalación y haz clic en Confirmar e instalar.
- Introduce tus credenciales de Salesforce y haz clic en Iniciar Sesión.
- Selecciona quién debería tener acceso a la app Document360:
- Instalación solo para administradores — restringe el acceso solo a administradores.
- Instalar para todos los usuarios — da acceso a todos los usuarios de tu organización.
- Instalar para perfiles específicos — limita el acceso a perfiles de usuario seleccionados.
Esta selección determina qué usuarios de tu organización Salesforce pueden acceder a la app Document360. Puedes ajustar el acceso más adelante actualizando los perfiles de usuario.
- Haz clic en Instalar.
- Espera a que termine la instalación y luego haz clic en Hecho.
Configurar configuraciones y políticas del Administrador de aplicaciones
Después de instalar la app Document360, configura sus políticas OAuth en Salesforce para controlar quién puede autorizar la integración.
- En tu configuración de Salesforce, navega a Herramientas de Plataforma > Apps > App Manager en el panel de navegación izquierdo. Este paso garantiza una autorización segura y un control de acceso adecuado para los usuarios que interactúan con la integración de Document360.
- En la página de Lightning Experience App Manager, encuentra Document360 en la lista de aplicaciones.
- Haz clic en la flecha hacia abajo al final de la fila de la app de Document360 y selecciona Gestionar.
- En la página de detalles de la aplicación conectada de Document360, haz clic en Editar políticas.
- En el menú desplegable de Usuarios Permitidos , selecciona quién puede autorizar la aplicación a acceder a los datos en su nombre. Hay dos opciones:
- Todos los usuarios pueden autoautorizarse : cualquier usuario de tu organización puede autorizar la aplicación individualmente cuando sea necesario. Esto funciona bien para organizaciones con diferentes roles o departamentos que necesitan usar la integración de forma independiente.
- Los usuarios aprobados por administradores están preautorizados — los usuarios administradores se autorizan automáticamente sin pasar por el proceso de autenticación cada vez. Esto es útil cuando el administrador es el usuario principal de la integración.
Seleccionar que los usuarios aprobados por el administrador estén preautorizados es una acción única. Una vez configurado, el administrador no tendrá que autenticarse manualmente de nuevo.
Añadir una página de Visualforce en la consola de desarrolladores de Salesforce
Necesitas crear una página de Visualforce en tu consola de desarrollador de Salesforce para integrar la app de Document360 en tu entorno Salesforce.
- En el campo de Búsqueda Rápida en la esquina superior izquierda de tu configuración de Salesforce, busca Páginas de Visualforce y selecciónea entre los resultados.
- Haz clic en Nuevo.
- Introduce una etiqueta, nombre y descripción para la página.
- Selecciona la casilla de Disponible para Lightning Experience, Sitios de Experience Builder y la app móvil .
- Pega el siguiente código en la sección de Marcado de Visualforce :
<apex:page standardController="Case"> <apex:canvasApp applicationName="Document360" namespacePrefix="Document360" height="800" width="750px"/> </apex:page>
Puedes editar los valores de altura y anchura en el marcado para adaptarlos a tu diseño. Por ejemplo: height="800px" width="750px". Anota el valor de altura que configuras aquí — lo necesitarás al añadir el componente Visualforce a tu página de Casos.
- Haz clic en Guardar.
Conceder acceso a las apps a los perfiles de usuario
El administrador de la organización debe conceder a la app Document360 acceso a los perfiles de usuario correspondientes. Sin este paso, los usuarios verán un error de Privilegios Insuficientes al acceder a la pestaña de Conocimiento.
- Navega a la página de Configuración en tu entorno Salesforce.
- En el panel de navegación izquierdo, ve a Administración > Usuarios > Perfiles.
- Desde la lista de perfiles, haz clic en el perfil asignado al equipo o a la persona que gestiona la página del caso y la configuración de integración.
- En la página de perfil, haz clic en Editar.
- Desplázate hacia abajo hasta la sección de Acceso a la App Conectada .
- Selecciona la casilla de verificación Document360 .
- Haz clic en Guardar.
Repite esto para cada perfil que necesite acceso a la app Document360 en Salesforce.
Autoriza la integración con Salesforce desde tu portal Document360
El último paso es autorizar la conexión desde tu portal Document360.
- Ve a tu portal de Document360.
- Navega a Configuración en la barra de navegación izquierda.
- Ve a Extensiones en el panel de navegación izquierdo.
- Haz clic en Salesforce en la sección de Helpdesk .
Salesforce es una compra adicional. Si aún no lo has comprado, haz clic en Comprar ahora en la casilla de Salesforce.
- Haz clic en Conectar.
- Selecciona tu tipo de autorización:
- En directo — autoriza tu proyecto de producción en Salesforce.
- Sandbox — autoriza tu proyecto sandbox de Salesforce.
- En el panel de Permitir acceso , haz clic en Permitir y espera unos segundos.
- La casilla de Salesforce ahora muestra el estado como Proyecto conectado a Salesforce junto con la URL de la cuenta de Salesforce asociada a tu proyecto.
- Haz clic en Detalle en la casilla de Salesforce para ver toda la información de configuración.
Para eliminar la integración, haz clic en el icono Borrar en la casilla de Salesforce.
La integración con Salesforce ya está configurada. Tus agentes ahora pueden buscar en tu base de conocimientos, obtener recomendaciones de artículos y crear artículos directamente desde la consola de Salesforce. A continuación, aprende a usar Document360 en Salesforce.
Mejores prácticas
- Completar las cinco fases en orden. Cada etapa depende de la anterior. Saltarse la configuración del App Manager, por ejemplo, puede provocar errores de autorización más adelante.
- Prueba en Sandbox antes de lanzarlo. Utiliza el entorno Sandbox para verificar que la integración funciona como se espera antes de conectar tu proyecto de producción de Salesforce.
- Establece el acceso al perfil antes de autorizar. Concede acceso a la app Document360 a todos los perfiles de usuario relevantes antes de que los agentes intenten usar la integración, para evitar errores de Privilegios Insuficientes.
- Anota la altura de tu página de Visualforce. Cuando añades Document360 a tu página de Casos, la altura debe coincidir o superar el valor establecido en el marcado de la página de Visualforce.
- Usar Los usuarios aprobados por el Administrador están preautorizados para una experiencia más fluida. Si tu administrador es el usuario principal de la integración, esta configuración elimina la necesidad de repetir las solicitudes de autenticación.
- Al actualizar la integración, revisa las notas de versión de Document360 y Salesforce para detectar cualquier cambio en la API o funcionalidad, prueba en un entorno de staging y luego confirma la compatibilidad antes de desplegar en producción.
Preguntas frecuentes
¿Cuál es la arquitectura técnica de la integración de Document360 y Salesforce?
La integración utiliza APIs de ambas plataformas para permitir la transferencia de datos y la sincronización entre Document360 y Salesforce.
¿Cómo se gestiona el versionado de documentos durante la sincronización?
La integración rastrea los cambios en Document360 y actualiza los registros correspondientes en Salesforce para mantener la precisión y consistencia de los datos.
¿Qué pasos se deben implementar para actualizar la integración cuando se lanzan nuevas versiones?
Revisa las notas de la versión para ver si hay cambios en las APIs o funcionalidades, prueba la actualización en un entorno de staging y luego confirma la compatibilidad antes de desplegarla en producción.