# Che cos'è un webhook?

> Un webhook è un messaggio HTTP che un sistema invia quando succede qualcosa. Come funzionano i webhook, come vengono protetti e come collegano la rilevazione ore.

URL: https://timetracking.tech/it/glossario/webhook
Language: it
Last updated: 2026-10-24

**Definizione:** Un webhook è una richiesta HTTP automatica che un sistema invia a un URL di un altro sistema non appena si verifica un evento specifico, come l'approvazione di un foglio ore. Il sistema ricevente può agire subito, senza interrogazioni periodiche.

## Come funzionano i webhook

Si registra un URL e si scelgono gli eventi di interesse. Quando si verifica uno di questi eventi, il sistema mittente invia a quell'URL un piccolo messaggio JSON che descrive cosa è successo. Se il destinatario non è raggiungibile, un buon mittente riprova più tardi.

Poiché chiunque potrebbe inviare dati a un URL pubblico, i webhook sono firmati. Il mittente calcola una firma HMAC sul messaggio con un segreto condiviso; il destinatario la ricalcola e si fida solo dei messaggi in cui le firme coincidono.

## I webhook in TimeTracking

TimeTracking invia webhook quando le ore cambiano stato, firmati con HMAC e ritentati in caso di errore. Si possono usare per aggiornare un CRM, avviare una fatturazione o pubblicare un messaggio in un canale di chat. L'API REST, con specifica OpenAPI, copre la direzione opposta: leggere e scrivere dati su richiesta.

- [API e integrazioni](https://timetracking.tech/it/funzionalita/api-e-integrazioni)
- [MCP](https://timetracking.tech/it/glossario/mcp)
- [Audit trail](https://timetracking.tech/it/glossario/audit-trail)