Os webhooks permitem que a Uappi envie notificações automaticamente para um sistema externo sempre que um evento ocorre na plataforma, como a criação de um pedido, alteração de um produto ou atualização de um cliente.
Neste artigo você aprenderá como verificar se um webhook está configurado corretamente e como validar se ele está funcionando.
Um webhook é um mecanismo que permite à Uappi comunicar automaticamente eventos da loja para outro sistema, como um ERP, middleware ou integrador.
Em vez de consultar constantemente a API para verificar se houve alterações, o sistema externo recebe uma notificação sempre que um evento configurado acontece.
Exemplo: quando um novo pedido é criado, a Uappi envia automaticamente uma requisição para a URL cadastrada no webhook.
Importante: um webhook é considerado entregue com sucesso quando o endpoint retorna o código HTTP 200 (OK).
Antes de realizar qualquer teste, confirme se a configuração do webhook está correta.
Acesse:
Configurações > Integrações > API
Selecione o domínio desejado (Pedidos, Produtos, Clientes, Recuperação de Vendas, entre outros) e verifique:
Atenção: se alguma dessas configurações estiver incorreta, o webhook poderá não ser disparado mesmo sem apresentar erros.
Para que o webhook seja enviado, é necessário provocar um evento correspondente ao domínio configurado.
Veja alguns exemplos:
| Domínio | Evento para teste |
| Pedido | Criar um pedido ou alterar o status de um pedido |
| Produto | Alterar preço, estoque ou status de um produto |
| Cliente | Criar ou atualizar um cliente |
| Recuperação de Vendas | Gerar um carrinho abandonado |
| Avise-me | Simular um produto voltando ao estoque |
Observação: o envio das notificações ocorre conforme a frequência configurada na loja. Por isso, o disparo pode levar alguns minutos.
Na configuração do webhook, clique em:
Visualizar últimas notificações enviadas
Verifique:
| Resultado | Significado |
| HTTP 200 | O webhook foi entregue com sucesso. |
| HTTP 400, 401, 404, 500… | A Uappi enviou a requisição, mas o sistema receptor retornou erro. |
| Nenhuma notificação | O evento não foi gerado, foi bloqueado por filtros ou ainda aguarda processamento. |
Além da confirmação no painel da Uappi, é importante verificar se o sistema que recebe o webhook processou corretamente a requisição.
Confirme se:
A validação completa só acontece quando o webhook é entregue com sucesso e o sistema receptor processa a informação corretamente.
A entrega é considerada bem-sucedida quando o endpoint responde com o código HTTP 200 (OK).
Caso a URL responda com erro em tentativas consecutivas (até 10 falhas), o webhook poderá ser desativado automaticamente para evitar novas tentativas de envio para um endpoint indisponível.
Após corrigir o problema, será necessário reativar o webhook no painel.
Verifique:
Quando o histórico apresenta códigos diferentes de HTTP 200, recomenda-se:
Esse comportamento normalmente ocorre após sucessivas falhas de entrega.
Para resolver:
Nesse cenário, a entrega ocorreu corretamente.
O problema provavelmente está no processamento realizado pelo sistema receptor.
Verifique:
Caso sua equipe técnica queira validar apenas o endpoint antes de utilizar a Uappi, é possível realizar um teste simples utilizando o comando abaixo:
curl -X POST “https://sua-url-de-webhook” \
-H “Content-Type: application/json” \
-d “{\”teste\”:true}” \
-w “\nHTTP:%{http_code}\n”
Se a resposta não for HTTP 200, recomenda-se corrigir o endpoint antes de realizar novos testes na plataforma.
Considere o webhook validado quando todos os critérios abaixo forem atendidos:
Se o webhook continuar sem funcionar após seguir este procedimento, abra um chamado informando:
Essas informações ajudam nossa equipe de suporte a identificar a causa do problema com mais rapidez.
Nem sempre. O envio respeita a frequência configurada na loja, portanto pode levar alguns minutos até que a notificação seja enviada.
Significa que o endpoint recebeu a requisição e respondeu com sucesso. Para a Uappi, esse é o indicativo de que o webhook foi entregue corretamente.
Na maioria dos casos, não. O código HTTP 500 indica que o servidor que recebeu a requisição encontrou um erro durante o processamento.
Isso normalmente indica que a entrega foi realizada com sucesso, mas houve algum problema no processamento interno do ERP ou middleware. Nesse caso, é necessário verificar os logs do sistema receptor.
Isso pode acontecer quando o endpoint retorna falhas consecutivas (até 10 tentativas). Corrija o problema na URL, reative o webhook no painel e realize um novo teste.
Não. A URL do webhook deve ser pública e acessível pela internet para que a Uappi consiga enviar as notificações.
Os webhooks são enviados utilizando o método POST.
Sim. O conteúdo da requisição é enviado no formato JSON, devendo ser interpretado pelo sistema receptor.
Uma boa forma de identificar é verificar o histórico de notificações:
Leave a Reply