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/products/webhook-delivery.md.
  • Português

      • Por que o teste do meu webhook de entrega falhou?

      Ao clicar em Enviar teste, a Clickmax envia o payload para a URL do Webhook que você configurou e mostra a resposta que o seu servidor devolveu. O selo ao lado do botão traz o status HTTP real — por exemplo 401 - Unauthorized — e não uma confirmação genérica.

      Um status fora da faixa 2xx significa que a entrega chegou ao seu servidor e ele recusou. O problema está na configuração do lado que recebe, não no envio.

      Papel de workspace: Proprietário, Administrador, Editor ou Colaborador.

      Onde ver o resultado do teste

      1. Abra o produto, vá até a oferta e adicione (ou edite) uma entrega do tipo webhook.
      2. Preencha a URL do Webhook e o Método HTTP.
      3. Em Selecione os eventos para disparo, marque pelo menos um evento.
      4. Clique em Enviar teste.
      5. Clique em Ver payload para abrir os detalhes.

      O painel mostra duas partes:

      SeçãoO que contém
      Payload enviadoO JSON que a Clickmax montou e enviou
      Resposta do seu servidorStatus, cabeçalhos e corpo da resposta que o seu servidor devolveu

      Respostas muito longas aparecem cortadas, com o aviso de que só o início está sendo exibido.

      O que cada status quer dizer

      StatusSignificadoO que fazer
      200, 201, 204Entrega aceitaNada. Está funcionando.
      401, 403Seu servidor recusou a autenticaçãoConfira o token na URL e os headers em Adicionar autenticação personalizada?
      404O endereço não existe no seu servidorRevise o caminho da URL
      405Seu servidor não aceita esse métodoAjuste o Método HTTP para o que o seu endpoint espera
      500 e demais 5xxSeu servidor recebeu, mas quebrou ao processarVerifique os logs da sua aplicação com o payload enviado

      Leia sempre o corpo em Resposta do seu servidor: a maioria das APIs explica o motivo ali, como {"error":"unauthorized"}.

      Se a URL redireciona

      Quando o endereço que você informou redireciona para outro dentro do mesmo site — o caso mais comum é o domínio sem www apontando para a versão com www — a Clickmax segue o redirecionamento automaticamente e entrega no destino final. Você não precisa fazer nada.

      Já um redirecionamento para outro site é recusado, com a mensagem:

      Esse endereço redireciona para outro site. Use o endereço final do seu webhook.

      Isso é proposital: os headers de autenticação que você cadastrou não são reenviados para um domínio diferente do que você configurou. Descubra para onde o seu endereço aponta e cadastre esse endereço final diretamente.

      Se o endereço é recusado antes do envio

      A mensagem abaixo aparece quando o endereço não pode ser usado como webhook:

      A URL do webhook precisa ser um endereço https público e válido.

      Causas possíveis:

      • O endereço não começa com https://
      • É um endereço de rede interna ou local (por exemplo localhost ou faixas privadas)
      • O domínio não resolve
      • O endereço leva usuário e senha embutidos, no formato https://usuario:senha@dominio

      Nesses casos nada é enviado. Corrija o endereço e teste de novo.

      Relacionados