Saltar al contenido principal

Confluence

Resumen​

La conexión de Confluence permite una integración segura de la plataforma Siesta AI con Atlassian Confluence a través de la API oficial. La integración proporciona acceso controlado al contenido del espacio de Confluence y permite:

  • búsqueda de páginas,
  • carga de contenido de documentación,
  • creación programática de nuevas páginas,
  • actualización de páginas existentes.

La conexión está diseñada para uso empresarial con un enfoque en la gestión de permisos, auditabilidad y seguridad en el acceso a los datos.

Requisitos​

  • Sitio activo de Confluence Cloud.
  • Cuenta de Atlassian que tenga acceso al espacio/páginas de Confluence con las que el conector trabajará.
  • Token API generado en la cuenta de Atlassian (id.atlassian.com → Security → API tokens).
  • Permisos de administrador para gestionar la conexión en Siesta AI.

Operaciones soportadas​

OperaciónDescripción
SearchPagesAsyncBúsqueda de texto completo de páginas dentro del espacio de Confluence seleccionado
GetPageAsyncCarga del contenido de la página incluyendo metadatos
CreatePageAsyncCreación de nuevas páginas en Confluence
UpdatePageAsyncActualización de páginas existentes

Gestión de permisos​

Cada operación se puede configurar de forma independiente:

  • Permitido – la operación está disponible sin restricciones.
  • Permitido con confirmación – la operación requiere aprobación manual.
  • Prohibido – la operación no está disponible.

Este modelo permite definir con precisión el alcance del acceso, por ejemplo, para:

  • agentes de solo lectura,
  • procesos de documentación automatizados,
  • escrituras controladas en Confluence.

Parámetros de configuración​

Parámetros obligatorios​

ParámetroDescripción
NombreDesignación interna del conector
ApiKeyToken API generado en la cuenta de Atlassian
URL del sitio de ConfluenceURL de la instancia de Atlassian (por ejemplo, https://empresa.atlassian.net)
Correo electrónico o nombre de usuario de la cuenta de AtlassianCorreo electrónico (o nombre de usuario) de la cuenta bajo la cual se creó el token

Procedimiento para añadir el conector de Confluence​

1) Prepare sus credenciales​

Antes de comenzar a crear la conexión en Siesta AI, prepare todos los valores que ingresará en el formulario.

En la cuenta de Atlassian, abra Security y la sección API Tokens.

Atlassian API Tokens

Haga clic en Create API token (sin scopes), ingrese el nombre del token y la expiración, y confirme la creación.

Creación de token API de Atlassian

Después de crear el token, cópielo una vez y guárdelo de forma segura.

Copia del token API de Atlassian

Luego, prepare también:

  • URL del sitio de Confluence (por ejemplo, https://empresa.atlassian.net)
  • Correo electrónico o nombre de usuario de la cuenta de Atlassian bajo la cual se creó el token

2) Abra la gestión de integraciones en Siesta AI​

En la administración de Siesta AI, vaya a Administration → Connected Apps.

3) Seleccione Confluence​

En el diálogo Agregar integración, seleccione Confluence y continúe.

Selección de Confluence en la lista de integraciones

4) Complete el formulario de Confluence​

Complete:

  • Nombre
  • ApiKey (token de Atlassian)
  • URL del sitio de Confluence (por ejemplo, https://empresa.atlassian.net)
  • Correo electrónico / nombre de usuario de la cuenta de Atlassian bajo la cual se creó el token

Confirme la creación de la integración.

Configuración de la integración de Confluence

5) Configure los permisos de las operaciones​

Después de crear la integración, abra Configuración de permisos y configure las operaciones permitidas.

Recomendación: configure las operaciones de escritura en Permitido con confirmación.

Configuración de permisos de operaciones

Nota importante sobre el token API y permisos​

El token API está vinculado a una cuenta de Atlassian específica. El conector hereda los permisos de esta cuenta en Confluence (lo que la cuenta no puede ver o modificar, el conector tampoco podrá).

Por esta razón, se recomienda:

  • que cada usuario tenga su propio token, si la conexión se ejecuta bajo su identidad,
  • o utilizar una cuenta de servicio dedicada para automatizaciones compartidas/producidas,
  • monitorear la expiración del token y realizar rotaciones regulares.

Escenarios típicos de uso​

Base de conocimientos interna​

  • Búsqueda en la documentación interna
  • Respuesta a preguntas de empleados
  • Acceso centralizado a información actual

Automatización de documentación​

  • Generación de notas de lanzamiento
  • Creación de actas de reuniones
  • Actualización de procedimientos operativos (SOP)

Conexión de procesos​

  • Sincronización de Jira → Confluence
  • Creación automática de informes
  • Documentación de incidentes y registros de auditoría

Arquitectura de seguridad​

La integración utiliza:

  • acceso autorizado a través de la API de Atlassian,
  • restricciones a un espacio específico de Confluence,
  • control granular de permisos de operaciones,
  • posibilidad de auditar actividades.

No se permite la descarga no autorizada de contenido ni el eludir los mecanismos de seguridad de la plataforma Atlassian.

Configuración operativa recomendada​

  • Permita la lectura sin restricciones.
  • Configure las operaciones de escritura en Permitido con confirmación.
  • Utilice espacios separados para documentación automatizada.
  • Revise regularmente los permisos de la conexión.