Webhook
Un webhook è una chiamata HTTP automatica che invia dati a un altro sistema nel momento esatto in cui si verifica un evento specifico.
Cos’è un webhook?
Un webhook è un’importante chiamata HTTP automatizzata — di solito un POST — che un sistema invia a un URL concordato nel momento stesso in cui si verifica un evento specifico. Chi riceve non deve continuare a richiedere i dati; la fonte invia (pushes) le informazioni stessa ogni volta che accade qualcosa di nuovo. Questa è la differenza chiave tra un webhook e una REST API: un’API richiede di recuperare ripetutamente i dati (polling), mentre un webhook fornisce i dati da solo non appena l’evento si attiva.
Perché un webhook è importante?
In un negozio online accadono costantemente cose a cui altri sistemi devono reagire immediatamente: viene creato un ordine, un pagamento va a buon fine, le scorte cambiano. Con i webhook eviti di fare il polling di Shopify ogni minuto per accorgertene — l’evento attiva l’azione in tempo reale. Ciò rende le integrazioni con il tuo ERP, sistema di inventario, contabilità o e-mail transazionali più veloci e affidabili, e riduce le chiamate API e i ritardi non necessari.
Casi d’uso comuni
- Gestione degli ordini: invia nuovi ordini a un ERP o a un sistema di spedizione tramite
orders/create. - Inventario e prodotti: sincronizza le modifiche con
products/updateoinventory_levels/update. - Pulizia delle app: cancella i dati dei clienti quando un’app viene disinstallata tramite
app/uninstalled. - Notifiche: attiva un’e-mail, un messaggio Slack o una fattura al completamento di un pagamento.
Prospettiva di Shopify
In Shopify puoi creare webhook nell’amministrazione sotto Impostazioni → Notifiche o tramite l’Admin API da un’app. L’invio è un POST al tuo endpoint HTTPS — JSON per impostazione predefinita, anche se sono supportati anche XML e canali come EventBridge e Pub/Sub. Verifica sempre l’intestazione X-Shopify-Hmac-Sha256 con la chiave segreta della tua app in modo da sapere che la chiamata è arrivata realmente da Shopify. Il tuo endpoint deve rispondere rapidamente con uno stato 2xx (solitamente 200); altrimenti Shopify riproverà per un massimo di 48 ore e poi rimuoverà l’iscrizione.