Ricevi gli eventi del front office di Mercateer tramite webhook
Sottoscrivi un endpoint agli eventi di Mercateer e ricevi un payload firmato non appena una chiamata termina, arriva un lead o viene prenotato un intervento. Registra e gestisci gli endpoint tramite API o dashboard, e verifica ogni consegna con HMAC.
Cos’è Webhooks?
I webhook inviano in tempo reale gli eventi del front office di Mercateer a un URL sotto il tuo controllo, così i tuoi sistemi possono reagire senza dover interrogare periodicamente l’API. Ogni consegna è un payload JSON firmato con HMAC; registri e gestisci gli endpoint tramite API o dashboard, e le consegne fallite vengono ritentate con backoff.
Cosa puoi fare con Webhooks
Installazione in pochi minuti
Crea un endpoint
Registra il tuo URL e seleziona gli eventi a cui sottoscriverti, tramite API o in Impostazioni > Sviluppatore. Mercateer restituisce un segreto di firma per quell’endpoint. L’accesso API è incluso nei piani Crew e Fleet.
Verifica la firma
A ogni consegna, leggi il timestamp (t) e la firma (v1) dall'header della firma, poi calcola l'HMAC-SHA256 della stringa "{timestamp}.{raw request body}" con il tuo segreto di firma e confrontalo con il valore v1. Rifiuta ogni richiesta che non corrisponde o il cui timestamp ha più di 5 minuti, così agisci solo su payload recenti e davvero provenienti da Mercateer. (L'helper verify del nostro SDK fa tutto questo al posto tuo.)
Gestisci i tentativi in modo idempotente
Rispondi rapidamente con un codice 2xx per confermare la consegna. Le consegne fallite vengono ritentate con backoff, quindi basa il tuo gestore sull’ID evento per ignorare i duplicati ed elaborare ogni evento una sola volta.
Domande frequenti
Funziona con tutto il tuo stack
Mercateer parla gli stessi protocolli degli strumenti che usi già.
Metti Mercateer al lavoro con Webhooks
Inizia gratis e collega il tuo front office in pochi minuti.
Nessuna carta di credito richiesta