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
IntegrationPages.On every delivery, read the timestamp (t) and signature (v1) from the signature header, then compute the HMAC-SHA256 of the string "{timestamp}_{raw request body}" with your signing secret and compare it to the v1 value_ Reject any request that does not match, or whose timestamp is more than 5 minutes old, so you only act on fresh payloads that truly came from Mercateer_ (Our SDK’s verify helper does all of this for you_)
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