API de Confluence: qué puedes hacer y cómo usarla con agentes de IA
La API REST de Confluence, de Atlassian, permite leer, crear y actualizar páginas, espacios, comentarios y adjuntos, y hacer búsquedas. La usan equipos que mantienen su base de conocimiento en Confluence y quieren usarla en otros sistemas. En Confluence Cloud, el acceso se hace con un token de API o con OAuth 2.0.
Qué ofrece la API de Confluence
Páginas
Lectura, creación, actualización e historial de versiones de las páginas.
Espacios
Consulta y organización de los espacios.
Búsqueda (CQL)
Búsqueda de contenido con el lenguaje de consulta de Confluence.
Comentarios
Lectura y creación de comentarios en las páginas.
Adjuntos
Carga y descarga de archivos adjuntos.
Etiquetas
Etiquetas para organizar y filtrar el contenido.
Cómo acceder a la API de Confluence
- Con las credenciales de tu empresaEn Confluence Cloud usa el correo del usuario con un token de API (autenticación básica) u OAuth 2.0 con una app de Atlassian. Las versiones instaladas en servidor usan tokens personales.
- El agente hereda los permisos del usuario: los espacios restringidos deben seguir restringidos.
- Confluence Cloud tiene límites de tasa.
- Las páginas pueden contener datos personales: evita indexar espacios de RR. HH. sin necesidad.
Documentación oficial: developer.atlassian.com/cloud/confluence
Qué hace un agente de iTeam con la API de Confluence
Respuestas con fuente
El agente responde dudas sobre procesos y producto citando la página de Confluence de la que sacó la información.
Página de acta y decisiones
Después de una reunión, el agente crea la página de acta en el espacio del proyecto, con las decisiones y los responsables.
Documentación desactualizada
El agente señala las páginas muy consultadas que llevan mucho tiempo sin actualizarse y avisa a su responsable.
Onboarding guiado
Los nuevos empleados preguntan al agente y reciben el recorrido de páginas adecuado para su área.
De la credencial al agente trabajando, con aprobación
Crea la credencial
Genera un token de API de un usuario de integración o configura una app OAuth con permisos de lectura y, si hace falta, de escritura.
Define los espacios en iTeam
En la bóveda de iTeam, registra la credencial y elige qué espacios puede leer o editar cada agente.
Prueba con preguntas reales
Haz preguntas del día a día, revisa las fuentes citadas y solo después habilita la creación de páginas.
Equipos de IA listos que usan Confluence
Preguntas sobre la API de Confluence
¿La API de Confluence es gratuita?
La API no tiene un cobro aparte. Está disponible en los planes de Confluence, con límites que varían según el plan.
¿Necesito programar para usar la API de Confluence con iTeam?
No. iTeam se conecta a Confluence y el equipo de implantación te ayuda a elegir espacios y permisos.
¿Funciona con Confluence Data Center?
En general sí, siempre que la API sea accesible desde la red de la integración. Esto se verifica en el diagnóstico.
