Webhook

Cos’è un Webhook?

Webhook (anche HTTP callback o reverse API) è un meccanismo in cui un sistema invia autonomamente una richiesta HTTP POST a un URL precedentemente specificato quando si verifica un evento definito — una nuova fattura, un cambio di stato dell’ordine, l’arrivo di un pagamento. È l’opposto della classica chiamata API, in cui il client interroga il server (“hai qualcosa di nuovo?”). Il webhook è push, la classica query API è pull.

Vantaggi dei webhook:

• Real-time — l’evento viene consegnato immediatamente, senza polling periodico
• Efficienza — non appesantiscono entrambi i sistemi con chiamate vuote
• Semplicità — la configurazione richiede solitamente solo un URL + token di autenticazione

Problemi tipici da considerare nell’implementazione di un webhook:

• Autenticazione — aggiungere una firma HMAC o un token per verificare il mittente
• Logica di retry — se il sistema di destinazione risponde con un errore (5xx), riprovare con backoff esponenziale
• Idempotenza — il sistema di destinazione deve sapere che può ricevere lo stesso evento due volte
• Ordine di consegna — i webhook potrebbero non arrivare in ordine

Nell’ecosistema SaaS europeo i webhook sono uno standard — Stripe, Shopify, Mailchimp, Fatture in Cloud e molte altre integrazioni utilizzano il modello webhook.

Quando si utilizza

I webhook sono adatti per:

• Sincronizzazione tra sistemi (ERP ↔ e-commerce)
• Avvio di automazioni workflow su un evento
• Notifiche ai canali di comunicazione (Slack, Teams)
• Dashboard in tempo reale

Vedi la pagina API, il modulo Flussi di lavoro e le integrazioni.

Termini correlati

• API — il classico modello request/response. Vedi /it/glossario/api.
• Workflow automation — i webhook sono un tipico trigger. Vedi /it/glossario/workflow-automation.
• MCP — protocollo alternativo per gli assistenti AI. Vedi /it/glossario/mcp.

In Modulario

Modulario espone webhook configurabili per ogni evento chiave — creazione di una fattura, chiusura di un deal, cambio di stato di un ordine. Il retry automatico con firma garantisce una consegna affidabile. Esempi e schemi su /api.

Modulario fornisce una webhook management UI, dove l’amministratore vede tutte le registrazioni attive, i log delle ultime 1.000 chiamate (inclusi payload e risposta) e può avviare un “replay” per la consegna degli eventi dopo un’interruzione del sistema di destinazione.