Entrega e retries
Como o HSDesk entrega os webhooks, a política de retentativas e o log de entregas para depurar.
As entregas são assíncronas: o HSDesk enfileira cada webhook e um worker dedicado faz o
POST assinado para a sua URL.
Responda rápido com 2xx
Seu endpoint deve responder 2xx rapidamente (idealmente: enfileire internamente e
processe depois). Qualquer resposta não-2xx ou timeout é tratada como falha.
Timeout de entrega
Cada tentativa tem timeout de 10 segundos (padrão). Não faça trabalho pesado de forma síncrona dentro do handler do webhook.
Retentativas
Falhas (timeout, 4xx ou 5xx) são reprocessadas com backoff:
- Até 3 tentativas no total.
- Backoff entre tentativas: 10s → 30s.
Como o X-HSDesk-Delivery é o mesmo UUID em todas as tentativas da mesma entrega, use-o
para deduplicar e evitar processar o evento duas vezes.
Log de entregas
Você acompanha as tentativas pelo painel (em Ver entregas) ou pela API de gestão:
GET /api/webhooks/{id}/entregas
Retorna as últimas entregas com evento, resultado (sucesso/falha), status HTTP, número da tentativa e data, útil para depurar endpoints que estão falhando.