Base de conocimiento pública

La base de conocimiento pública (Public KB) es la parte de su base de conocimiento accesible sin iniciar sesión mediante un enlace directo, un widget o un iframe. Solo llegan aquí los artículos que ha marcado explícitamente como públicos.

Para qué sirve:

• Autoservicio del cliente: los clientes encuentran respuestas por sí mismos, sin contactar con soporte
• SEO: los artículos públicos son indexados por Google y otros buscadores
• Demostración: los posibles clientes leen la documentación antes de comprar
• Socios: acceso a la documentación técnica sin necesidad de crear cuentas

#Cómo un artículo se hace público

La publicidad se activa mediante dos ajustes: uno a nivel del artículo y otro a nivel de la organización. Hasta que ambos estén en su sitio, los visitantes anónimos no verán el artículo.

No existe un TIPO de espacio «público». Los espacios son solo Corporativo / Privado / Personal. Un artículo se vuelve visible no al moverlo a un espacio especial, sino mediante el flag publish_state=public (en un espacio corporativo) junto con el modo de acceso público de la organización activado.

#Estados de publish_state (ADR 0029)

LiKE utiliza el campo publish_state (que sustituye al antiguo campo visibility). Cuatro estados:

En la interfaz, el color del estado se muestra mediante un indicador de punto:

Las mismas insignias son visibles en la lista de artículos en Gestión de artículos.

#El espacio virtual __public__

Cuando un usuario anónimo abre la base de conocimiento pública mediante un enlace directo o un widget, técnicamente no se encuentra en ninguno de sus espacios. En su lugar, LiKE utiliza un «espacio» virtual __public__, un valor centinela que:

• No existe en la base de datos como un ArticleCollection.type='public' real
• Incluye todos los artículos con publish_state='public' de los espacios corporativos de la organización
• Se utiliza para el filtrado en la búsqueda RAG del usuario anónimo
• Se muestra en el SpaceSwitcher como «🌐 Artículos públicos» (si el usuario también tiene espacios privados)

Si es un miembro autorizado, cambie a __public__ en el SpaceSwitcher para ver exactamente el mismo conjunto de artículos que ve un visitante anónimo: resulta útil para comprobar «qué he publicado por accidente».

#Configuración (paso a paso)

#Paso 1 — Coloque los artículos en un espacio corporativo

Solo puede publicar hacia el exterior desde un espacio corporativo (en los espacios privados y personales la publicación está bloqueada). Si sus artículos están en otro espacio, muévalos a uno corporativo: de uno en uno mediante el menú contextual del artículo → Mover, o de forma masiva (casillas → Mover). Al crear un espacio, los tipos disponibles son Corporativo y Privado; «Personal» es un espacio del sistema.

#Paso 2 — Haga públicos los artículos

Cambie los artículos que necesite a publish_state = public (consulte Gestión de artículos):

• De forma masiva: seleccione con las casillas → el botón del globo (🌐) en la barra de acciones → Público
• Un solo artículo: el menú «⋮» → «Visibilidad: …» → Público; en el modo «Árbol», el menú contextual → «Hacer público»
• En el editor: el botón «Publicar» en la cabecera

Después de eso, el indicador de estado se vuelve verde y aparece una insignia 🌐 Público. Si el artículo contiene datos personales, se abre un diálogo de confirmación: consulte «Comprobación de datos personales antes de publicar» más abajo.

#Paso 3 — Active el modo público de la organización

Configuración → Organización → Modo de acceso → elija «Público».

• Público: los usuarios anónimos ven, en la dirección pública, los artículos marcados como públicos; los espacios privados siguen disponibles solo por invitación.
• Corporativo: todo está disponible solo para los miembros que han iniciado sesión; los usuarios externos sin iniciar sesión no ven nada, ni siquiera los artículos marcados como públicos.

Sin el modo «Público» activado, la dirección pública está cerrada: este paso es obligatorio.

#Paso 4 — Dirección pública y canales

Hay tres maneras de abrir la base de conocimiento pública ya lista:

• Portal público: la raíz de su dirección https://<su-slug>.lynkora.pro: búsqueda, respuestas con IA y lectura de artículos sin iniciar sesión. Un artículo individual está en /kb/<article-slug>.
• Widget JS: integrado en su sitio web; el código del widget se obtiene en Integraciones → Canales (la tarjeta «Widget JS»).
• iframe: inserción de la interfaz de búsqueda completa en una página.

Ya no existe una pestaña «Public KB» aparte en la configuración (ADR 0029): la publicidad se establece ahora mediante el flag del artículo + el modo de la organización, en lugar de una lista blanca de fuentes. Los widgets se gestionan en Integraciones → Canales.

#Comprobación de datos personales antes de publicar

Cuando cambia un artículo a Público, LiKE lo analiza automáticamente en busca de datos personales (PII). Si encuentra alguno, la publicación se detiene y aparece un diálogo «Datos personales detectados», antes de que el artículo quede accesible para todos sin iniciar sesión.

Cuándo se activa: solo al publicar (al cambiar a public, acceso anónimo). No se ejecuta para internal, draft ni inherit. Se aplica a todas las vías de publicación: el botón «Publicar» del editor, «Hacer público» en la lista/árbol, los cambios de visibilidad en lote y la publicación de una colección/espacio.

Qué se detecta (de forma determinista, basada en patrones):

• Correo electrónico
• Teléfono
• Tarjeta de pago (suma de verificación de Luhn)
• IBAN (validado por suma de verificación)
• Dirección IP
• Fecha de nacimiento

Las categorías especiales (salud, datos biométricos, etc., GDPR Art. 9) todavía no se detectan automáticamente: el diálogo solo muestra una advertencia sobre la responsabilidad reforzada que implica publicarlas.

Qué muestra el diálogo:

• El título «Datos personales detectados» y una lista de los tipos detectados con sus recuentos (agregados de todos los artículos que se van a publicar).
• Una casilla de confirmación obligatoria: la herramienta ayuda a detectar PII, pero no garantiza su exhaustividad; usted, como responsable del tratamiento, sigue siendo responsable de la licitud de la publicación y de contar con una base legal o el consentimiento.
• Botones Cancelar y Publicar (Publicar se habilita solo después de marcar la casilla).

Tras la confirmación: el artículo se publica y la confirmación se registra en el registro de actividad (pii_public_ack) con los tipos de datos detectados, sin almacenar el propio texto de los PII (privacy-by-design). La confirmación queda vinculada a la versión actual del artículo: si edita el texto después, deberá confirmar de nuevo.

Quién puede confirmar: los mismos roles que pueden publicar — Editor y superiores en el espacio del artículo (Owner y Admin siempre). Publicar en lote todos los artículos de una fuente está reservado a Owner/Admin.

#Widgets para la base de conocimiento pública (doble autenticación, ADR 0032)

LiKE admite dos modos de autenticación para los widgets, que se eligen al crear un widget en Integraciones → Widgets:

#Modo 1 — Rutas permitidas (para sitios públicos)

Un widget integrado en el sitio público de la empresa (una landing page, páginas de marketing, un centro de ayuda). No se requiere autenticación: el widget está disponible para cualquier visitante.

Protección contra el abuso:

• Una lista de URL permitidas (rutas permitidas): dónde es válida esta api-key. Por ejemplo, https://susitio.com/* y https://docs.susitio.com/*. Las solicitudes de otros dominios se rechazan (CORS + comprobación).
• Ámbito público (public umbrella scope): el widget solo tiene acceso al espacio __public__ + colecciones concretas de ese espacio, definidas al crearlo.
• Límite de frecuencia (rate limit) sobre la api-key: protección frente a bots.

#Modo 2 — JWT de sesión (para un sitio corporativo con autenticación)

Un widget integrado en el portal interno de la empresa, donde los usuarios ya cuentan con autenticación. El widget acepta un JWT de sesión y ve exactamente lo que ese usuario ve.

Casos de uso:

• Un widget en una intranet corporativa → cada empleado ve sus propios espacios
• Integración en una aplicación SaaS (por ejemplo, en un CRM): el usuario ve la documentación correspondiente a su rol

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

Dentro de una organización puede crear varios widgets con distintos ámbitos:

• Uno, público, para el sitio de marketing (rutas permitidas)
• Otro, corporativo, para la intranet (JWT de sesión)
• Un tercero, para una colección concreta (por ejemplo, solo las FAQ para el centro de soporte)

Cada widget tiene su propia api-key, ámbito y modo de autenticación. Consulte Integraciones → Widgets y API y widget para más detalles.

#Qué ven los visitantes anónimos

La búsqueda anónima utiliza por defecto una cookie de huella del cliente (fingerprint) para una limitación de frecuencia básica, pero no vincula la solicitud a una cuenta de usuario.

#Ocultar colecciones concretas

En un espacio corporativo no todas las colecciones tienen que ser necesariamente visibles para los usuarios anónimos. Puede ocultar colecciones concretas:

1. El menú contextual de la colección → Propiedades
2. El campo publish_state de la colección:
   • inherit: hereda del espacio (por defecto)
   • internal: oculta para los usuarios anónimos, visible para el equipo
   • public: explícitamente pública (solo en un espacio corporativo, en caso contrario bloqueada)

Esto aporta flexibilidad: por ejemplo, en un espacio corporativo «Documentación» puede mantener los borradores en una colección Internal Drafts con publish_state=internal: son invisibles hacia el exterior pero están disponibles para sus editores.

#Inserción en un sitio web

La base de conocimiento pública se puede integrar en un sitio web de tres maneras:

Detalles de cada uno en API y widget e Integraciones.

#White-label y un dominio propio

La base de conocimiento pública está disponible en la dirección por defecto slug.lynkora.pro. Las capacidades avanzadas del portal —white-label (sin la marca LiKE) y la conexión de un dominio propio (Configuración → Dominio)— están incluidas en los planes donde el white-label está habilitado. No hay un complemento de pago aparte para esto.

Qué capacidades están disponibles en qué planes y a qué precio: consulte la página de Precios y su panel de administración.