> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Confluence

> Administra espacios, páginas, publicaciones de blog, etiquetas, propiedades y tareas de Confluence a través de tu cuenta conectada.

# Confluence

Usa Confluence cuando tu flujo de trabajo necesite crear o actualizar páginas, publicaciones de blog, espacios, etiquetas, propiedades o tareas. También funciona bien cuando necesitas buscar o recuperar contenido existente antes de actuar.

## Configuración

| Opción | Requerido | Descripción |
| - | - | - |
| Name | No | Etiqueta para el paso en el lienzo del flujo de trabajo. |
| Authentication | Yes | La cuenta de Confluence conectada que usarás para este paso. |
| Action | Yes | La acción de Confluence que se ejecutará (por ejemplo Get current user, List spaces, Get space, Search spaces). |
| Arguments | Yes | Campos de formulario específicos de la acción generados a partir del esquema de la acción. Cada campo de texto tiene un botón **Insert Variable** para insertar valores `{{placeholder}}`. Hay una pestaña **Raw JSON** disponible para uso avanzado. |
| When the step fails | No | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla. |

Antes de configurar este paso, conecta Confluence en **Integrations** para tu espacio de trabajo usando el flujo de inicio de sesión. Si no hay ninguna conexión activa disponible, el paso muestra una advertencia con un enlace a **Integrations** en lugar del selector de cuenta.

## Formulario de Arguments

Cuando seleccionas una acción, la sección **Arguments** muestra un formulario impulsado por el esquema de entrada de la acción. Los campos que hacen referencia a registros existentes incluyen selectores desplegables.

Cambia a la pestaña **Raw JSON** cuando prefieras escribir el objeto completo de argumentos manualmente. Los cambios en cualquiera de las dos pestañas se mantienen sincronizados.

## Acciones comunes

| Action | Description |
| - | - |
| **Get current user** | Devuelve el usuario y los detalles de la cuenta de Confluence conectada. |
| **List spaces** | Lista los espacios visibles para el usuario conectado. |
| **Get space** | Obtiene los detalles de un espacio por su ID. |
| **Search spaces** | Busca espacios por nombre, clave, tipo, estado o etiquetas. |
| **Create space** | Crea un nuevo espacio con una clave y un nombre. |
| **Create private space** | Crea un espacio privado con una clave y un nombre. |
| **List pages** | Lista las páginas en Confluence. |
| **Get page** | Obtiene una página por su ID. |
| **Search pages** | Busca páginas por título, espacio o estado. |
| **Create page** | Crea una nueva página en un espacio. |
| **Update page** | Actualiza el título o el contenido de una página existente. |
| **List child pages** | Lista las páginas hijas directas de una página. |
| **List page versions** | Lista todas las versiones de una página. |
| **Get page labels** | Obtiene las etiquetas aplicadas a una página. |
| **Add content label** | Añade etiquetas a una pieza de contenido. |

Las acciones destructivas, como eliminar registros, no están disponibles en el selector de acciones del flujo de trabajo.

## Resultado

Este paso almacena la respuesta de Confluence como salida del paso. La forma de la respuesta depende de la acción.

Usa la referencia completa de salida en pasos posteriores:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Ejemplo

1. Abre **Integrations** y conecta Confluence si aún no lo has hecho.
2. Añade un paso de **Confluence** a tu flujo de trabajo.
3. Selecciona una cuenta conectada en **Authentication**.
4. Elige **Get current user** en **Action**.
5. Completa los campos obligatorios. Usa **Insert Variable** para referenciar la salida de un paso anterior para cualquier valor de campo.
6. Haz clic en **Run** en el encabezado del paso para probar la acción, y luego revisa la carga útil devuelta en **Output**.

## Casos de uso

### Crear una página de proyecto

1. List spaces
2. Get space
3. Create page

### Actualizar una tarea seguida

1. List tasks
2. Update task

### Organizar contenido con etiquetas

1. Search pages
2. Get page labels
3. Add content label

## Notas

* Este paso depende de una integración de Confluence conectada en tu espacio de trabajo.
* El selector de acciones del flujo de trabajo muestra un conjunto curado de acciones. Los agentes con la herramienta de Confluence pueden usar más de ellas.
* La pantalla de inicio de sesión puede mostrar la marca de autorización de terceros.

## Usar Confluence como una herramienta de agente

También puedes añadir Confluence como una herramienta en el **Agent Editor**. Abre el agente, haz clic en **Add tool** y selecciona **Confluence**. En el panel de configuración de la herramienta, elige la cuenta conectada que el agente debe usar. El agente llama a acciones de Confluence cuando son relevantes para la conversación.

Ver también: [Integrations](https://docs.fetchhive.com/es/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/es/workflows/creating-and-editing.md), y [Testing and Iteration](https://docs.fetchhive.com/es/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.