Visão Geral
Este artigo descreve como configurar a ação Listar Files do conector Monday no Ligaí. Essa funcionalidade permite que o robô liste e baixe arquivos anexados em colunas do tipo file no Monday, a partir de um board e/ou item específico.
Quando Utilizar esta Ação
A ação Listar Files deve ser integrada ao fluxo quando houver necessidade de:
- Recuperar automaticamente arquivos anexados em itens do Monday para processamento em etapas seguintes do fluxo.
- Filtrar arquivos específicos por nome dentro de um board ou item.
- Automatizar rotinas que dependem de documentos anexados no Monday, evitando o download manual pela equipe.
Pré-requisitos
Antes de configurar esta ação, é obrigatório que a conta possua um Token de API válido do Monday e que ele esteja corretamente cadastrado no Ligaí. Para saber como solicitar e configurar o token de acesso, consulte:
Passo a Passo de Configuração
1. Adicionar a etapa Monday no robô
- Acesse o menu Meus Robôs.
- Abra o robô desejado.
- Selecione o conector Monday.
- Escolha a ação Listar Files.
2. Autenticação
Para que o robô tenha permissão de listar os arquivos, é necessário preencher o token de acesso ao Monday:
- Token (obrigatório): Token de API gerado na conta do Monday, utilizado para autenticação das requisições. Para saber como gerar esse token, consulte a documentação oficial: Obtendo seu API token
3. Dados Gerais
- Board ID: Identificador do board (ou boards) no qual a busca de arquivos será realizada.
Informe um ou mais IDs de boards. Para múltiplos IDs, separe-os com ponto e vírgula (;).
- Item IDs: Identificador do item (ou itens/cards) no qual a busca de arquivos será realizada.
Informe um ou mais IDs de itens/cards. Para múltiplos IDs, separe-os com ponto e vírgula (;). Quando informado, não precisa do Board ID.
- Filtrar por nome do arquivo: Texto para filtrar e retornar apenas os arquivos cujo nome corresponda ao valor informado.
4. Salvar a Configuração
- Após o preenchimento dos blocos necessários, clique no botão azul Confirmar na parte inferior da tarefa.
- Lembre-se de clicar em Salvar na barra superior do robô para gravar as alterações no fluxo de automação.
Erros Comuns e Como Proceder
- Board ID ou Item IDs Inválidos: Se os IDs informados não existirem ou não pertencerem à conta autenticada pelo Token, a API retornará lista vazia ou erro de referência. Verifique se os IDs foram copiados corretamente do Monday.
- Nenhum Arquivo Encontrado: Quando o filtro por nome do arquivo não corresponder a nenhum anexo existente no board/item informado, a listagem retornará vazia. Revise o texto do filtro ou remova-o para uma busca mais ampla.
- Falha de Autenticação: Verifique se o Token informado está correto, ativo e possui permissão de leitura sobre o board/item consultado.
- Conflito entre Board ID e Item IDs: Caso ambos os campos sejam preenchidos, o robô priorizará o Item IDs. Caso o resultado não seja o esperado, revise se apenas o campo necessário para a busca está preenchido.