Como criar caminhos pelo resultado da requisição HTTP?
Adicione a condição Resultado da requisição HTTP dentro de um Roteador (ou Condicional) logo depois do passo Requisição HTTP. Ela separa os contatos pelo que o outro sistema respondeu — deu certo, recusou o pedido, está fora do ar ou nem respondeu — para a automação avisar alguém, tentar outro caminho ou simplesmente seguir.
É a alternativa a parar a execução em erro: em vez de terminar, o contato segue por um caminho seu. Veja O que acontece quando a requisição HTTP da automação falha? para escolher entre os dois.
Papel: qualquer membro com acesso de edição no workspace.
Antes de começar
- Uma automação com um passo Requisição HTTP antes do ponto onde a divisão vai entrar. A condição lê o resultado da requisição mais recente daquele caminho.
Passo a passo
-
No canvas, clique no + depois do passo Requisição HTTP e escolha Roteador.
-
No caminho 1, dê um nome (por exemplo,
Integração fora do ar) e clique em Adicionar condição. -
Na coluna da esquerda, abra a aba Requisição HTTP e clique em Resultado da requisição HTTP.
-
Escolha o operador:
-
Com é igual a, informe o código no campo ao lado (de
100a599) — por exemplo409para "esse registro já existe aí". -
Em Requisição, escolha de qual nó HTTP é o resultado. O padrão, Última requisição do caminho, serve para o caso comum de um nó HTTP só.
-
Repita nos demais caminhos e conecte cada saída ao passo que deve acontecer. A saída Senão recebe quem não combinou com nenhum caminho.
Com mais de uma requisição na automação
Última requisição do caminho responde sempre sobre o nó HTTP mais recente que rodou. Numa automação com duas requisições, isso quer dizer a segunda — mesmo que você queira perguntar sobre a primeira.
Para perguntar sobre uma requisição específica, escolha-a no campo Requisição. A lista traz os nós HTTP da automação identificados pelo método e pela URL (por exemplo, POST https://api.exemplo.com/pedidos).
Dois detalhes que evitam surpresa:
- A lista traz todos os nós HTTP, não só os que vêm antes. Qual nó de fato roda depende do caminho que o contato percorre, e isso só se sabe na hora. Se você escolher um nó que não rodou para aquele contato, a condição não combina com nada e ele sai pelo Senão.
- Duplicar a automação mantém a escolha. A condição passa a apontar para o nó correspondente da cópia, não para o da automação original.
Quando nenhum caminho combina
Se nenhuma requisição HTTP rodou antes naquele caminho, a condição não combina com nada — nem com Não houve resposta — e o contato sai pelo Senão. Um caminho que nunca chamou o outro sistema não "falhou", então ele não é mandado para o ramo de erro.
Por isso, coloque a condição depois do passo Requisição HTTP, nunca antes.
O código também é uma variável
O resultado fica disponível como {{httpStatus}} nos passos seguintes — dá para usar no texto de uma mensagem ou no corpo de outra requisição. Quando não houve resposta nenhuma, o valor é 0.
Se não funcionou
- Todos os contatos caem no Senão: confira se o passo Requisição HTTP está mesmo antes da divisão, no mesmo caminho.
- A automação não publica: com o operador é igual a, o código é obrigatório. O builder avisa quando ele ficou em branco.
- O caminho de erro nunca recebe ninguém: confira se o passo HTTP não está configurado para Parar e registrar a falha — assim a execução termina no próprio passo e não chega à divisão.