> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/es/integraciones/overview/project-management/monday.md).

# Monday.com

Integra tu flujo de trabajo con Monday.com

El paso de integración de Monday.com te permite conectar tus flujos de trabajo de AirOps con tableros y espacios de trabajo de Monday.com. Esta integración nativa proporciona capacidades completas de administración de tableros, grupos, elementos, subelementos y actualizaciones directamente desde tus flujos de trabajo.

## Descripción general

Monday.com es un sistema operativo de trabajo que permite a los equipos crear flujos de trabajo personalizados y gestionar proyectos visualmente. Al conectar Monday.com con AirOps, puedes automatizar la creación de elementos, actualizar el contenido del tablero, hacer seguimiento del progreso del proyecto e integrar contenido impulsado por IA en tus tableros.

## Autenticación

Antes de usar la integración de Monday.com en tus flujos de trabajo, primero debes conectar tu cuenta de Monday.com en la Configuración de AirOps:

1. Navega a **Ajustes > Integraciones**
2. Busca la sección de Monday.com y haz clic en "Configurar"
3. Introduce tu **Token de API** — se encuentra en tu cuenta de Monday.com en **Imagen de perfil > Administración > Conexiones > Token personal de API** (o a través del avatar de tu perfil en la parte inferior izquierda, en **Desarrolladores > Mis tokens de acceso**)

{% hint style="info" %}
Tu token de API de Monday.com otorga acceso a todos los tableros y espacios de trabajo que tu cuenta puede ver. Usa un token de una cuenta con los permisos adecuados para los tableros con los que interactuarán tus flujos de trabajo.
{% endhint %}

## Acciones disponibles

### Gestión de tableros

* **Crear tablero** -- añade un nuevo tablero a un espacio de trabajo
* **Listar tableros** -- obtener tableros de todos los espacios de trabajo o de un espacio de trabajo específico

### Gestión de grupos

* **Crear grupo** -- añade un nuevo grupo a un tablero
* **Listar grupos** -- obtener todos los grupos de un tablero

### Gestión de elementos

* **Crear elemento** -- añade un nuevo elemento a un tablero o grupo
* **Obtener elemento** -- recuperar un único elemento por ID
* **Listar elementos** -- obtener elementos de un tablero o grupo con paginación basada en cursor
* **Actualizar elemento** -- modifica los valores de las columnas de un elemento existente
* **Eliminar elemento** -- elimina permanentemente un elemento
* **Mover elemento a grupo** -- mueve un elemento a un grupo diferente dentro de un tablero

### Gestión de subelementos

* **Crear subelemento** -- añade un subelemento debajo de un elemento existente

### Actualizaciones

* **Crear actualización** -- añade una actualización (comentario) a un elemento
* **Obtener actualizaciones** -- recupera las actualizaciones publicadas en un elemento

### Gestión de espacios de trabajo

* **Listar espacios de trabajo** -- obtener todos los espacios de trabajo de la cuenta

## Parámetros de acción

### Crear tablero

1. **Nombre del tablero** (obligatorio) -- el nombre del nuevo tablero (p. ej. `Flujo de contenido T1`)
2. **Visibilidad** (obligatorio) -- quién puede acceder al tablero: `público`, `privado`, o `compartido`
3. **ID del espacio de trabajo** -- el ID numérico del espacio de trabajo en el que crear el tablero. Déjalo en blanco para usar el espacio de trabajo predeterminado
4. **Descripción** -- una descripción opcional del tablero

### Listar tableros

1. **ID del espacio de trabajo** -- filtra los tableros por ID de espacio de trabajo. Déjalo en blanco para devolver tableros de todos los espacios de trabajo
2. **Límite** -- número máximo de tableros a devolver (predeterminado: `25`, máximo: `100`)
3. **Página** -- número de página para la paginación (predeterminado: `1`)

### Crear grupo

1. **Tablero** (obligatorio) -- selecciona el tablero de Monday.com
2. **Nombre del grupo** (obligatorio) -- el nombre del nuevo grupo (máximo 255 caracteres)

### Listar grupos

1. **Tablero** (obligatorio) -- selecciona el tablero de Monday.com

### Crear elemento

1. **Tablero** (obligatorio) -- selecciona el tablero de Monday.com
2. **Nombre del elemento** (obligatorio) -- el nombre del nuevo elemento
3. **Agrupa** -- selecciona un grupo dentro del tablero al que añadir el elemento
4. **Valores de columnas** -- un objeto JSON que asocia IDs de columnas con sus valores (p. ej. `{"status": {"label": "Hecho"}, "date4": {"date": "2024-12-31"}}`)

### Obtener elemento

1. **ID del elemento** (obligatorio) -- el ID numérico del elemento a recuperar

### Listar elementos

1. **Tablero** (obligatorio) -- selecciona el tablero de Monday.com
2. **Agrupa** -- selecciona un grupo dentro del tablero para filtrar los elementos
3. **Límite** -- número máximo de elementos a devolver (predeterminado: `50`, máximo: `500`)
4. **Cursor** -- cursor de paginación de un resultado anterior de Listar elementos. Cuando se proporciona, se ignoran las selecciones de tablero y grupo

### Actualizar elemento

1. **Tablero** (obligatorio) -- selecciona el tablero de Monday.com
2. **ID del elemento** (obligatorio) -- el ID numérico del elemento a actualizar
3. **Valores de columnas** (obligatorio) -- un objeto JSON que asocia IDs de columnas con sus nuevos valores (p. ej. `{"status": {"label": "En progreso"}, "text": "Contenido actualizado"}`)

### Eliminar elemento

1. **ID del elemento** (obligatorio) -- el ID numérico del elemento a eliminar

### Mover elemento a grupo

1. **ID del elemento** (obligatorio) -- el ID numérico del elemento a mover
2. **Tablero** (obligatorio) -- selecciona el tablero que contiene el elemento (se usa para rellenar las opciones de grupo)
3. **Agrupa** (obligatorio) -- selecciona el grupo de destino dentro del tablero

### Crear subelemento

1. **ID del elemento padre** (obligatorio) -- el ID numérico del elemento padre
2. **Nombre del elemento** (obligatorio) -- el nombre del subelemento
3. **Valores de columnas** -- un objeto JSON que asocia IDs de columnas con sus valores

### Crear actualización

1. **ID del elemento** (obligatorio) -- el ID numérico del elemento en el que publicar la actualización
2. **Cuerpo** (obligatorio) -- el contenido de texto de la actualización

### Obtener actualizaciones

1. **ID del elemento** (obligatorio) -- el ID numérico del elemento
2. **Límite** -- número máximo de actualizaciones a devolver (predeterminado: `50`, máximo: `100`)
3. **Página** -- número de página para la paginación (predeterminado: `1`)

### Listar espacios de trabajo

1. **Límite** -- número máximo de espacios de trabajo a devolver (predeterminado: `25`, máximo: `100`)
2. **Página** -- número de página para la paginación (predeterminado: `1`)

## Casos de uso comunes

* Creación automática de elementos del tablero a partir de resúmenes de contenido generados por IA
* Actualización de valores de columnas de elementos (estado, fechas, responsables) según los resultados del flujo de trabajo
* Publicación de resúmenes o informes generados por IA como actualizaciones en elementos existentes
* Movimiento de elementos entre grupos a medida que avanzan por un flujo de contenido
* Creación de subelementos para dividir tareas en pasos más pequeños y rastreables
* Creación de calendarios editoriales mediante la creación de grupos y elementos para cada pieza de contenido
* Obtención de elementos del tablero para enriquecer, reescribir o analizar contenido existente a escala

{% hint style="info" %}
Nota: Los valores de las columnas de Monday.com siguen un formato JSON específico que varía según el tipo de columna. Consulta la [documentación de la API de Monday.com](https://developer.monday.com/api-reference/docs/column-types-reference) para conocer la estructura correcta de cada tipo de columna (estado, fecha, persona, etc.).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/es/integraciones/overview/project-management/monday.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.