Webhook
Callback HTTP verso il tuo server quando lo stato di una consegna cambia: niente polling, dati in tempo reale.
Punti chiave
- Verifica sempre la firma HMAC delle richieste in arrivo: garantisce che il payload arrivi davvero da NotifyHub.
- Rispondi 2xx velocemente e processa il payload in modo asincrono: le risposte lente vengono ritentate.
- Usa il registro delle consegne webhook per il debug: mostra payload, risposta del tuo server e ritenti.
A cosa serve questa pagina
I Webhook avvisano il tuo sistema quando succede qualcosa in NotifyHub, tipicamente i cambi di stato delle delivery (consegnata, fallita...). Registri l'URL del tuo server e gli eventi che ti interessano: a ogni evento NotifyHub invia una richiesta HTTP firmata con il payload completo.
Come si usa
La tabella elenca gli endpoint con URL, eventi sottoscritti, stato e ultimo trigger. Puoi attivare/disattivare un endpoint con il toggle (utile durante la manutenzione del tuo server) o eliminarlo. Le richieste sono firmate HMAC: il segreto per la verifica ti viene fornito alla creazione dell'endpoint.
Consegne e ritenti
Ogni chiamata al tuo endpoint è tracciata nella pagina delle consegne webhook, con payload inviato, codice di risposta e numero di tentativi: in caso di errore del tuo server NotifyHub ritenta automaticamente, e puoi anche rilanciare manualmente una consegna fallita. Se il tuo endpoint resta giù a lungo, controlla il registro per recuperare gli eventi persi.