Una conferma di pagamento, un nuovo ordine, lo stato di una chiamata, una release — i webhook dei tuoi provider si raccolgono in un unico indirizzo. SendNomi verifica la firma e inoltra l’evento pulito al tuo endpoint; ciò che non viene consegnato entra in coda e torna con un clic. L’era degli handler webhook scritti a mano finisce oggi.
Crei un ricevitore nel pannello: scegli il tipo di sorgente e incolli lo shared secret del tuo provider. Inserisci l’indirizzo SendNomi generato per te nelle impostazioni webhook del provider e la connessione è fatta. Gli schemi di firma più comuni per pagamenti, code hosting, telefonia, e-commerce e CRM sono integrati; un servizio non in elenco si collega tramite una definizione HMAC personalizzata con il tuo secret e il nome dell’header.
HMAC-SHA256 HMAC-SHA256 HMAC (URL-aware) HMAC-SHA256 HMAC o OAuth bearer il tuo secret Ogni provider ha il proprio schema HMAC; SendNomi verifica la firma al posto tuo. Sono supportate le firme SHA-256 e SHA-1; il controllo timestamp + nonce impedisce che la stessa richiesta venga riprodotta. Una richiesta che non supera la verifica viene rifiutata con 401 e ogni evento — accettato o rifiutato — viene scritto nel log. Un payload prosegue solo quando la sua firma è valida.
# Invia un evento di prova firmato — osserva la verifica in tempo reale
curl -X POST https://app.sendnomi.com/api/webhooks/inbound/<account-id>/test \
-H "Content-Type: application/json" \
-H "X-Signature: sha256=<signature>" \
-d '{"event":"test","payload":{...}}'
# 200 OK → firma valida, evento accettato
# 401 → firma non valida o richiesta replay Gli header vengono normalizzati, il payload viene trasformato su richiesta e l’evento viene inoltrato al tuo endpoint URL. Se il tuo endpoint non può rispondere in quel momento, SendNomi riprova con 3 tentativi + backoff esponenziale e jitter; ogni tentativo è vincolato a un timeout di 30 secondi. Se lo stesso event ID arriva due volte, la finestra di dedup di 24 ore garantisce che venga elaborato una sola volta — il tuo cliente non vedrà mai un’email o un record duplicato.
Il feed eventi live elenca ogni webhook con il suo stato: accettato, rifiutato, consegnato, in nuovo tentativo. Con il test di consegna invii un evento di prova al tuo endpoint dal pannello e vedi la risposta in linea. Un evento che fallisce tutti i tentativi finisce nella coda dead-letter; una volta risolto il problema, lo reinvii con un clic. Nessun evento scompare in silenzio.
payment.checkout_completed 200 · consegnato order.created 200 · consegnato call.status_changed nuovo tentativo 2/3 release.published dead-letter Invia di nuovo unknown.source 401 · firma non valida Crea il tuo account gratuito — 500 invii al mese, per sempre.