For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/automations/http-request-failure.md.
  • Português

      • O que acontece quando a requisição HTTP da automação falha?

      O passo Personalizado (requisição HTTP) tem um bloco Confiabilidade com três escolhas: se a automação para ou segue quando o outro sistema responde com erro, quantas vezes tentar de novo antes de desistir, e quanto tempo esperar pela resposta.

      Por padrão, um passo novo para e registra a falha — a execução daquele contato aparece na aba Execuções com o motivo, em vez de terminar como se tivesse dado certo.

      Papel: qualquer membro com acesso de edição no workspace.

      Antes de começar

      • Uma automação com um passo Personalizado (menu Próximo passo → seção Integração).

      Passo a passo

      1. No canvas da automação, clique no passo Requisição HTTP para abrir a configuração.
      2. Role até o bloco Confiabilidade.
      3. Em Se a requisição falhar, escolha:
        • Parar e registrar a falha — a execução daquele contato termina ali e entra na aba Execuções com o motivo. Os passos seguintes não rodam.
        • Seguir para o próximo passo — a automação continua como se nada tivesse acontecido.
      4. Em Tentativas extras, escolha de Não tentar de novo até 3 tentativas extras.
      5. Em Tempo limite (segundos), informe de 1 a 120. O padrão é 30.
      6. Clique em Salvar.

      No card do passo, o canvas passa a mostrar o que foge do padrão — por exemplo Para se falhar · 2 tentativas extras · limite de 60s.

      O que conta como falha

      SituaçãoÉ falha
      O outro sistema respondeu 2xx (deu certo)não
      O outro sistema respondeu 3xx (redirecionamento) e o endereço final não foi alcançadosim
      O outro sistema respondeu 4xx (erro no pedido: endereço errado, credencial inválida, dado recusado)sim
      O outro sistema respondeu 5xx (problema no destino)sim
      O tempo limite acabou antes da respostasim
      O endereço não respondeu (fora do ar, domínio inexistente, conexão recusada)sim
      O endereço foi recusado por não ser público e https://sim

      Quais falhas são tentadas de novo

      As tentativas extras valem só para falhas passageiras:

      • 429 (o destino pediu para desacelerar);
      • 408 e erros 5xx do destino;
      • tempo limite, conexão recusada e demais quedas de rede.

      Um erro 4xx nunca é repetido: o pedido é o mesmo e a resposta seria a mesma. Um endereço recusado também não, pelo mesmo motivo.

      Entre uma tentativa e outra a automação espera cada vez mais — cerca de 30 segundos, depois 2 minutos, depois 8 minutos. Se o destino disser no cabeçalho Retry-After quando estará pronto, esse tempo é respeitado; quando ele pede mais de 15 minutos, a automação desiste em vez de segurar o contato esperando.

      O contato fica aguardando entre as tentativas — os passos seguintes só rodam quando a requisição termina, seja com sucesso ou com a última falha.

      O outro sistema não vai receber a mesma coisa duas vezes sem saber

      Toda requisição que envia dados (POST, PUT, PATCH, DELETE) sai com dois cabeçalhos:

      CabeçalhoO que é
      X-Clickmax-Idempotency-KeyIdentificador da entrega. É o mesmo em todas as tentativas do mesmo contato no mesmo passo
      X-Clickmax-Delivery-Attempt1 na primeira tentativa, 2, 3… nas seguintes

      Se o seu sistema guardar a chave e ignorar uma chave repetida, uma tentativa extra nunca vira um pedido duplicado.

      Automações que já existiam continuam como estavam

      Passos salvos antes desta atualização seguem em Seguir para o próximo passo, sem tentativas extras e com limite de 30 segundos — nada muda sozinho. Para passar a parar em erro, abra o passo, mude a escolha e salve.

      Se não funcionou

      • A execução não aparece como falha: confira se o passo está em Parar e registrar a falha. Em Seguir para o próximo passo o erro só fica registrado no passo, e a execução termina normalmente.
      • A automação está demorando muito para prosseguir: com tentativas extras, o contato espera o intervalo entre elas. Reduza as tentativas ou o tempo limite.
      • O destino recebeu o pedido duas vezes: ele está ignorando o X-Clickmax-Idempotency-Key. Guarde a chave no seu lado e recuse a repetida.
      • O erro diz que o endereço não é permitido: a URL precisa começar com https:// e apontar para um endereço público. Endereços internos e http:// são recusados.

      Relacionados