> 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/pt/integracoes/overview/project-management/monday.md).

# Monday.com

Integre o seu Workflow com Monday.com

A etapa de integração com o Monday.com permite conectar os seus fluxos de trabalho do AirOps com quadros e espaços de trabalho do Monday.com. Esta integração nativa oferece capacidades abrangentes de gestão de quadros, grupos, itens, subitens e atualizações diretamente a partir dos seus fluxos de trabalho.

## Visão geral

O Monday.com é um sistema operacional de trabalho que permite às equipas criar fluxos de trabalho personalizados e gerir projetos visualmente. Ao conectar o Monday.com ao AirOps, você pode automatizar a criação de itens, atualizar o conteúdo do quadro, acompanhar o progresso dos projetos e integrar conteúdo com IA nos seus quadros.

## Autenticação

Antes de usar a integração com o Monday.com nos seus fluxos de trabalho, primeiro deve conectar a sua conta do Monday.com nas Configurações do AirOps:

1. Navegue para **Definições > Integrações**
2. Encontre a seção do Monday.com e clique em "Configurar"
3. Introduza o seu **Token da API** — encontrado na sua conta do Monday.com em **Foto de perfil > Administração > Conexões > Token de API pessoal** (ou através do avatar do seu perfil no canto inferior esquerdo em **Desenvolvedores > Meus tokens de acesso**)

{% hint style="info" %}
O seu token de API do Monday.com concede acesso a todos os quadros e espaços de trabalho que a sua conta pode ver. Use um token de uma conta com as permissões apropriadas para os quadros com os quais os seus fluxos de trabalho irão interagir.
{% endhint %}

## Ações disponíveis

### Gestão de Quadros

* **Criar Quadro** -- adicionar um novo quadro a um espaço de trabalho
* **Listar Quadros** -- obter quadros de todos os espaços de trabalho ou de um espaço de trabalho específico

### Gestão de Grupos

* **Criar Grupo** -- adicionar um novo grupo a um quadro
* **Listar Grupos** -- obter todos os grupos num quadro

### Gestão de Itens

* **Criar Item** -- adicionar um novo item a um quadro ou grupo
* **Obter Item** -- recuperar um único item por ID
* **Listar Itens** -- obter itens de um quadro ou grupo com paginação baseada em cursor
* **Atualizar Item** -- modificar os valores das colunas de um item existente
* **Eliminar Item** -- remover permanentemente um item
* **Mover Item para Grupo** -- mover um item para um grupo diferente dentro de um quadro

### Gestão de Subitens

* **Criar Subitem** -- adicionar um subitem sob um item existente

### Atualizações

* **Criar Atualização** -- adicionar uma atualização (comentário) a um item
* **Obter Atualizações** -- recuperar atualizações publicadas num item

### Gestão de Espaços de Trabalho

* **Listar Espaços de Trabalho** -- obter todos os espaços de trabalho na conta

<figure><img src="https://31915162-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>Escolha uma ação do Monday.com.</p></figcaption></figure>

## Parâmetros da Ação

### Criar Quadro

1. **Nome do Quadro** (obrigatório) -- o nome do novo quadro (ex. `Pipeline de Conteúdo T1`)
2. **Visibilidade** (obrigatório) -- quem pode aceder ao quadro: `público`, `privado`, ou `compartilhado`
3. **ID do espaço de trabalho** -- o ID numérico do espaço de trabalho no qual criar o quadro. Deixe em branco para usar o espaço de trabalho predefinido
4. **Descrição** -- uma descrição opcional para o quadro

### Listar Quadros

1. **ID do espaço de trabalho** -- filtrar quadros por ID do espaço de trabalho. Deixe em branco para retornar quadros de todos os espaços de trabalho
2. **Limite** -- número máximo de quadros a retornar (predefinição: `25`, máximo: `100`)
3. **Página** -- número da página para paginação (predefinição: `1`)

### Criar Grupo

1. **Quadro** (obrigatório) -- selecione o quadro do Monday.com
2. **Nome do Grupo** (obrigatório) -- o nome do novo grupo (máx. 255 caracteres)

### Listar Grupos

1. **Quadro** (obrigatório) -- selecione o quadro do Monday.com

### Criar Item

1. **Quadro** (obrigatório) -- selecione o quadro do Monday.com
2. **Nome do Item** (obrigatório) -- o nome do novo item
3. **Grupo** -- selecione um grupo dentro do quadro para adicionar o item
4. **Valores das Colunas** -- um objeto JSON que mapeia IDs de colunas para os seus valores (ex. `{"status": {"label": "Concluído"}, "date4": {"date": "2024-12-31"}}`)

<figure><img src="https://31915162-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>Crie um item do Monday.com a partir do resultado do fluxo de trabalho.</p></figcaption></figure>

### Obter Item

1. **ID do item** (obrigatório) -- o ID numérico do item a recuperar

### Listar Itens

1. **Quadro** (obrigatório) -- selecione o quadro do Monday.com
2. **Grupo** -- selecione um grupo dentro do quadro para filtrar itens
3. **Limite** -- número máximo de itens a retornar (predefinição: `50`, máximo: `500`)
4. **Cursor** -- cursor de paginação de um resultado anterior de Listar Itens. Quando fornecido, as seleções de quadro e grupo são ignoradas

### Atualizar Item

1. **Quadro** (obrigatório) -- selecione o quadro do Monday.com
2. **ID do item** (obrigatório) -- o ID numérico do item a atualizar
3. **Valores das Colunas** (obrigatório) -- um objeto JSON que mapeia IDs de colunas para os seus novos valores (ex. `{"status": {"label": "Em andamento"}, "text": "Conteúdo atualizado"}`)

### Eliminar Item

1. **ID do item** (obrigatório) -- o ID numérico do item a eliminar

### Mover Item para Grupo

1. **ID do item** (obrigatório) -- o ID numérico do item a mover
2. **Quadro** (obrigatório) -- selecione o quadro que contém o item (usado para preencher as opções de grupo)
3. **Grupo** (obrigatório) -- selecione o grupo de destino dentro do quadro

### Criar Subitem

1. **ID do Item Pai** (obrigatório) -- o ID numérico do item pai
2. **Nome do Item** (obrigatório) -- o nome do subitem
3. **Valores das Colunas** -- um objeto JSON que mapeia IDs de colunas para os seus valores

### Criar Atualização

1. **ID do item** (obrigatório) -- o ID numérico do item no qual publicar a atualização
2. **Corpo** (obrigatório) -- o conteúdo de texto da atualização

### Obter Atualizações

1. **ID do item** (obrigatório) -- o ID numérico do item
2. **Limite** -- número máximo de atualizações a retornar (predefinição: `50`, máximo: `100`)
3. **Página** -- número da página para paginação (predefinição: `1`)

### Listar Espaços de Trabalho

1. **Limite** -- número máximo de espaços de trabalho a retornar (predefinição: `25`, máximo: `100`)
2. **Página** -- número da página para paginação (predefinição: `1`)

## Casos de uso comuns

* Criar automaticamente itens do quadro a partir de briefs de conteúdo gerados por IA
* Atualizar os valores das colunas do item (estado, datas, responsáveis) com base nos resultados do fluxo de trabalho
* Publicar resumos ou relatórios gerados por IA como atualizações em itens existentes
* Mover itens entre grupos à medida que progridem por um pipeline de conteúdo
* Criar subitens para dividir tarefas em passos menores e rastreáveis
* Criar calendários editoriais ao criar grupos e itens para cada peça de conteúdo
* Obter itens do quadro para enriquecer, reescrever ou analisar conteúdo existente em escala

{% hint style="info" %}
Nota: os valores das colunas do Monday.com seguem um formato JSON específico que varia conforme o tipo de coluna. Consulte a [documentação da API do Monday.com](https://developer.monday.com/api-reference/docs/column-types-reference) para a estrutura correta de cada tipo de coluna (estado, data, pessoa, 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/pt/integracoes/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.
