Integraciones

Panel de control → Integraciones — conecte fuentes de contenido y canales para acceder al conocimiento.

#Fuentes de contenido

#Conectadas (siempre activas)

#Conectores disponibles

#Conectar GitHub

#Paso 1 — Autorización

1. En LiKE vaya a Integraciones → GitHub → «Conectar»
2. Elija un método de autorización:

#Paso 2 — Elegir el contenido

1. Tras conectar, se muestra un árbol del repositorio con carpetas y archivos
2. Marque los archivos o carpetas concretos que desea importar (Selective Sync)
3. Formatos admitidos: .md, .mdx, páginas Wiki

#Paso 3 — Ejecutar la sincronización

1. Haga clic en «Sync»
2. El progreso se muestra en tiempo real
3. Una vez finalizada, los artículos aparecen en la lista con una etiqueta GitHub

#Conectar GitLab

#Paso 1 — Autorización

1. En LiKE vaya a Integraciones → GitLab → «Conectar»
2. Elija un método de autorización:

#Paso 2 — Elegir el contenido

1. Se muestra un árbol del proyecto con páginas Wiki y archivos Markdown
2. Marque las páginas concretas que desea importar (Selective Sync)

#Paso 3 — Ejecutar la sincronización

Igual que en GitHub — haga clic en «Sync» y espere a que termine.

#Conectar Gitea

Gitea es una plataforma git autoalojada. Se conecta mediante un Personal Access Token y una URL obligatoria de su instancia (por defecto no existe un Gitea en la nube).

#Paso 1 — Crear un token en Gitea

1. En Gitea abra Settings → Applications → Generate New Token
2. Conceda los scopes read:repository y read:user
3. Copie el token

#Paso 2 — Conectar en LiKE

1. En LiKE vaya a Integraciones → Gitea → «Conectar»
2. Indique la Base URL de su instancia (por ejemplo https://gitea.company.com) — este campo es obligatorio, sin él la conexión no se completará
3. Pegue el token
4. Elija un espacio/colección y un modo (Sync — un espejo continuo / Import — una copia única)

OAuth 2.0 también es compatible si el administrador de Gitea ha configurado previamente una aplicación OAuth. La vía principal es el token.

#Paso 3 — Elegir el contenido y sincronizar

1. Se muestra un árbol del repositorio con páginas Wiki y archivos Markdown (.md, .mdx)
2. Marque los nodos que necesita (Selective Sync) y haga clic en «Sync»
3. Para actualizaciones automáticas en cada push, configure un webhook — el secret se genera en la tarjeta del conector. Los artículos de Gitea son de solo lectura (igual que con GitHub/GitLab)

#Selección de archivos y filtros de sincronización (GitHub, GitLab, Gitea)

Para las fuentes git (GitHub, GitLab y Gitea), la lógica de elegir qué sincronizar es más matizada que un simple «repositorio activado/desactivado»:

#Qué se sincroniza

#Filtros de ruta (sincronización selectiva)

Puede acotar exactamente qué tomar del repositorio:

#Detección de cambios (cambios recientes)

LiKE no «descarga todo» en cada ejecución. Se utiliza la detección de cambios:

• GitHub — mediante webhook (recomendado) o polling usando los encabezados If-Modified-Since. El webhook reacciona a un push al instante; el polling — cada 6/12/24/48 horas (depende de la autosincronización).
• GitLab — igualmente: webhook o polling por last_activity_at a través de la Projects API.
• Gitea — webhook (firma X-Gitea-Signature) o polling. El disparador de push se activa solo cuando cambia algún *.md/*.mdx.

Una vez detectado un cambio, se sincronizan solo los archivos afectados; el resto del corpus no se recalcula. Esto ahorra una gran cantidad de cuota de la API de GitHub/GitLab y de tiempo de ejecución.

#Rama y tags

#Historial y conflictos

• Historial de sincronización — la pestaña «Historial» en la tarjeta del conector: fecha, estado (✅ ok / ⚠ advertencias / ❌ error), número de artículos añadidos / actualizados / eliminados, duración de la ejecución. Útil para depurar «por qué no apareció un artículo del repositorio».
• Conflictos de edición — si un artículo de la fuente se editó en LiKE (para GitHub/GitLab esto no está permitido por defecto — los artículos son de solo lectura). Si el modo es Import (una copia única), los artículos pasan a ser editables y se rompe el enlace con la fuente.

#Selective Sync para otros conectores

Notion, Confluence, Wiki.js — tienen su propia lógica de selección (un árbol de páginas), pero el principio es el mismo:

1. Al conectar, se muestra el árbol de contenido de la fuente
2. Casillas de verificación — marque los nodos que necesita
3. El resto no se importa
4. En una resincronización, solo se actualizan los elementos seleccionados

#Conectar Wiki.js

#Paso 1 — Obtener un token de API de Wiki.js

1. Abra su Wiki.js → Administration → API Access
2. Habilite la API (si está deshabilitada)
3. Haga clic en New API Key
4. Nombre la clave (por ejemplo LiKE Integration)
5. Grupo: Administrators (se requiere acceso a todas las páginas)
6. Caducidad: sin caducidad o 1 año
7. Copie el token generado

#Paso 2 — Conectar en LiKE

1. En LiKE vaya a Integraciones → Wiki.js → «Conectar»
2. Introduzca la URL de su Wiki.js (por ejemplo https://wiki.company.com)
3. Pegue el token de API
4. Elija un modo:

5. Haga clic en Save

#Paso 3 — Configurar la sincronización

#Conectar Confluence

Confluence se conecta mediante OAuth 2.0 — autorización segura sin introducir contraseñas.

#Paso 1 — Haga clic en «Conectar Confluence»

1. En LiKE vaya a Panel de control → Integraciones
2. Localice la tarjeta de Confluence → haga clic en «Conectar»
3. Se abre la ventana de autorización de Atlassian

#Paso 2 — Autorizar en Atlassian

1. Inicie sesión en su cuenta de Atlassian (si aún no lo ha hecho)
2. Atlassian muestra una solicitud: «LiKE solicita acceso a su Confluence»
3. Revise los permisos — LiKE solicita solo lectura: el contenido de las páginas y la lista de espacios
4. Haga clic en «Accept»

#Paso 3 — Vuelve a LiKE

Tras la confirmación se le redirige automáticamente de vuelta a Integraciones. La tarjeta de Confluence muestra:

• Estado: Conectado
• El nombre de su sitio de Confluence
• Un botón «Sync»

#Paso 4 — Ejecutar la sincronización

1. Haga clic en «Sync» para la primera importación
2. LiKE carga todas las páginas de los espacios de Confluence accesibles
3. Los artículos aparecen en el catálogo de conocimiento

#Paso 5 — Configurar la autosincronización

Abra la configuración (el icono de engranaje en la tarjeta de Confluence):

Los artículos de Confluence son de solo lectura. Para editar, cambie el original en Confluence, y LiKE se actualizará en la siguiente sincronización.

Al desconectar Confluence, puede conservar una copia de los artículos en LiKE (pasan a ser editables) o eliminarlos.

#Conectar Notion

#Paso 1 — Crear una integración en Notion

1. Abra Notion → haga clic en su avatar (esquina superior izquierda) → Settings
2. En el menú de la izquierda elija My connections (o Integrations)
3. Haga clic en Develop or manage integrations → New integration
4. Introduzca un nombre (por ejemplo LiKE Import), elija un workspace
5. Haga clic en Submit → copie el Internal Integration Secret (empieza por ntn_; para integraciones más antiguas — por secret_)

#Paso 2 — Dar a la integración acceso a las páginas

Por defecto, la integración no tiene acceso a ninguna página. Debe permitirlo explícitamente:

1. En Notion, abra cada página (o la página/base de datos principal) que desee importar
2. Haga clic en ⋯ (tres puntos, esquina superior derecha) → Connect to → elija su integración LiKE Import
3. Confirme el acceso

#Paso 3 — Conectar en LiKE

1. En LiKE → Panel de control → Integraciones → Notion → «Conectar»
2. Pegue el Integration Secret (copiado en el paso 1)
3. Elija un espacio para la importación (existente o cree uno nuevo)
4. Elija un modo:

5. Haga clic en «Conectar»
6. LiKE carga todas las páginas a las que la integración tiene acceso

#Paso 4 — Configurar la autosincronización

Abra la configuración (el icono de engranaje en la tarjeta de Notion):

Al desconectar Notion, puede conservar una copia de los artículos en LiKE (pasan a ser editables) o eliminarlos.

#Conectar un sitio de documentación

El conector toma artículos de un sitio público: lee su mapa del sitio (sitemap) y mantiene una copia en LiKE. Sirve cuando la documentación ya está publicada — en su propio dominio, en Docusaurus, GitBook, Docsify y similares.

#Paso 1 — dirección del sitio

Integraciones → Sitio de documentación → Conectar sitio. Pegue la dirección: puede ser la de cualquier página, tomamos el sitio completo. El sitemap lo buscamos nosotros: primero en robots.txt, después en /sitemap.xml.

#Paso 2 — qué encontramos

Pulse Comprobar sitio. La comprobación no guarda nada: solo lee el sitemap y muestra cuántas páginas se han encontrado y cuántas se añadirán con los filtros aplicados. Si no hay sitemap, la conexión no se realiza y lo decimos con claridad, en lugar de importar cero páginas en silencio.

#Paso 3 — dónde colocarlo

Elija espacio y colección; la colección puede crearse en el propio asistente. Tras Conectar, el recorrido empieza de inmediato: el progreso se ve en la tarjeta del conector («Recorriendo el sitio 22 de 92») y en el indicador de tareas en segundo plano.

#Qué se toma y qué no

• se toma el contenido de la página, sin el menú, la cabecera ni el pie del sitio;
• Secciones del sitio limitan el recorrido por rutas (/docs/, /guides/); en blanco, tomamos el sitio completo;
• las secciones de servicio, como búsqueda y etiquetas, se omiten por defecto;
• Páginas por recorrido limita una sola pasada: protección frente a sitios enormes;
• las páginas bloqueadas en robots.txt no se descargan; su número aparece en el resumen del recorrido.

#Actualizaciones posteriores

Con la sincronización automática activada releemos el sitio según el calendario. Solo se reindexan las páginas que han cambiado: el resumen lo dice así — «añadidas», «actualizadas», «sin cambios». Las páginas sin cambios no consumen el límite de indexación.

Retirar páginas desaparecidas está desactivado por defecto: si una página desaparece del sitio, el artículo permanece en su base. Actívelo cuando la copia deba reflejar el sitio de forma estricta.

#Qué sitios funcionan y cuáles no

Funciona un sitio público con sitemap: así están hechos casi todos los generadores de documentación. Lo demás lo rechazamos en el paso de comprobación, y no después de conectar:

Incluso con el sitio conectado, algunas páginas pueden quedar fuera: las bloqueadas en robots.txt, las que responden con error, las de más de 10 MB o las que no devuelven HTML. Todas aparecen en el resumen del recorrido con el motivo: «omitidas» y «bloqueadas por robots.txt».

Los archivos (PDF, ZIP, imágenes) no se toman del sitio. Para ellos existe otra vía: la importación de archivos, con su propio procesamiento.

#Limitaciones

• un sitio por organización;
• el sitio debe ser público: las páginas tras contraseña no se leen;
• se necesita mapa del sitio: sin él no habrá conexión;
• respetamos robots.txt, incluida la pausa entre solicitudes que indique.

Desconexión. La sincronización se detiene y los artículos ya importados puede eliminarlos o conservarlos como artículos normales: LiKE lo pregunta al desconectar.

#Importación de archivos

#Subir archivos

1. Panel de control → Importar
2. Arrastre los archivos o haga clic en la zona de subida
3. Formatos admitidos: PDF, DOCX, TXT, MD, RTF, ZIP
4. La IA genera automáticamente un título y un slug para cada archivo
5. Antes de publicar puede editar el título o abrirlo en el editor

#Archivos ZIP

Suba un archivo ZIP con muchos documentos — LiKE descomprime y procesa automáticamente cada archivo. Práctico para migrar una base de conocimiento entera.

Archivos admitidos dentro de un ZIP: PDF, DOCX, TXT, MD, RTF. Otros archivos (imágenes, ejecutables) se omiten.

#Importación por enlace

Pegue un enlace a un documento — LiKE lo descarga e importa:

1. Panel de control → Importar → la sección «Importación por enlace»
2. Pegue una URL → haga clic en «Añadir»
3. Puede añadir hasta 10 enlaces a la vez
4. Haga clic en «Importar»

Fuentes admitidas:

• Google Docs — exportado automáticamente como DOCX
• Google Sheets — exportado como CSV
• Dropbox — un enlace directo al archivo
• Cualquier URL directa a un archivo PDF, DOCX, TXT, MD o RTF

#Visibilidad predeterminada

Para cada fuente puede configurar una visibilidad predeterminada:

• Borrador — los artículos se crean ocultos
• Equipo — visibles para los usuarios autorizados
• Público — visibles para todos, incluidos los usuarios anónimos

Se configura en Integraciones → tarjeta de la fuente → Visibilidad.

#Canales de acceso

Los canales permiten a sus empleados buscar información a través de herramientas familiares.

#Bot de Slack

Funciones:

• /like ¿cómo configuro SSO? → una respuesta de IA directamente en Slack
• Mencionar @LiKE en cualquier canal → una respuesta en el hilo
• Enlaces a los artículos de origen (clicables)

#Bot de Telegram

Funciones:

• Mensajes directos al bot → una respuesta de IA
• En un chat de grupo: /ask pregunta → una respuesta
• Compatibilidad con 25+ idiomas

#Widget JS (para su sitio web)

Un botón flotante de búsqueda con IA para incrustar en cualquier sitio web. La integración más popular — el usuario ve un botón en la esquina de la página, hace clic y se abre un chat con la IA y la búsqueda en su base de conocimiento.

#Instalación sencilla

#Parámetros básicos

#Dual-auth: dos modos de autenticación (ADR 0032)

En LiKE el widget puede funcionar en uno de dos modos — elegido al crearlo:

Para los detalles sobre cómo configurar cada modo e integrarse con su backend, consulte API y widget.

#Scope: qué puede encontrar el widget

Al crear un widget, define un scope — qué busca exactamente:

Dentro de un mismo widget puede combinar varias entradas de scope (por ejemplo, dos colecciones del mismo espacio).

#Multi-widget por tenant (ADR 0029 Stage 4)

Dentro de una organización puede crear varios widgets independientes con distintos scopes y modos:

Cada uno tiene su propia api-key y analítica de uso, y la clave se puede revocar de forma independiente. La gestión está en Integraciones → Widgets → «+ Crear».

#Gestión de sesiones (modo JWT de sesión)

En el modo JWT de sesión, cada sesión de usuario tiene un sessionId único. Un admin puede ver las sesiones activas de un widget concreto y revocar un token a la fuerza (por ejemplo, si se sospecha un compromiso). La lista está en Integraciones → Widgets → [widget] → Sesiones.

#iframe / Enlace directo

Incruste la interfaz de búsqueda completa de LiKE en cualquier página:

1. Integraciones → iframe → copie el código
2. Pegue <iframe src="..."> en su página
3. O use el enlace directo para navegar (una página completa, no una incrustación)

iframe y Enlace directo también admiten dual-auth — elegido al crearlos.

#REST API

Una API completa para la integración programática (por ejemplo, su propia UI o la integración con otros sistemas):

1. Integraciones → API Keys → «Crear clave»
2. Indique un nombre (para qué sirve la clave) y un scope (igual que para un widget — public_umbrella / space / collection)
3. Copie la clave — se muestra solo una vez, tras reabrir aparecerá enmascarada

Use la clave en el encabezado X-API-Key o como Bearer token.

Endpoints principales:

Límites: los rate limits dependen del plan y están ligados a la api-key. Al superarlos se devuelve HTTP 429 con un encabezado Retry-After. Los valores exactos para su plan están en la página de Planes y en el panel de administración.

Documentación completa de la API: API y widget.

#Idiomas

LiKE admite 25+ idiomas para la búsqueda con IA y la búsqueda interlingüística (la interfaz en sí está disponible en 11 locales de UI):

Русский, English, Deutsch, Français, Español, Português, Italiano, Nederlands, Polski, Čeština, Svenska, Dansk, Suomi, Română, Magyar, Hrvatski, Türkçe, Afrikaans, Kiswahili, Bahasa Indonesia, Tiếng Việt, Українська, Српски, Български, Ελληνικά, 한국어, 日本語, 中文, हिन्दी, ไทย, עברית, العربية.

Búsqueda interlingüística: una pregunta en un idioma → una respuesta a partir de artículos en otro.