> 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 ofrece capacidades integrales de gestió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 de forma visual. Al conectar Monday.com con AirOps, puedes automatizar la creación de elementos, actualizar el contenido del tablero, hacer seguimiento del progreso de los proyectos 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 **Configuración > Integraciones**
2. Busca la sección de Monday.com y haz clic en "Configurar"
3. Ingresa tu **Token de API** — se encuentra en tu cuenta de Monday.com en **Foto de perfil > Administración > Conexiones > Token personal de API** (o a través de tu avatar de 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 solo elemento por ID
* **Listar elementos** -- obtener elementos de un tablero o grupo con paginación basada en cursor
* **Actualizar elemento** -- modificar los valores de las columnas de un elemento existente
* **Eliminar elemento** -- eliminar permanentemente un elemento
* **Mover elemento al grupo** -- mover 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ñadir una actualización (comentario) a un elemento
* **Obtener actualizaciones** -- recuperar 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

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-bb54633f78d43b54589fa6cd28cbc04fd9568ef2%2Fmonday-01-actions.png?alt=media" alt="Monday.com Integration step with the Action dropdown listing Create Board, List Boards, Create Group, List Groups, Create Item, Get Item, List Items, Update Item, Delete Item, Move Item to Group, Create Subitem, Create Update, Get Updates, List Workspaces"><figcaption><p>Elige una acción de Monday.com.</p></figcaption></figure>

## Parámetros de la acción

### Crear tablero

1. **Nombre del tablero** (obligatorio) -- el nombre del nuevo tablero (por ejemplo, `Pipeline de contenido T1`)
2. **Visibilidad** (obligatorio) -- quién puede acceder al tablero: `público`, `privado`, o `compartir`
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 para el tablero

### Listar tableros

1. **ID del espacio de trabajo** -- filtrar tableros por ID de espacio de trabajo. Déjalo en blanco para devolver los 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áx. 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. **Grupo** -- selecciona un grupo dentro del tablero al que añadir el elemento
4. **Valores de columnas** -- un objeto JSON que asigna IDs de columna a sus valores (por ejemplo, `{"status": {"label": "Hecho"}, "date4": {"date": "2024-12-31"}}`)

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-0ab22642351625dcf9f4c996177f67615ca5d037%2Fmonday-02-create-item.png?alt=media" alt="Monday.com Create Item action on the Content Pipeline board with a group and column values"><figcaption><p>Crea un elemento de Monday.com a partir de la salida del flujo de trabajo.</p></figcaption></figure>

### Obtener elemento

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

### Listar elementos

1. **Tablero** (obligatorio) -- selecciona el tablero de Monday.com
2. **Grupo** -- 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 que se va a actualizar
3. **Valores de columnas** (obligatorio) -- un objeto JSON que asigna IDs de columna a sus nuevos valores (por ejemplo, `{"status": {"label": "En progreso"}, "text": "Contenido actualizado"}`)

### Eliminar elemento

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

### Mover elemento al grupo

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

### Crear subelemento

1. **ID del elemento principal** (obligatorio) -- el ID numérico del elemento principal
2. **Nombre del elemento** (obligatorio) -- el nombre del subelemento
3. **Valores de columnas** -- un objeto JSON que asigna IDs de columna a 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

* Crear automáticamente elementos del tablero a partir de resúmenes de contenido generados por IA
* Actualizar los valores de las columnas del elemento (estado, fechas, responsables) según los resultados del flujo de trabajo
* Publicar resúmenes o informes generados por IA como actualizaciones en elementos existentes
* Mover elementos entre grupos a medida que avanzan por una canalización de contenido
* Crear subelementos para desglosar tareas en pasos más pequeños y rastreables
* Crear calendarios editoriales generando grupos y elementos para cada pieza de contenido
* Obtener elementos del tablero para enriquecer, reescribir o analizar contenido existente a gran escala

{% hint style="info" %}
Nota: Los valores de 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.
