Visão Geral
Este artigo descreve como configurar a ação Executar Query GraphQL do conector Monday no Ligaí. Essa funcionalidade permite que o robô execute uma query ou mutation GraphQL diretamente na API do Monday, possibilitando consultas e operações personalizadas que não estão cobertas pelas demais ações do conector.
Quando Utilizar esta Ação
A ação Executar Query GraphQL deve ser integrada ao fluxo quando houver necessidade de:
- Realizar consultas customizadas à API do Monday que não são atendidas pelas ações padrão do conector.
- Executar mutations para criar, atualizar ou remover dados diretamente no Monday via GraphQL.
- Utilizar variáveis dinâmicas na query, aproveitando dados de etapas anteriores do fluxo.
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 Executar Query GraphQL.
2. Autenticação
Para que o robô tenha permissão de executar a query, é 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
- Query GraphQL (obrigatório): Código da query ou mutation GraphQL a ser executada na API do Monday.
- Variables JSON: Objeto JSON opcional com as variáveis da query.
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
- Erro de Sintaxe na Query GraphQL: Se a query ou mutation informada contiver erros de sintaxe, a API do Monday retornará uma mensagem de erro detalhando o problema. Revise a estrutura da query antes de salvar a configuração.
- Variables JSON Inválido: Caso o conteúdo do campo Variables JSON não seja um JSON válido, a execução falhará. Verifique a formatação do objeto antes de utilizá-lo.
- Campos ou Tipos Inexistentes: Se a query referenciar campos, tipos ou IDs que não existem na conta do Monday, a API retornará erro de validação. Confirme a estrutura do schema GraphQL do Monday antes de montar a query.
- Falha de Autenticação: Verifique se o Token informado está correto, ativo e possui permissão suficiente para a operação solicitada (leitura ou escrita, conforme a query/mutation).