Ricevere e gestire webhook in modo affidabile

In cosa consiste il problema

Un webhook è una chiamata che un servizio esterno fa al tuo server quando succede qualcosa: un pagamento riuscito, un ordine creato, una trattativa chiusa. Riceverlo è semplice; gestirlo in modo affidabile richiede qualche accorgimento.

Bisogna verificare che la chiamata sia autentica, rispondere rapidamente, elaborare l'evento in background ed evitare duplicati se il servizio lo reinvia.

Cause frequenti

• Eventi persi: errori temporanei che fanno perdere notifiche.
• Duplicati: lo stesso evento elaborato due volte.
• Sicurezza: endpoint che accettano chiamate non verificate.

Come si risolve

• Verifica firma: solo eventi autentici vengono accettati.
• Coda di elaborazione: risposta immediata, lavoro in background con ritentativi.
• Idempotenza: ogni evento elaborato una sola volta.

Un esempio tipico

Quando serve uno sviluppatore

Quando i webhook attivano pagamenti, ordini o servizi: un errore di gestione ha effetti economici diretti.

Tecnologie coinvolte

• Node.js
• PHP
• REST API
• Webhook

Quanto tempo può richiedere e quanto può costare

Indicativamente 3–8 ore di lavoro tecnico, per una fascia di 150–450 €.

Le variabili che incidono di più:

• numero di eventi da gestire
• azioni da eseguire per ogni evento
• requisiti di sicurezza
• infrastruttura disponibile

Le fasce di prezzo e di tempo indicate sono orientative e dipendono da complessità, qualità del codice esistente, accessi disponibili, documentazione e requisiti effettivi. Non costituiscono preventivo.

Informazioni da preparare

• Documentazione webhook del servizio
• Azioni da eseguire per ogni evento
• Server dove ospitare l'endpoint