> 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 seus fluxos de trabalho do AirOps com quadros e espaços de trabalho do Monday.com. Esta integração nativa oferece capacidades abrangentes de gerenciamento de quadros, grupos, itens, subitens e atualizações diretamente dos seus fluxos de trabalho.

## Visão geral

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

## Autenticação

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

1. Navegue até **Definições > Integrações**
2. Encontre a seção do Monday.com e clique em "Configurar"
3. Insira sua **Token de API** — encontrado na sua conta do Monday.com em **Foto do Perfil > Administração > Conexões > Token Pessoal da API** (ou por meio do avatar do seu perfil no canto inferior esquerdo em **Desenvolvedores > Meus Tokens de Acesso**)

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

## Ações disponíveis

### Gerenciamento de Quadros

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

### Gerenciamento de Grupos

* **Criar Grupo** -- adicionar um novo grupo a um quadro
* **Listar Grupos** -- buscar todos os grupos em um quadro

### Gerenciamento de Itens

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

### Gerenciamento de Subitens

* **Criar Subitem** -- adicionar um subitem abaixo de um item existente

### Atualizações

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

### Gerenciamento de Espaços de Trabalho

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

## Parâmetros da Ação

### Criar Quadro

1. **Nome do Quadro** (obrigatório) -- o nome do novo quadro (por exemplo, `Pipeline de Conteúdo T1`)
2. **Visibilidade** (obrigatório) -- quem pode acessar o quadro: `público`, `privado`, ou `compartilhar`
3. **ID da Área de trabalho** -- o ID numérico do espaço de trabalho em que criar o quadro. Deixe em branco para usar o espaço de trabalho padrão
4. **Descrição** -- uma descrição opcional para o quadro

### Listar Quadros

1. **ID da Área 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 (padrão: `25`, máx: `100`)
3. **Página** -- número da página para paginação (padrã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áximo de 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. **Agrupar** -- selecione um grupo dentro do quadro para adicionar o item
4. **Valores das Colunas** -- um objeto JSON que mapeia IDs de colunas para seus valores (por exemplo, `{"status": {"label": "Concluído"}, "date4": {"date": "2024-12-31"}}`)

### 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. **Agrupar** -- selecione um grupo dentro do quadro para filtrar itens
3. **Limite** -- número máximo de itens a retornar (padrão: `50`, máx: `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 seus novos valores (por exemplo, `{"status": {"label": "Em Andamento"}, "text": "Conteúdo atualizado"}`)

### Excluir Item

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

### 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. **Agrupar** (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 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 (padrão: `50`, máx: `100`)
3. **Página** -- número da página para paginação (padrão: `1`)

### Listar Espaços de Trabalho

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

## Casos de Utilização Comuns

* Criar automaticamente itens de quadro a partir de briefings de conteúdo gerados por IA
* Atualizar valores de colunas de itens (status, 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 avançam por um pipeline de conteúdo
* Criar subitens para dividir tarefas em etapas menores e rastreáveis
* Criar calendários editoriais criando grupos e itens para cada peça de conteúdo
* Buscar itens do quadro para enriquecer, reescrever ou analisar conteúdo existente em escala

{% hint style="info" %}
Observação: 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 (status, 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.
