Visão Geral
Este artigo descreve como configurar a ação Listar Boards do conector Monday no Ligaí. Essa funcionalidade permite que o robô liste boards do Monday com seus itens/cards e os valores das colunas, sem realizar o download de arquivos anexados.
Quando Utilizar esta Ação
A ação Listar Boards deve ser integrada ao fluxo quando houver necessidade de:
- Consultar automaticamente os itens/cards e os valores de colunas de um ou mais boards do Monday.
- Alimentar etapas seguintes do fluxo com os dados estruturados dos boards, sem a necessidade de baixar arquivos anexados.
- Realizar uma varredura completa de todos os boards disponíveis na conta, quando nenhum ID específico for informado.
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 Boards.
2. Autenticação
Para que o robô tenha permissão de listar boards, é 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
- IDs dos boards: Identificador do board (ou boards) a serem listados.
Informe um ou mais IDs de boards. Para múltiplos IDs, separe-os com ponto e vírgula (;). Se ficar vazio, todos os boards serão buscados.
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
- IDs dos Boards Inválidos: Se algum dos IDs informados não existir ou não pertencer à conta autenticada pelo Token, a API retornará erro de referência para o ID inválido ou simplesmente o ignorará na listagem. Verifique se os IDs foram copiados corretamente do Monday.
- Retorno Muito Extenso: Ao deixar o campo IDs dos boards vazio em contas com muitos boards, itens e colunas, a resposta pode ser volumosa e impactar o tempo de processamento do fluxo. Sempre que possível, informe os IDs específicos necessários.
- Falha de Autenticação: Verifique se o Token informado está correto, ativo e possui permissão de leitura sobre os boards consultados.