---
title: Confluence
description: Interactúa con Confluence
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="confluence"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Confluence](https://www.atlassian.com/software/confluence) es la potente plataforma de colaboración en equipo y gestión del conocimiento de Atlassian. Sirve como un espacio de trabajo centralizado donde los equipos pueden crear, organizar y compartir información entre departamentos y organizaciones.

Con Confluence, puedes:

- **Crear documentación estructurada**: Construir wikis completas, planes de proyectos y bases de conocimiento con formato enriquecido
- **Colaborar en tiempo real**: Trabajar juntos en documentos con compañeros de equipo, con comentarios, menciones y capacidades de edición
- **Organizar la información jerárquicamente**: Estructurar el contenido con espacios, páginas y jerarquías anidadas para una navegación intuitiva
- **Integrar con otras herramientas**: Conectar con Jira, Trello y otros productos de Atlassian para una integración fluida del flujo de trabajo
- **Controlar permisos de acceso**: Gestionar quién puede ver, editar o comentar contenido específico

En Sim, la integración con Confluence permite a tus agentes acceder y aprovechar la base de conocimientos de tu organización. Los agentes pueden recuperar información de las páginas de Confluence, buscar contenido específico e incluso actualizar la documentación cuando sea necesario. Esto permite que tus flujos de trabajo incorporen el conocimiento colectivo almacenado en tu instancia de Confluence, haciendo posible crear agentes que puedan consultar documentación interna, seguir procedimientos establecidos y mantener recursos de información actualizados como parte de sus operaciones.
{/* MANUAL-CONTENT-END */}

## Instrucciones de uso

Integra Confluence en el flujo de trabajo. Puede leer, crear, actualizar, eliminar páginas, gestionar comentarios, adjuntos, etiquetas y buscar contenido.

## Herramientas

### `confluence_retrieve`

Recupera contenido de las páginas de Confluence utilizando la API de Confluence.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `pageId` | string | Sí | ID de la página de Confluence a recuperar |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de la recuperación |
| `pageId` | string | ID de la página de Confluence |
| `content` | string | Contenido de la página con etiquetas HTML eliminadas |
| `title` | string | Título de la página |

### `confluence_update`

Actualiza una página de Confluence utilizando la API de Confluence.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `pageId` | string | Sí | ID de la página de Confluence a actualizar |
| `title` | string | No | Nuevo título para la página |
| `content` | string | No | Nuevo contenido para la página en formato de almacenamiento de Confluence |
| `version` | number | No | Número de versión de la página \(requerido para prevenir conflictos\) |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de actualización |
| `pageId` | string | ID de página de Confluence |
| `title` | string | Título de página actualizado |
| `success` | boolean | Estado de éxito de la operación de actualización |

### `confluence_create_page`

Crear una nueva página en un espacio de Confluence.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `spaceId` | string | Sí | ID del espacio de Confluence donde se creará la página |
| `title` | string | Sí | Título de la nueva página |
| `content` | string | Sí | Contenido de la página en formato de almacenamiento de Confluence \(HTML\) |
| `parentId` | string | No | ID de la página padre si se está creando una página hija |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de creación |
| `pageId` | string | ID de la página creada |
| `title` | string | Título de la página |
| `url` | string | URL de la página |

### `confluence_delete_page`

Eliminar una página de Confluence (la mueve a la papelera donde puede ser restaurada).

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `pageId` | string | Sí | ID de la página de Confluence a eliminar |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de eliminación |
| `pageId` | string | ID de página eliminada |
| `deleted` | boolean | Estado de eliminación |

### `confluence_search`

Buscar contenido en páginas de Confluence, publicaciones de blog y otro contenido.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `query` | string | Sí | Cadena de consulta de búsqueda |
| `limit` | number | No | Número máximo de resultados a devolver \(predeterminado: 25\) |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de búsqueda |
| `results` | array | Resultados de búsqueda |

### `confluence_create_comment`

Añadir un comentario a una página de Confluence.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `pageId` | string | Sí | ID de la página de Confluence donde comentar |
| `comment` | string | Sí | Texto del comentario en formato de almacenamiento de Confluence |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de creación |
| `commentId` | string | ID del comentario creado |
| `pageId` | string | ID de la página |

### `confluence_list_comments`

Listar todos los comentarios en una página de Confluence.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `pageId` | string | Sí | ID de la página de Confluence de la que listar comentarios |
| `limit` | number | No | Número máximo de comentarios a devolver \(predeterminado: 25\) |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de la recuperación |
| `comments` | array | Lista de comentarios |

### `confluence_update_comment`

Actualizar un comentario existente en una página de Confluence.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `commentId` | string | Sí | ID del comentario de Confluence a actualizar |
| `comment` | string | Sí | Texto del comentario actualizado en formato de almacenamiento de Confluence |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de actualización |
| `commentId` | string | ID del comentario actualizado |
| `updated` | boolean | Estado de actualización |

### `confluence_delete_comment`

Eliminar un comentario de una página de Confluence.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `commentId` | string | Sí | ID del comentario de Confluence a eliminar |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de eliminación |
| `commentId` | string | ID del comentario eliminado |
| `deleted` | boolean | Estado de eliminación |

### `confluence_upload_attachment`

Sube un archivo como adjunto a una página de Confluence.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `pageId` | string | Sí | ID de la página de Confluence a la que adjuntar el archivo |
| `file` | file | Sí | El archivo a subir como adjunto |
| `fileName` | string | No | Nombre de archivo personalizado opcional para el adjunto |
| `comment` | string | No | Comentario opcional para añadir al adjunto |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de la subida |
| `attachmentId` | string | ID del adjunto subido |
| `title` | string | Nombre del archivo adjunto |
| `fileSize` | number | Tamaño del archivo en bytes |
| `mediaType` | string | Tipo MIME del adjunto |
| `downloadUrl` | string | URL de descarga del adjunto |
| `pageId` | string | ID de la página a la que se añadió el adjunto |

### `confluence_list_attachments`

Lista todos los adjuntos en una página de Confluence.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `pageId` | string | Sí | ID de la página de Confluence de la que listar adjuntos |
| `limit` | number | No | Número máximo de adjuntos a devolver \(predeterminado: 25\) |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de la recuperación |
| `attachments` | array | Lista de archivos adjuntos |

### `confluence_delete_attachment`

Eliminar un archivo adjunto de una página de Confluence (lo mueve a la papelera).

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `attachmentId` | string | Sí | ID del archivo adjunto de Confluence a eliminar |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de eliminación |
| `attachmentId` | string | ID del archivo adjunto eliminado |
| `deleted` | boolean | Estado de eliminación |

### `confluence_list_labels`

Listar todas las etiquetas de una página de Confluence.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `pageId` | string | Sí | ID de la página de Confluence de la que listar etiquetas |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de la recuperación |
| `labels` | array | Lista de etiquetas |

### `confluence_get_space`

Obtener detalles sobre un espacio específico de Confluence.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `spaceId` | string | Sí | ID del espacio de Confluence a recuperar |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de la recuperación |
| `spaceId` | string | ID del espacio |
| `name` | string | Nombre del espacio |
| `key` | string | Clave del espacio |
| `type` | string | Tipo de espacio |
| `status` | string | Estado del espacio |
| `url` | string | URL del espacio |

### `confluence_list_spaces`

Listar todos los espacios de Confluence accesibles para el usuario.

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `domain` | string | Sí | Tu dominio de Confluence \(p. ej., tuempresa.atlassian.net\) |
| `limit` | number | No | Número máximo de espacios a devolver \(predeterminado: 25\) |
| `cloudId` | string | No | ID de Confluence Cloud para la instancia. Si no se proporciona, se obtendrá utilizando el dominio. |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `ts` | string | Marca de tiempo de la recuperación |
| `spaces` | array | Lista de espacios |

## Notas

- Categoría: `tools`
- Tipo: `confluence`
