Vai al contenuto
memberarea memberarea.io

Leggere il registro dei webhook di Shopify

Legga ogni consegna inviata dal suo negozio, capisca che cosa ne ha fatto la sua area membri ed esegua di nuovo una consegna non riuscita.

In questo articolo

Quando nel suo negozio succede qualcosa, Shopify invia un messaggio al riguardo alla sua area membri. Ognuno di questi messaggi è una consegna, e ogni consegna viene registrata con il suo risultato, che abbia funzionato o no. Il registro dei webhook è il posto in cui guardare quando un acquirente dice che gli manca il corso, o quando vuole sapere che cosa ha fatto davvero un rimborso o una modifica a un prodotto.

Aprire il registro

Apra la sua pagina Shopify in /admin/settings/integrations/shopify, oppure apra Impostazioni, poi Integrazioni, poi Aggiungi integrazione e Shopify. Poi scelga la scheda Registro dei webhook. Il registro resta consultabile mentre il negozio è disconnesso, quindi può ancora rivedere che cosa era arrivato prima.

Finché non arriva la prima consegna, la scheda indica "Nessun webhook ricevuto finora. Effettua un ordine di prova nel tuo negozio per verificare la connessione." Un ordine di prova è il modo più rapido per vedere la prima riga.

Che cosa mostra una riga

L'elenco non ha intestazioni di colonna. Ogni consegna è una riga:

Dove Che cosa mostra
Riga superiore L'argomento, che nomina ciò che è successo nel negozio.
Riga sottostante Una breve nota su ciò che la sua area membri ha fatto con la consegna. Se non è riuscita, lì compare invece l'errore.
Sotto la nota La data e l'ora in cui la consegna è stata ricevuta.
Badge a destra Il risultato: Elaborato, Ignorato, Non ancora elaborato, Nuovo tentativo o Non riuscita.
Pulsante accanto Rielabora, solo nelle righe che si possono eseguire di nuovo.
Il Registro dei webhook elenca consegne con i risultati Elaborato, Ignorato, Nuovo tentativo e Non riuscita, ciascuna con la sua nota e il suo orario.
Il Registro dei webhook elenca consegne con i risultati Elaborato, Ignorato, Nuovo tentativo e Non riuscita, ciascuna con la sua nota e il suo orario.

Clicchi su una riga per aprirne i dettagli. Elencano ciò che la consegna conteneva tra Numero d'ordine, Indirizzo email, Totale, Valuta e ID Shopify, sempre il numero di Tentativi, e l'errore completo se ce n'era uno. Clicchi di nuovo sulla riga per chiuderla.

Gli argomenti che vedrà sono orders/paid, orders/cancelled, refunds/create, customers/create, customers/update, customers/delete, products/update, products/delete e app/uninstalled. Anche i tre argomenti sulla privacy di Shopify, customers/data_request, customers/redact e shop/redact, arrivano qui.

I cinque risultati

Elaborato significa che la sua area membri ha fatto il lavoro. Per un ordine pagato la nota è simile a "Order SHP-1042 imported, 1 mapped item(s)." e l'acquirente ha l'accesso associato. Anche un ordine pagato per un prodotto che nessuno ha associato viene elaborato: la nota indica "Order SHP-1042 imported, no mapped item." L'ordine esiste, conta nel suo fatturato, e l'acquirente diventa un membro senza alcun accesso. Questo vale anche per i beni fisici che vende accanto ai suoi corsi.

Ignorato significa che la consegna è stata compresa e non c'era nulla da fare. La nota spiega il motivo, per esempio "This product is not mapped." per la modifica di un prodotto a cui non punta alcuna associazione, oppure "This update is the echo of our own push." dopo che lei stessa ha inviato un prodotto a Shopify.

Non ancora elaborato significa che la consegna è arrivata e attende il suo turno. Una riga non dovrebbe restare così per più di qualche secondo. Se molte righe restano su Non ancora elaborato, qualcosa da parte nostra si è bloccato. Scriva a support@memberarea.io.

Nuovo tentativo significa che la consegna non è riuscita e sta per essere ritentata da sola. La riga della nota riporta l'errore dell'ultimo tentativo.

Non riuscita significa che qualcosa è andato storto e i tentativi automatici sono esauriti. La riga della nota riporta l'errore, e la riga offre Rielabora.

Le consegne non riuscite vengono ritentate da sole

Una consegna che non riesce viene ritentata automaticamente alcune volte, con una pausa tra un tentativo e l'altro. Finché questi tentativi sono in corso, la riga mostra Nuovo tentativo, e Tentativi nei dettagli aumenta a ogni tentativo. Solo quando anche l'ultimo tentativo non riesce, la riga passa a Non riuscita. Una riga su Non riuscita richiede il suo intervento: risolva la causa, poi la esegua di nuovo. Il registro dei webhook nell'app dentro il suo admin Shopify mostra gli stessi stati, in inglese: "Retrying" finché i tentativi non sono esauriti e "Failed" dopo.

Eseguire di nuovo una consegna

Clicchi su Rielabora nella riga. Il pulsante c'è solo per una consegna che non è riuscita, è in attesa di un nuovo tentativo o non è ancora stata elaborata. Una riga che conta come elaborata o ignorata non ne ha. La riga torna su Non ancora elaborato e viene poi elaborata con i dati che Shopify aveva inviato in origine, quindi eseguirla di nuovo dopo aver risolto la causa fa tutto il lavoro, non una versione ridotta.

Una consegna di rimborso non riuscita ed espansa mostra il suo errore, il numero di tentativi e il pulsante Rielabora.
Una consegna di rimborso non riuscita ed espansa mostra il suo errore, il numero di tentativi e il pulsante Rielabora.
Nota

Nulla viene eseguito due volte. Se Shopify invia di nuovo la stessa consegna, questa non riceve una seconda riga. Un ordine pagato che arriva due volte diventa comunque un solo ordine e sblocca l'accesso una volta, e un rimborso che arriva due volte viene registrato una volta. Cliccare su Rielabora non raddoppia mai un ordine, un accesso o un rimborso.

Filtrare e sfogliare il registro

I pulsanti sopra l'elenco lo restringono a Elaborato, Ignorato o Non riuscita, e Tutti riporta tutto. Non riuscita elenca solo le consegne i cui tentativi automatici sono esauriti. Le righe su Non ancora elaborato e Nuovo tentativo compaiono solo sotto Tutti. Aggiorna ricarica la pagina in cui si trova, così può vedere arrivare una nuova consegna.

In una pagina stanno venticinque consegne, le più recenti per prime. Le consegne più vecchie sono nelle pagine successive, che raggiunge sotto l'elenco.

Quando un cliente segnala un corso mancante, filtri prima per Non riuscita, poi per Ignorato, poi guardi la sua riga orders/paid sotto Elaborato. Tra questi tre troverà quasi sempre la risposta.

Le note che vedrà davvero

Nota Che cosa significa e che cosa fare
"Order SHP-1042 imported, no mapped item." L'ordine c'è, ma il suo prodotto non sblocca nulla. Associ il prodotto in modo che i prossimi acquirenti ricevano l'accesso, veda Associare un prodotto Shopify a un corso.
"This product is not mapped." Nel negozio è cambiato un prodotto a cui non punta alcuna associazione. Non c'è nulla da fare, a meno che non volesse associarlo.
"This update is the echo of our own push." Shopify ha riportato una modifica fatta dalla sua area membri. Non c'è nulla da fare.
"This delivery carried no order id or the order was already imported." O la consegna non conteneva un id ordine, o l'ordine è già qui. Non c'è nulla da fare.
"Refund recorded, the refunded items were not mapped." Il rimborso è registrato, ma riguardava prodotti mai associati, quindi non c'era alcun accesso da revocare.
"The order for this refund has not been imported yet, trying again shortly." Il rimborso è arrivato prima del suo ordine. Viene ritentato da solo, e nel frattempo la riga mostra Nuovo tentativo. Se finisce su Non riuscita, clicchi su Rielabora quando la riga dell'ordine mostra Elaborato.

Che cosa fanno rimborsi e annullamenti all'accesso, all'ordine e alle provvigioni è spiegato in Rimborsi e annullamenti in Shopify.

Solo consegne autentiche da Shopify

Ogni consegna deve portare una firma Shopify valida. Un messaggio senza firma viene respinto e non compare mai nel registro. Non viene accettata nemmeno una consegna che Shopify ha generato più di sette giorni prima. Se manca del tutto una riga che si aspetta, controlli che il negozio sia collegato, veda Collegare il suo negozio Shopify.

Richieste sulla privacy da Shopify

Shopify inoltra le richieste sulla privacy dei clienti del suo negozio, e ciascuna compare come una riga.

Quando un cliente chiede a Shopify di eliminare i suoi dati, arriva una consegna customers/redact. La sua area membri rimuove il collegamento a quel cliente Shopify e le consegne salvate che lo riguardano. Il membro, il contatto e i loro ordini restano: appartengono al suo spazio di lavoro, e il cliente potrebbe aver acquistato da lei anche altrove. La nota è simile a "Removed 1 link and 4 stored deliveries for Shopify customer 7012345678. The member itself belongs to the workspace and stays." Se vuole che la persona sparisca anche dalla sua area membri, elimini lei stessa il membro o il contatto.

Quando un cliente chiede i suoi dati, arriva una consegna customers/data_request e i proprietari del suo spazio di lavoro ricevono un'email e una notifica dal titolo "Un cliente Shopify ha richiesto i suoi dati". Shopify si aspetta la sua risposta entro 30 giorni, e la sua area membri non invia i dati al posto suo. Che cos'altro succede in materia di privacy e disinstallazione è spiegato in Scollegare Shopify ed eliminare i dati del negozio.

Che cosa viene conservato

Ogni consegna viene salvata con i dati che Shopify ha inviato, così eseguirla di nuovo fa tutto il lavoro. Quei dati riguardano i suoi clienti, quindi vengono salvati in forma cifrata. Le consegne vengono eliminate 90 giorni dopo il loro arrivo.

Articoli correlati

Last updated on October 25, 2026

Questo articolo le è stato utile?

Articoli correlati