O bloco Enviar Solicitação HTTP no construtor de fluxo de trabalho da monday AI permite enviar solicitações HTTP de saída para sistemas diretamente de um fluxo de trabalho. Use-o para acionar webhooks, integrar com APIs de terceiros, enviar dados para sistemas internos e suportar cenários de automação personalizados.

Quando este bloco é executado, ele envia uma solicitação usando a configuração que você define (método, URL, cabeçalhos e corpo), e seu fluxo de trabalho continua com base no resultado.

 

Como acessar o bloco Enviar Solicitação HTTP 

Para adicionar o bloco Enviar Solicitação HTTP no construtor de fluxo de trabalho da monday AI:

1Abra o construtor de fluxo de trabalho da monday AI

2Abra um fluxo de trabalho existente ou crie um novo

3Clique no ícone + para adicionar um novo bloco e selecione o bloco Enviar Solicitação HTTP

 

 

Para adicionar o bloco, você precisará configurá-lo com todos os dados relevantes:

 

Configure o bloco Enviar Solicitação HTTP 

Após adicionar o bloco, configure os seguintes campos:

Token da API:

Selecione um token da API no menu suspenso. 

Os tokens são gerenciados através do aplicativo de Credenciais.

Você pode referenciar o token selecionado dentro dos cabeçalhos usando {{token}}. 

Você deve adicionar um cabeçalho com o espaço reservado {{token}}, caso contrário, o token não será enviado.

Exemplo: Authorization:Bearer {{token}}

 

Método:

Escolha o método HTTP para sua solicitação. 

Métodos suportados: 

• GET 
• POST
• PUT

 

URL: 

Insira uma URL HTTP ou HTTPS válida.

Exemplo: https://api.example.com/v1/users

 

Você pode incluir parâmetros de consulta diretamente na URL da seguinte forma:

https://api.example.com/v1/users?status=active&limit=10

Requisitos da URL:

• Deve usar http ou https
• Não deve apontar para endereços de rede interna/privada

 

Cabeçalhos: 

Adicione cabeçalhos como uma lista de strings neste formato exato: paramName:paramValue

Regras: 

Sem espaços antes ou depois de :

Você pode usar {{token}} para referenciar o token da API selecionado

Exemplos:

• Content-Type:application/json
• Authorization:Bearer {{token}}
• X-Custom-Header:my-value

 

Tipo de corpo: 

Selecione o tipo de corpo no menu suspenso. O tipo de corpo determina como o corpo da solicitação será interpretado. Escolha o tipo exigido pela API de destino.

Por exemplo: JSON ou texto bruto

 

Conteúdo do corpo: 

Insira o conteúdo do corpo da solicitação. 

Se você selecionar JSON, o corpo deve ser um JSON válido (o sistema valida o formato antes de enviar).

 

Exemplo de corpo JSON:

{
  "name": "John Doe",
  "email": "[email protected]"
}

 

Tratamento de erros 

O comportamento do bloco depende do tipo de falha:

Erros de configuração (erros do cliente)

Causados por configuração incorreta do bloco (por exemplo, URL, token ou corpo inválidos)

• Retorna o código de status HTTP recebido
• Interrompe a execução do fluxo de trabalho e marca o bloco como falhado
• Deve ser corrigido na configuração

 

Erros de servidor (falhas transitórias)

Causados por problemas do lado do servidor (por exemplo, tempo limite, resposta 5xx, problema temporário de rede)

• Retorna código de status HTTP e mensagem de erro
• Retorna código de severidade 2000
• Aciona um mecanismo de repetição para lidar com falhas temporárias

 

Resposta bem-sucedida

• Retorna código de status HTTP
• Retorna o corpo da resposta no campo resultado
• O fluxo de trabalho continua a execução

 

Exemplo de configuração

Enviar um webhook com autenticação

• Método: POST
• URL: https://example.com/webhook
• Cabeçalhos:
  • Content-Type:application/json
  • Authorization:Bearer {{token}}
• Tipo de corpo: JSON
• Conteúdo do corpo:

{
  "event": "item.created",
  "itemId": 123
}

 

Notas e melhores práticas 

• Use {{token}} em vez de codificar segredos.
• Valide sua URL antes de salvar o fluxo de trabalho.
• Teste seu endpoint usando uma ferramenta como Postman antes de configurá-lo.

 

Enviar uma solicitação para a API da monday

Se você quiser enviar uma solicitação para a API da monday usando este bloco, configure-o da seguinte forma:

• URL: https://api.monday.com/v2
• Método: POST
• Cabeçalhos: Authorization:{{token}}

O sistema definirá automaticamente Content-Type:application/json, então você não precisa adicioná-lo manualmente.

Conteúdo do corpo (JSON) exemplo de consulta GraphQL:

{
  "query": "query { me { id name } }"
}

 

 

Verificar entrada e saída (histórico de execução) 

Para verificar o que foi enviado e o que foi retornado pelo endpoint:

1Abra o Histórico de Execução do seu fluxo de trabalho

2Encontre a execução que você deseja revisar

3Expanda o bloco Enviar Solicitação HTTP para visualizar a entrada e a saída

 

---

Ficou com alguma dúvida? Acione o suporte oficial a qualquer momento.

Para soluções completas de implantação, treinamento e estruturação de workflows no Brasil, conte com a Audatia, parceira oficial da monday.com. Descubra como podemos ajudar →