Interrogazione periodica degli URL

Un webhook, di norma, attende che qualcuno lo chiami. Con una pianificazione, è l’app a effettuare la chiamata: recupera un URL da Lei specificato a intervalli regolari e invia la risposta allo stesso webhook, in modo che il Suo workflow Shopify Flow venga eseguito a intervalli prestabiliti da qualsiasi API che restituisca dati in formato JSON, dati di modulo o XML.

Usi tipici: recuperare i dati di magazzino di un fornitore ogni 15 minuti, verificare la presenza di nuovi ordini in un sistema ERP ogni ora oppure leggere un endpoint di stato una volta al giorno e lasciare che Shopify Flow agisca di conseguenza.

Come configurarne uno

Per creare un nuovo webhook, selezioni “Crea webhook” e risponda alla domanda “Cosa attiverà questo webhook?” con “Nulla - eseguirlo secondo una pianificazione”. Il webhook viene creato con un token segreto, in modo che nessun altro possa richiamarne l’URL, e si apre nella scheda "Pianificazione". Per un webhook già esistente, lo apra e passi alla scheda "Pianificazione". Quindi compili i campi:

Campo	Cosa fa
Attivato	Attiva la pianificazione. L'URL del webhook continua a funzionare in entrambi i casi.
URL	L'indirizzo da utilizzare. Esclusivamente `http` e `https`, che devono essere raggiungibili dalla rete Internet pubblica.
Intervallo	Ogni 5, 15 o 30 minuti, ogni 1, 3, 6 o 12 ore, oppure una volta al giorno.
Modalità	Ogni richiesta attiva Shopify Flow ad ogni esecuzione. Solo quando la risposta cambia, l’evento viene attivato solo se il corpo della risposta differisce rispetto all’esecuzione precedente.
Intestazioni della richiesta	Facoltativo, per una chiave API o un token bearer. Viene memorizzato in forma crittografata e non viene mai più visualizzato.

La prima esecuzione avviene entro un minuto dall’attivazione.

Nella pagina “Crea webhook”, in cui viene chiesto “Cosa attiverà questo webhook?”, è stata selezionata l’opzione “Niente - eseguirlo secondo una pianificazione” e viene indicato che la scheda “Pianificazione” si aprirà successivamente — Un nuovo webhook programmato: risponda "Niente - eseguirlo a intervalli regolari" e, dopo aver salvato, si aprirà la scheda "Pianificazione".

La scheda "Pianificazione" con un URL da recuperare, un intervallo di 6 ore e l'opzione "Solo quando la risposta cambia" selezionata — La scheda “Pianificazione”: l’URL da recuperare, la frequenza e se Shopify Flow venga eseguito ad ogni recupero o solo quando la risposta è cambiata.

Analisi della risposta

Il corpo recuperato viene elaborato dal webhook esattamente come una richiesta che Le è stata inviata: viene analizzato in base al tipo di contenuto, la mappatura dei campi seleziona i valori che Shopify Flow riceve e, se configurata, viene applicata la suddivisione in array.

Poiché l’API definisce autonomamente la struttura della propria risposta, le esecuzioni pianificate tralasciano il controllo dei «campi inattesi» che si applica ai dati JSON inviati dai vostri sistemi. È sufficiente mappare i valori che vi interessano.

Example responsejson

{
  "updated_at": "2026-09-17T08:00:00Z",
  "items": [
    { "sku": "ABC-1", "stock": 4 },
    { "sku": "ABC-2", "stock": 0 }
  ]
}

Assegnate updated_at a un campo Flow per utilizzarlo nel vostro workflow. Per gestire ogni elemento singolarmente, impostate il percorso di suddivisione su items in "Impostazioni avanzate": in questo modo, ogni elemento avvierà una propria esecuzione di Shopify Flow. Per ulteriori informazioni, consultate Formati del corpo e suddivisione degli array.

Eseguire ora

L'opzione "Esegui ora" avvia immediatamente un'esecuzione effettiva: recupera l'URL, mostra lo stato HTTP, l'anteprima della risposta e cosa è successo (attivazione, nessuna modifica o errore) e attiva Shopify Flow se la risposta è utilizzabile. La si consiglia di utilizzarla dopo aver modificato l'URL o le intestazioni, anziché attendere il prossimo intervallo.

Solo quando la risposta cambia

In questa modalità, l’app confronta il corpo del dato recuperato con quello precedente e attiva Shopify Flow solo in caso di discrepanza. Utilizzatela per gli endpoint che restituiscono lo stesso documento fino a quando non si verifica effettivamente una modifica, come ad esempio un feed relativo alle quotazioni di borsa o allo stato. Il confronto viene effettuato sull’intero corpo del dato; pertanto, un’API che includa un timestamp o un ID di richiesta in ogni risposta risulterà diversa ogni volta.

Quando una pianificazione non va a buon fine

Il blocco "Stato" nella scheda mostra l'ultima esecuzione, l'ultimo stato HTTP, la prossima esecuzione e l'ultimo errore.

Un errore di rete, uno stato diverso da 2xx o un corpo del messaggio che non può essere analizzato costituiscono un’esecuzione non riuscita e non attivano Shopify Flow.
Dopo 20 tentativi falliti consecutivi, la pianificazione si interrompe automaticamente e ne dà comunicazione, anziché continuare a richiamare all’infinito un URL non funzionante. Si prega di correggere l’URL o le credenziali e di riattivarla.
Il raggiungimento del limite previsto dal Suo piano non viene considerato un errore. Tali esecuzioni vengono bloccate e visualizzate nella dashboard.

Cosa l'app non scaricherà

Sono ammessi solo indirizzi pubblici. Gli indirizzi interni e privati (localhost, intervalli privati, endpoint dei metadati cloud) vengono rifiutati, anche qualora un reindirizzamento punti a uno di essi. Le risposte sono limitate a 1 MB e a 10 secondi, e vengono seguiti al massimo 3 reindirizzamenti. Le vostre intestazioni vengono ignorate se un reindirizzamento conduce a un sito diverso.

Dove compaiono le corse programmate

In History, con la sorgente “Scheduled”. Tutto il resto funziona come di consueto: il payload, il risultato del trigger Shopify Flow, i tentativi di ripetizione e il replay.