Scopo: Scopri come abilitare il feedback del webhook in Sendcloud e configurarlo per le tue integrazioni personalizzate.
Cos'è il Feedback del Webhook?
Il feedback del webhook consente alla tua applicazione di ricevere aggiornamenti in tempo reale da Sendcloud ogni volta che si verifica un evento importante, come un cambiamento nello stato di una spedizione. Invece di dover inviare richieste manuali o periodiche, Sendcloud invia automaticamente questi aggiornamenti direttamente alla tua applicazione.
API vs. Webhook:
- API: La tua applicazione invia regolarmente richieste per ottenere dati, anche quando non ci sono nuovi aggiornamenti.
- Webhook: Sendcloud invia automaticamente i dati alla tua applicazione non appena si verifica un evento (ad esempio, un cambiamento nello stato di una spedizione).
Esempio: Aggiornamenti di tracciamento tramite Webhooks
- API: La tua applicazione invia richieste a intervalli regolari per ottenere i dati di tracciamento da Sendcloud, anche se non ci sono nuovi aggiornamenti.
- Webhook: Sendcloud invia immediatamente gli aggiornamenti di tracciamento alla tua applicazione quando sono disponibili nuove informazioni, permettendoti di fornire aggiornamenti in tempo reale ai tuoi clienti.
Se vuoi saperne di più, consulta il nostro articolo: Cosa sono i webhooks e come configurarli in Sendcloud?
Come configurare i Webhooks in Sendcloud
1. Crea un Endpoint API
Per ricevere aggiornamenti tramite webhook, hai bisogno di un endpoint API in grado di gestire le richieste in arrivo da Sendcloud.
2. Configura il feedback del Webhook in Sendcloud:
- Accedi al pannello di controllo di Sendcloud e vai su Impostazioni > Integrazioni > Configura.
- Spunta la casella per abilitare il Feedback del webhook.
3. Inserisci l'URL del Webhook:
- Copia l'URL del webhook dalla tua applicazione e incollalo nel campo URL del Webhook in Sendcloud.
4. Se presente, imposta una Webhook Signature Key:
Questa è una password utilizzata per firmare tutte le richieste di webhook inviate da Sendcloud. La chiave deve:
- Avere almeno 16 caratteri.
- Contenere almeno un numero, una lettera maiuscola, una lettera minuscola e un carattere speciale.
5. Testa il tuo Webhook:
Clicca sul pulsante Test API Webhook per verificare la configurazione. Se il webhook funziona correttamente, dovresti iniziare a ricevere i payload nella tua applicazione.
6. Salva:
Clicca su Salva per finalizzare la configurazione.
Webhook Events supportati da Sendcloud
Esistono due categorie di integrazioni supportate dai webhook di Sendcloud:
1. Per integrazioni API:
Sendcloud supporta i seguenti eventi webhook:
- Webhook Parcel Status Changed Event: Attivato ogni volta che cambia lo stato di una spedizione.
- Webhook Integration Event: Attivato quando una nuova integrazione API viene collegata, eliminata o aggiornata in Sendcloud.
- Webhook Refund Requested Event: Attivato quando viene richiesto un rimborso per una spedizione.
2. Per le seguenti integrazioni:
Sendcloud supporta solo il Webhook Parcel Status Changed Event, che invia aggiornamenti quando lo stato di una spedizione cambia:
- Amazon v2
- Bol
- CCVshop v2
- Ebay v2
- Epages
- Etsy v2
- Lightspeed v2
- Magento v2
- Mijnwebwinkel
- Prestashop
- Prestashop v2
- Shopify
- Shopify v2
- Woocommerce
- Woocommerce v2
Per queste integrazioni, Sendcloud invia automaticamente gli aggiornamenti sullo stato delle spedizioni direttamente alla tua applicazione, consentendo aggiornamenti automatici nella tua piattaforma e-commerce.
Test e Risoluzione dei Problemi
Una volta configurato il webhook, è importante testarlo cliccando sul pulsante Test API Webhook nel pannello di Sendcloud. Questo confermerà che la configurazione è corretta e che il tuo endpoint sta ricevendo correttamente gli aggiornamenti.