🕵️Debugging

Para garantir que as entregas aos endpoints webhook sejam consideradas bem-sucedidas pela Hubla, é importante que sua aplicação responda com um código HTTP 200, 201 ou 202. Caso o sistema não responda com um código de status HTTP na faixa 2xx citados anteriormente, serão feitas tentativas adicionais para entregar o webhook.

A Hubla realizará retentativas a cada minuto, até um total de cinco vezes. Por exemplo:

  • Segunda tentativa: Um minuto após a primeira

  • Terceira tentativa: Dois minutos após a segunda

  • Quarta tentativa: Três minutos após a terceira

  • Quinta tentativa: Quatro minutos após a quarta

Caso seu endpoint continue retornando códigos de erro por vários dias consecutivos, você será notificado por e-mail pela equipe da Hubla sobre a desativação automática da regra do webhook.


Corrigir códigos de status HTTP

Quando um evento exibe um código de status 200, isso indica uma entrega bem-sucedida ao endpoint do webhook. Você também pode receber um código de status diferente de 200. Veja na tabela abaixo uma lista de códigos de status HTTP comuns e as ações sugeridas.

Status
Descrição
Ação sugerida

ERRO (Não foi possível conectar)

Não conseguimos estabelecer uma conexão com o servidor de destino.

Verifique se o domínio do host pode ser acessado pelo público da internet.

(302 ou outro status 3xx)

O servidor de destino tentou redirecionar a solicitação para outro local. Consideramos as respostas de redirecionamento a solicitações de webhook como falhas.

Defina o destino do endpoint do webhook como o URL resolvido pelo redirecionamento.

(400 ou outro status 4xx)

O servidor de destino não pode ou não quer processar a solicitação. Isso pode ocorrer quando o servidor detecta um erro (400), o URL de destino tem restrições de acesso (401, 403) ou o URL de destino não existe (404).

  • Verifique se o endpoint pode ser acessado pelo público da internet.

  • Verifique se o endpoint aceita um método POST HTTP.

(500 ou outro status 5xx)

O servidor de destino encontrou um erro ao processar a solicitação.

Revise os logs do aplicativo para entender por que ele está retornando um erro 500.


Atualizado

Isto foi útil?