Cosa sono i webhook e come configurarli in Sendcloud? – Sendcloud Help Center

Scopo: impara le basi dei webhook e come puoi configurarli nel tuo pannello Sendcloud.

Per utilizzare i webhook devi connetterti a Sendcloud tramite un'API. Per maggiori informazioni sulla connessione con la nostra API, ti invitiamo a consultare la nostra Documentazione API.

Per ulteriori informazioni sui webhook di Sendcloud, consulta la sezione Webhooks nella nostra documentazione API.

Cosa sono i webhook?

I webhook permettono alle applicazioni di comunicare tra loro in "tempo reale". Un altro modo in cui le applicazioni possono comunicare è tramite un'API. A differenza di un'API che funziona con il polling, un webhook riceve i dati non appena l'applicazione li gestisce. Non è necessario fare alcuna richiesta perché si tratta di un processo automatico. Pertanto non devi preoccuparti di un ritardo nella comunicazione.

API: un'API recupera periodicamente i dati dall'applicazione facendo una richiesta. Un'API esegue un'azione specifica solamente quando riceve una richiesta.

Webhook: un webhook non estrae i dati ma li riceve dall'applicazione non appena si verificano. Gli webhook invece eseguono azioni solo quando vengono soddisfatti determinati criteri.

Esempio: ricezione di aggiornamenti sul tracking da Sendcloud

(Vedi l'immagine qui sotto come riferimento)

Quando ricevi un aggiornamento sul tracking tramite l'API, la procedura è la seguente:
La tua applicazione cerca di prelevare i dati di tracking da Sendcloud a intervalli. Lo farà anche quando non sono disponibili nuovi dati.
Quando vuoi ricevere aggiornamenti sul tracking tramite un webhook, la procedura è la seguente:
Sendcloud invia gli aggiornamenti di tracking alla tua applicazione non appena sono disponibili in Sendcloud.

Webhook di Sendcloud

Webhook Integration Object: questo webhook entra in gioco quando una nuova integrazione API viene aggiunta a Sendcloud. Si attiva quando un'integrazione API viene collegata, cancellata o aggiornata. Clicca qui per vedere cosa contiene il payload di questo webhook.

Webhook Parcel Status Changed Object: questo webhook entra in gioco quando lo stato di un pacco cambia; non importa quale sia il cambiamento di stato. Clicca qui per vedere cosa c'è nel payload di questo webhook.

Webhook Refund Requested Object: questo webhook entra in gioco quando viene richiesto un rimborso. Clicca qui per vedere il payload di questo webhook.

Come impostare i webhook in Sendcloud?

Per fare in modo che Sendcloud comunichi attivamente gli aggiornamenti dei pacchi (ad esempio gli aggiornamenti del tracking), devi creare un endpoint API. Ogni volta che si verifica un aggiornamento, Sendcloud farà una richiesta attraverso quell'endpoint. Per maggiori informazioni, consulta la sezione Webhooks nella nostra documentazione API.

Copia l'url del webhook dalla tua applicazione
Vai nel tuo pannello Sendcloud e apri le impostazioni dell'integrazione andando su Impostazioni > Integrazioni > Configura
Seleziona la casella Feedback Webhook abilitato
Trova il campo Webhook url (vedi immagine sotto) e incollaci l'url del tuo webhook
Prova il tuo webhook cliccando sul pulsante Webhook API di prova
Clicca su Salva

Fatto! Il tuo webhook è ora configurato e il payload dovrebbe iniziare ad arrivare alla tua applicazione. Puoi usarlo per impostare dei trigger che portano a determinate azioni. Un esempio potrebbe essere quello di collegare le tue e-mail di tracking agli aggiornamenti di tracking in arrivo. In questo modo potrai fornire aggiornamenti istantanei ai tuoi clienti.

Per i resi, riceverai gli aggiornamenti via webhook solo se la spedizione in uscita è stata creata tramite l'integrazione API.

Clicca qui per andare alla nostra guida alle API di Sendcloud e vedere il payload del webhook.