Webhook não chega ao meu sistema
A tela de Webhooks tem um teste de envio e um gráfico de tentativas, mas não tem registro por entrega nem botão de reenvio, então o diagnóstico é conferir a configuração, testar e olhar o lado do seu sistema.
Onde acessar
Plataforma > Configuração > Webhooks ou Loja > Configurações > Webhooks
A tela tem duas abas:
| Aba | O que tem |
|---|---|
| Minhas conexões | A lista dos webhooks, com editar, excluir e o botão Adicionar Webhook |
| Envios realizados | O gráfico Tentativas do Webhook por período, o filtro Selecionar webhook e o botão Realizar teste |
Passo a passo do diagnóstico
1. Faça um teste
- Abra a aba Envios realizados.
- Em Selecionar webhook, escolha a conexão.
- Clique em Realizar teste.
- "Teste realizado com sucesso!": o seu endereço recebeu e respondeu. O problema está no evento, no filtro ou no processamento do seu sistema. Siga para os passos 3 e 4.
- "O teste falhou, confira as configurações do webhook e tente novamente!": o endereço não respondeu como esperado. Siga para o passo 2.
2. Confira o endereço e a autenticação
Em Minhas conexões, edite o webhook e revise:
- URL para envio de dados: precisa começar com
https://, estar acessível pela internet e aceitar requisições do tipo POST com corpo em JSON. Endereço de rede interna oulocalhostnão recebe. - Authorization header: o valor precisa ser o que o seu sistema espera. Token trocado no destino e não atualizado aqui é a causa mais comum de falha depois de um período funcionando.
- Tipo de autenticação: em Usuário e senha, confira a URL de autenticação, o Usuário e a Senha.
3. Confira os eventos e o filtro
- Eventos: o webhook só envia os eventos marcados. As opções são Cadastro de novos usuários, Pedidos, Matrículas, Iniciate Checkout, Carrinho abandonado e Assinatura em atraso.
- Loja e Produto: se o webhook está limitado a uma loja ou a um produto, vendas de outros não disparam. Use Todas e Todos para receber de tudo.
- Carrinho abandonado: depende do Tempo para o alerta (em minutos). O envio só acontece depois desse tempo.
4. Veja se há tentativas no período
Na aba Envios realizados, escolha o período e o webhook. O gráfico mostra quantas tentativas houve em cada dia.
- Há tentativas e o seu sistema não registrou: a requisição saiu. Procure nos registros do seu servidor pelo horário do evento.
- Não há tentativas: o evento não aconteceu no período, ou o filtro de loja, produto ou evento deixou de fora.
Limites
- Não há registro por entrega. O admin não mostra a resposta do seu servidor nem o conteúdo enviado em cada tentativa.
- Não há reenvio. Não existe botão para mandar de novo um evento que falhou. Para recuperar dados, exporte as transações ou as matrículas do período e importe no seu sistema.
- Para ver os campos de cada evento, abra a lista Campos disponíveis, no formulário do webhook.
Erros comuns
"Funcionava e parou"
Quase sempre algo mudou no destino: o endereço, o token ou um certificado vencido. Rode Realizar teste e compare com a configuração do seu sistema.
"Selecione um webhook para testar"
O botão Realizar teste exige um webhook escolhido no filtro Selecionar webhook.
"Recebo o evento, mas faltam dados"
Abra a lista Campos disponíveis, no formulário do webhook, e compare com o que o seu sistema espera. Cada evento tem a sua lista de campos.
"Não vejo o item Webhooks"
Ele fica em Configuração, na plataforma, e em Configurações, na loja. Dentro de um produto não há tela de webhooks.
"Preciso do conteúdo de um envio específico"
O admin não guarda isso em tela. Fale com o suporte e informe o nome do webhook, o evento e a data e a hora aproximada.