Garu

2026-10-22

v0.35.0 — A Garu avisa por e-mail quando um webhook falha

webhooksnotificacoesbugfix

O que mudou

Um e-mail quando um webhook falha

Quando a 4ª tentativa de entregar um evento falha, a Garu manda um e-mail para o dono da loja e para os membros da equipe que podem editar webhooks. O e-mail mostra:

  • o endereço do endpoint;
  • a última resposta dele, explicada (por exemplo, HTTP 410: o endereço foi removido);
  • quantos eventos esperam nova tentativa, e quantos falharam de vez nas últimas 24 horas;
  • um link para a tela de eventos do endpoint, onde você reenvia o que falhou.

Enquanto o endpoint continuar falhando, a Garu manda no máximo um e-mail por dia para cada endpoint. A Garu não desativa o endpoint: você decide se corrige o endereço ou se desativa o endpoint.

Para não receber o aviso, desligue Webhook com falha em Configurações → Notificações. Quem desligou todas as notificações também não recebe.

As novas tentativas voltam a durar cerca de 26h36

A Garu tenta entregar cada evento 7 vezes: na hora, e de novo depois de 1 minuto, 5 minutos, 30 minutos, 2 horas, 8 horas e 16 horas. É o que a documentação sempre disse. Mas a Garu contava a primeira entrega como uma das novas tentativas, então a última, a de 16 horas, nunca acontecia. A Garu desistia de um evento cerca de 10h36 depois da primeira entrega.

Agora um sistema que fica fora do ar a noite toda ainda recebe todos os eventos. A tela de eventos mostra o contador de tentativas como X/7.

Desativar um endpoint não trava mais a fila

Quando você desativa um endpoint, os eventos dele que esperavam nova tentativa ficam guardados. Se você reativar o endpoint, a Garu volta a entregá-los. Antes, se um endpoint desativado tivesse 100 ou mais desses eventos, a fila de entrega podia parar para todas as lojas.

Precisa fazer alguma coisa?

Não. Se o seu endpoint tem eventos failed que você ainda precisa, reenvie pela tela de eventos do endpoint.