Presentación
Conecte espacios de Confluence para que el contenido de las páginas se convierta en conocimiento en el que se pueda buscar en Docebo.
Este conector sincroniza espacios completos de Confluence, el contenido y la jerarquía de las páginas, en lugar de archivos individuales, por lo que aparece en la lista como conector de "Sitios". Esta es la diferencia principal con los conectores de SharePoint y Google Drive.
1. Información básica
Qué contenido se sincroniza
| Tipo de contenido | Estado | Nota |
|---|---|---|
| Páginas publicadas dentro de un espacio seleccionado | Sincronizado | |
| Etiquetas de las páginas | Sincronizado | |
| Archivos y archivos adjuntos dentro de las páginas | No sincronizado | Fuera del alcance: este conector solo incluye el contenido de las páginas, no los archivos |
| Comentarios | No sincronizado | |
| Páginas en borrador o no publicadas | No sincronizado | |
| Espacios archivados | No sincronizado |
Qué contenido se extrae
| Contenido | Estado |
|---|---|
| Título y texto del cuerpo de la página | Extraído |
| Nombre del espacio, clave y URL de la página | Extraído |
| Metadatos y jerarquía de las páginas (estructura principal/secundaria, marcas de tiempo) | Extraído |
| Etiquetas de las páginas | Extraído |
| Imágenes insertadas, diagramas y resultados representados de las macros | No extraído |
| Comentarios | No extraído |
| Historial de las páginas y comparaciones de versiones | No extraído |
| Contenido de los archivos adjuntos | No extraído |
2. Requisitos previos en el sistema de origen
Rol requerido
Debe ser administrador de la organización de Atlassian; ser administrador del sitio de Confluence no es suficiente. El acceso de administrador de la organización permite al conector identificar correctamente a los usuarios y acceder a todos los espacios; un administrador del sitio no puede garantizar ninguna de las dos cosas.
Configuración requerida
- Este conector solo admite Confluence Cloud. Confluence Data Center no es compatible.
- Si su organización utiliza una lista de aplicaciones permitidas, añada la nueva aplicación OAuth antes de autorizarla.
3. Preparación en el sistema de origen
Crear la aplicación
Vaya a la consola de desarrolladores de Atlassian, seleccione Create → OAuth 2.0 integration y asigne un nombre a la aplicación (por ejemplo, "Conector de Docebo Knowledge"). Seleccione un tipo de acceso: utilice Account-level en la mayoría de los casos; concede acceso a todos los sitios de la organización de Atlassian del cliente. Seleccione Resource-level solo si la organización tiene varios sitios independientes y desea conectar específicamente uno de ellos.
Crear una nueva integración OAuth 2.0 (3LO), con la opción de tipo de acceso.
Añadir permisos
Abra la aplicación → Permissions y añada tanto User identity API como Confluence API. Para Confluence API, añada los ámbitos de las pestañas Classic scopes y Granular scopes; el conector de Docebo utiliza ambos.
User identity API
| Nombre del ámbito | Descripción | Código |
|---|---|---|
| Ver el perfil del usuario activo | Ver los datos del perfil del usuario que ha iniciado sesión. | read:me |
| Ver perfiles de usuarios | Se requiere para ver los perfiles de los usuarios. | read:account |
User identity API: ámbitos seleccionados en la consola de desarrolladores de Atlassian.
Confluence API — Classic scopes
| Nombre del ámbito | Código |
|---|---|
| Leer el resumen del espacio de Confluence | read:confluence-space.summary |
| Leer las propiedades del contenido de Confluence | read:confluence-props |
| Leer el contenido detallado de Confluence | read:confluence-content.all |
| Leer el resumen del contenido de Confluence | read:confluence-content.summary |
| Buscar contenido y resúmenes de espacios de Confluence | search:confluence |
| Leer el permiso del contenido en Confluence | read:confluence-content.permission |
| Leer usuarios | read:confluence-user |
| Leer grupos de usuarios | read:confluence-groups |
| Descargar archivos adjuntos del contenido | readonly:content.attachment:confluence |
Confluence API: pestaña Classic scopes en la consola de desarrolladores de Atlassian.
Confluence API — Granular scopes
| Nombre del ámbito | Código |
|---|---|
| Ver contenido detallado | read:content:confluence |
| Ver detalles del contenido | read:content-details:confluence |
| Ver detalles del espacio | read:space-details:confluence |
| Ver páginas | read:page:confluence |
| Ver grupos | read:group:confluence |
| Ver detalles de usuarios | read:user:confluence |
| Ver espacios | read:space:confluence |
| Ver propiedades del espacio | read:space.property:confluence |
| Ver configuración del espacio | read:space.setting:confluence |
| Comprobar permisos del contenido | read:content.permission:confluence |
| Ver restricciones del contenido y permisos del espacio | read:permission:confluence |
| Leer la dirección de correo electrónico | read:email-address:confluence |
Confluence API: pestaña Granular scopes en la consola de desarrolladores de Atlassian.
Configurar la autenticación
Abra Authorization, active OAuth 2.0 (3LO) y establezca la Callback URL. La URL de devolución de llamada siempre sigue este patrón: https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback; por ejemplo, https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback. Seleccione Save changes.
Pestaña Authorization con el campo Callback URL y el generador de la URL de autorización.
Definir la distribución
Abra Distribution y configure Distribution status como Sharing; esto permite que cualquier cuenta de Atlassian autorice el conector, no solo la cuenta que creó la aplicación. Rellene los datos del proveedor y de seguridad que se solicitan: nombre del proveedor, URL de la política de privacidad, URL de los términos del servicio y un contacto de asistencia al cliente. En Personal data declaration, indique si la aplicación almacena datos personales y, a continuación, seleccione Save changes.
Controles de edición de la distribución, con Compartir seleccionado y los datos del proveedor rellenados.
4. Acciones necesarias en Docebo
| Información a introducir | Dónde encontrarla |
|---|---|
| URL del sitio de Confluence | Su dirección de Confluence Cloud, por ejemplo, yourcompany.atlassian.net |
| ID de cliente | Consola de desarrolladores de Atlassian → aplicación → Settings → Authentication details |
| Secreto del cliente | Consola de desarrolladores de Atlassian → aplicación → Settings → Authentication details |
Autorizar el conector
- Vaya a Add-ons and integrations → Knowledge Connectors → Create → Confluence. Este menú solo está visible para los Superadministradores.
- Introduzca la URL de Confluence (por ejemplo, https://yourcompany.atlassian.net) y seleccione Continue.
Conectar Confluence: pestaña Setup con el campo de URL de Confluence.
- Introduzca el ID de cliente y el secreto del cliente de su aplicación de Atlassian (Settings → Authentication details) y seleccione Authenticate.
Conectar Confluence: pestaña Authenticate con los campos de ID de cliente y secreto del cliente.
- En la ventana emergente de Atlassian, revise el acceso solicitado y seleccione Accept.
Pantalla de consentimiento de Atlassian para el conector de Docebo.
- En la pestaña Scope, seleccione los espacios que desea que estén disponibles para añadirlos posteriormente a las colecciones de Knowledge y guarde la selección.
Conectar Confluence: pestaña Scope para seleccionar los espacios que se sincronizarán.