Ir al contenido principal

Sincroniza o importa artículos internos desde fuentes externas

Cómo sincronizar o importar tu contenido de soporte desde Confluence, Guru o Notion.

Puedes sincronizar o importar tu contenido interno desde Confluence, Guru o Notion a tu espacio de trabajo Fin, donde puede habilitarse para Fin y/o Copilot. Las fuentes Confluence y Notion ahora soportan metadatos más ricos, reglas de prefiltrado y un nuevo flujo de revisión de metadatos para que puedas controlar exactamente qué páginas entran en Fin y dónde se usan.

Cuando el contenido se sincroniza:

  • No puede ser editado en Fin. Los cambios en el contenido deben hacerse en la herramienta fuente (Confluence, Notion o Guru).

  • Se volverá a sincronizar automáticamente cada 24 horas y cualquier cambio nuevo en el contenido se reflejará en Fin. También puede sincronizarse manualmente.

  • La sincronización diaria se omite cuando no ha habido actualizaciones de contenido en la fuente desde la última sincronización, ya que ejecutarla no produciría nada nuevo.

  • El contenido se añadirá a nuevas carpetas sincronizadas en Fin. Una carpeta sincronizada no puede modificarse y todas las carpetas se mostrarán en orden alfabético.

Cuando el contenido se importa:

  • Se transforma en artículos internos nativos que pueden ser editados/eliminados desde tu espacio de trabajo Fin.

  • El contenido se añadirá a una nueva carpeta nativa en Fin. Las carpetas nativas pueden modificarse.


Sincroniza o importa artículos internos

Para sincronizar nuevas fuentes internas, navega a Train > Content y haz clic en Ver todo debajo de la sección "Agregar contenido".

Luego selecciona una fuente interna de conocimiento, como:

  • Notion

  • Confluence

  • Guru

Se te pedirán credenciales para acceder a la cuenta asociada de Confluence/Guru/Notion.

Confluence

  1. Abre tu fuente Confluence en Train > Content.

  2. Haz clic en Editar fuente (en el menú de tres puntos junto a la fuente).

  3. Sigue los pasos Conectar → Metadatos → Destino → Revisión.

  4. Configura filtros de metadatos, segmentación de audiencia y disponibilidad del Agente AI Fin/Copilot.

  5. Haz clic en Actualizar y sincronizar.

Nota: Esto funciona para fuentes v1 y v2 (fuentes con carpetas habilitadas). Tus credenciales OAuth existentes se mantienen; puede que se te pida reautenticar si tu conexión ha expirado. Los espacios con permisos restringidos pueden fallar en la sincronización correcta. Asegúrate siempre de que la cuenta de usuario usada para conectar Confluence tenga permisos adecuados de visualización y acceso para los espacios que deseas sincronizar.

El paso de Metadatos te permite prefiltrar qué páginas entran en Fin. Para Confluence, los metadatos sincronizados como campos estructurados incluyen etiquetas, título, página principal, autor y fechas de creación/edición. Puedes crear reglas de prefiltrado usando condiciones de cadena (es, no es, contiene, empieza con, termina con) y condiciones de etiqueta (es, no es).

Nota:

  • Esta integración actualmente soporta solo Confluence Cloud. Asegúrate de no intentar integrar con una versión on-premises de Confluence.

  • Solo importamos espacios Confluence del tipo 'global'.

  • Asegúrate de iniciar sesión con una cuenta de usuario que tenga los permisos correctos para el contenido que deseas sincronizar o importar a Fin.

Ahora se pueden crear carpetas dentro de Confluence, sin embargo, estas no son compatibles con esta sincronización. Solo verás estas páginas y subpáginas aparecer en el menú desplegable 'seleccionar carpetas'. 👇

Nota:

  • La exclusión de carpetas ahora se maneja mediante filtros: usa el filtro "Página antecesora" para excluir subárboles completos de páginas. Si habías configurado carpetas denegadas antes, se migran automáticamente a reglas de filtro en tu próxima sincronización — no se requiere acción.

  • No soportamos sincronizaciones de páginas individuales. Solo se soporta la sincronización completa.

  • Soportamos la sincronización de carpetas, pero no de pizarras blancas desde Confluence.

Solución de problemas de sincronización de espacios Confluence

Al integrar espacios Confluence con Fin, podrías encontrar situaciones donde ciertos espacios no son visibles o no se sincronizan correctamente. Esta guía te ayuda a diagnosticar y resolver estos problemas comunes.

Verifica el tipo del espacio Confluence que falta

  • En Confluence, navega a Configuración del espacio > Administrar espacio > Detalles del espacio.

  • Revisa el ‘Tipo’ del espacio.

  • Fin solo soporta la sincronización de espacios del tipo 'global'. Los espacios marcados como 'personal' o 'knowledge_base' no se incluyen en la sincronización.

Crea un nuevo espacio personalizado (si el tipo no es compatible)

  • Si el espacio Confluence que falta es de un tipo no compatible (por ejemplo, 'personal' o 'knowledge_base'), puedes crear un nuevo espacio 'Personalizado' para resolver el problema.

  • En Confluence, crea un nuevo espacio Personalizado.

  • Transfiere el contenido de tu espacio no compatible a este nuevo espacio Personalizado creado.

Verifica la configuración de visibilidad

  • En Confluence, asegúrate de que el espacio que quieres sincronizar esté configurado con un estado 'actual'.

  • Solo los espacios con este estado serán considerados para sincronizar con Fin.

Solución de problemas de jerarquías de carpetas y páginas

  • Fin no soporta directamente carpetas dentro de Confluence para propósitos de sincronización. En cambio, sincroniza basado en páginas y subpáginas individuales.

  • Para asegurar que tu contenido se sincronice correctamente, organízalo usando páginas y subpáginas. Si necesitas excluir contenido específico, mueve esas páginas a un espacio de Confluence separado que no esté destinado a sincronizarse con Fin.

Si los pasos anteriores no resuelven el problema, puede que haya una configuración específica en el backend que deba activarse para tu espacio de trabajo. Para solucionarlo, contacta a nuestro equipo de Soporte. Cuando lo hagas, informa que ya has seguido los pasos de solución de problemas. Luego, pídeles que investiguen la activación de cualquier configuración backend que pueda ayudar a mostrar todos tus espacios de Confluence no personales, evitando esas restricciones predeterminadas. Ellos te ayudarán a que todo funcione sin problemas.

Nota: Los espacios con permisos restringidos pueden no sincronizarse correctamente. Siempre asegúrate de que la cuenta de usuario usada para conectar Confluence con Intercom tenga los permisos adecuados de visualización y acceso para los espacios que deseas sincronizar.

Guru

  1. Abre tu fuente Guru en Train > Content.

  2. Introduce tu correo electrónico de Guru y el token API.

  3. Selecciona Colección, Carpetas y si deseas importar o sincronizar contenido.

  4. El estado se mostrará en Fin Content cuando comience la sincronización/importación.

  5. Una vez que la sincronización/importación esté completa, el ícono de estado se actualizará a una marca verde.

Consejo: Asegúrate de tener los permisos correctos asociados con tu cuenta Guru y tener tus credenciales API a mano al sincronizar o importar. Las credenciales API pueden obtenerse siguiendo las instrucciones aquí descritas y se encuentran en tu página de configuración. Asegúrate de seleccionar el User Token.

Notion

  1. Abre tu fuente Notion en Train > Content.

  2. Haz clic en Editar fuente (en el menú de tres puntos junto a la fuente).

  3. Sigue los pasos Conectar → Metadatos → Destino → Revisión.

  4. Configura filtros de metadatos, segmentación de audiencia y disponibilidad de Fin AI Agent/Copilot.

Nota: No se requiere migración para Notion: todo se maneja implícitamente en tu próxima sincronización. Las propiedades dinámicas se incorporan automáticamente como campos estructurados.

Consejo: Asegúrate de iniciar sesión con una cuenta de usuario que tenga los permisos correctos para el contenido que deseas sincronizar o importar a Fin.


Flujo de revisión de metadatos

Las fuentes Confluence y Notion usan un flujo de configuración de cuatro pasos que hace transparente cómo se obtiene el contenido en Fin y te da control sobre qué se importa y dónde se usa.

Conectar

Autentícate en la fuente externa. Tus credenciales OAuth existentes se mantienen para fuentes Confluence; es posible que se te pida reautenticar si la conexión ha expirado.

Metadatos

Elige qué contenido debe estar en el alcance usando reglas de prefiltrado basadas en metadatos de tu knowledge base externa. Los metadatos típicos incluyen:

  • Etiquetas o tags

  • Título

  • Página principal / página ancestro

  • Autor

  • Fechas de creación y edición

  • Propiedades dinámicas (Notion)

Construye reglas usando condiciones de cadena (es, no es, contiene, empieza con, termina con) y condiciones de etiqueta (es, no es) para reducir la porción de contenido que se sincroniza — por ejemplo, solo páginas etiquetadas "fin-ai", o solo contenido actualizado después de cierta fecha.

Consejo: Si omites el paso de Metadatos, el importador trae todo el contenido elegible de la fuente por defecto.

Destino

Decide dónde se usa el contenido importado dentro de Fin. Configura:

  • Fin AI Agent — usa el contenido para responder preguntas de clientes automáticamente (por defecto está DESACTIVADO)

  • Copilot — haz que el contenido esté disponible para los compañeros como respuestas sugeridas

  • Segmentación de audiencia — define reglas de audiencia a nivel de fuente, aplicadas automáticamente al importar

Revisión

Confirma tu configuración antes de que comience la sincronización. La revisión muestra:

  • Detalles de conexión (a qué cuenta externa o subdominio estás conectado)

  • Elementos en alcance después de aplicar filtros de Metadatos

  • Destinos habilitados en Destino

  • Reglas de audiencia y segmentación

Dale a la fuente un nombre claro antes de confirmar — por ejemplo, "Confluence – Internal Support KB" o "Notion – Product Docs (EMEA)". Luego haz clic en Actualizar y sincronizar.

Consejo: Puedes reabrir el mismo flujo más tarde para ajustar Metadatos, Destino o Revisión sin recrear la fuente.


Gestionar artículos internos sincronizados

Una vez que la sincronización o importación esté completa, recibirás una notificación por correo electrónico y los artículos internos aparecerán en Train > Content bajo la sección "Fuentes de contenido".

Configura los ajustes del artículo interno

Ve a Train > Content, selecciona la fuente de contenido y luego abre el artículo interno. Configura sus ajustes en el panel "Detalles" a la derecha:

  • Datos: Visualiza el tipo de contenido, idioma, fecha de creación, creado por, última actualización y el compañero que lo actualizó por última vez.

  • Fin: Para habilitar/deshabilitar para Fin y Copilot. Cuando está habilitado, el contenido se vuelve accesible para los clientes a través de Fin Agent y para los compañeros mediante Fin Copilot, respectivamente.

    • Audiencia: Asegúrese de que los clientes solo reciban respuestas y vean contenido relevante para ellos cuando Fin o Copilot respondan.

  • Enlace: Un enlace al artículo en su knowledge base interna (por ejemplo, Notion/Confluence/Guru).

  • Informes: Rastrea con qué frecuencia este contenido está involucrado y se usa para resolver conversaciones por el agente Fin.

  • Etiquetas: Añada una etiqueta para agrupar artículos internos y mantener el contenido organizado (incluye etiquetas importadas).

Nota:

  • Los artículos internos sincronizados no se pueden editar. Si desea hacer cambios en el contenido, deberá hacerlo desde la fuente misma.

  • Los artículos internos importados pueden ser editados y gestionados dentro de Fin. No se sincronizarán con la fuente, por lo que cualquier cambio debe hacerse dentro de su espacio de trabajo Fin.

Volver a sincronizar o eliminar artículos internos

Los artículos internos de fuentes externas se sincronizarán automáticamente cada 24 horas, pero puede volver a sincronizar o eliminar una fuente manualmente yendo a Train > Content, seleccione el menú de 3 puntos junto a la fuente y luego seleccione Volver a sincronizar o Eliminar esta fuente.

¿Ha quedado contestada tu pregunta?