Webhooks
Callbacks HTTP para o seu servidor quando o estado de uma entrega muda: nada de polling, dados em tempo real.
Pontos-chave
- Verifique sempre a assinatura HMAC dos pedidos recebidos: garante que o payload vem realmente do NotifyHub.
- Responda 2xx rapidamente e processe o payload de forma assíncrona: as respostas lentas são repetidas.
- Use o registo das entregas webhook para o debug: mostra payload, resposta do seu servidor e novas tentativas.
Para que serve esta página
Os Webhooks avisam o seu sistema quando algo acontece no NotifyHub, tipicamente as mudanças de estado das entregas (entregue, falhada...). Regista o URL do seu servidor e os eventos que lhe interessam: a cada evento o NotifyHub envia um pedido HTTP assinado com o payload completo.
Como se usa
A tabela lista os endpoints com URL, eventos subscritos, estado e último trigger. Pode ativar/desativar um endpoint com o toggle (útil durante a manutenção do seu servidor) ou eliminá-lo. Os pedidos são assinados com HMAC: o segredo para a verificação é-lhe fornecido na criação do endpoint.
Entregas e novas tentativas
Cada chamada ao seu endpoint é registada na página das entregas webhook, com payload enviado, código de resposta e número de tentativas: em caso de erro do seu servidor o NotifyHub tenta novamente de forma automática, e pode também relançar manualmente uma entrega falhada. Se o seu endpoint ficar em baixo por muito tempo, consulte o registo para recuperar os eventos perdidos.