Creazione di webhook

I webhook sono uno strumento per il recupero e l’archiviazione di dati da uno specifico evento. Ti consentono di registrare un URL https:// in cui i dati degli eventi possono essere archiviati nei formati JSON o XML. I webhook sono generalmente usati per:

• Effettuare un ordine
• Modificare il prezzo di un prodotto
• Comunicare al tuo client IM o al tuo cercapersone quando sei offline
• Raccogliere dati per il loro immagazzinamento
• Integrare il tuo software di contabilità
• Filtrare gli articoli degli ordini e informare i vari mittenti sull'ordine
• Rimuovere i dati del cliente dal tuo database quando disinstallano la tua app

Nota

In caso di errore di un webhook, riceverai un messaggio all'indirizzo email del proprietario del negozio. Il messaggio email viene inviato solo quando il webhook è stato creato da un'app dell'App Store di Shopify o da un'app personalizzata. Se la destinazione del webhook restituisce ripetutamente una risposta con stato diverso da 200, la sottoscrizione webhook verrà eliminata automaticamente dal pannello di controllo Shopify.

Crea webhook

Passaggi:

Desktop

1. Dal tuo pannello di controllo Shopify, vai su Impostazioni > Notifiche.
2. Scorri verso il basso fino alla sezione Webhook.
3. Fai clic sul pulsante Crea webhook. Dovrebbe apparire una nuova finestra.

4. Dal primo menu a discesa, seleziona l'"Evento" dal seguente elenco:

   • Creazione carrello: verrà inviato un webhook ogni volta che viene creato un carrello.
   • Aggiornamento carrello: verrà inviato un webhook ogni volta che un carrello viene aggiornato.
   • Creazione check-out: verrà inviato un webhook ogni volta che viene creato un check-out.
   • Eliminazione check-out: verrà inviato un webhook ogni volta che viene eliminato un check-out.
   • Aggiornamento check-out: verrà inviato un webhook ogni volta che viene aggiornato un check-out.
   • Creazione collezione: verrà inviato un webhook ogni volta che viene creata una collezione.
   • Eliminazione collezione: verrà inviato un webhook ogni volta che viene eliminata una collezione.
   • Aggiornamento collezione: verrà inviato un webhook ogni volta che viene aggiornata una collezione.
   • Creazione gruppo di clienti: verrà inviato un webhook ogni volta che viene creato un gruppo di clienti.
   • Eliminazione gruppo di clienti: verrà inviato un webhook ogni volta che viene eliminato un gruppo di clienti.
   • Aggiornamento gruppo di clienti: verrà inviato un webhook ogni volta che viene aggiornato un gruppo di clienti.
   • Creazione cliente: verrà inviato un webhook ogni volta che viene creato un nuovo cliente.
   • Eliminazione cliente: verrà inviato un webhook ogni volta che viene eliminato un record cliente.
   • Disattivazione cliente: verrà inviato un webhook ogni volta che viene disattivato un account cliente.
   • Attivazione cliente: verrà inviato un webhook ogni volta che viene attivato un account cliente.
   • Aggiornamento cliente: verrà inviato un webhook ogni volta che viene aggiornato un record cliente.
   • Creazione bozza di ordine: verrà inviato un webhook ogni volta che viene creata una bozza di ordine.
   • Eliminazione bozza di ordine: verrà inviato un webhook ogni volta che viene eliminato una bozza di ordine.
   • Aggiornamento bozza di ordine: verrà inviato un webhook ogni volta che viene aggiornata una bozza di ordine.
   • Creazione evasione: verrà inviato un webhook ogni volta che viene creata un'evasione di un ordine.
   • Aggiornamento evasione: verrà inviato un webhook ogni volta che viene aggiornata un'evasione di un ordine.
   • Annullamento ordine: verrà inviato un webhook ogni volta che viene annullato un ordine.
   • Creazione ordine: verrà inviato un webhook ogni volta che viene creato un ordine.
   • Eliminazione ordine: verrà inviato un webhook ogni volta che viene eliminato un ordine.
   • Modifica ordine: verrà inviato un webhook ogni volta che viene modificato un ordine.
   • Evasione ordine: verrà inviato un webhook ogni volta che viene evaso un ordine.
   • Pagamento ordine: verrà inviato un webhook ogni volta che viene pagato un ordine.
   • Aggiornamento ordine: verrà inviato un webhook ogni volta che viene aggiornato un ordine.
   • Creazione prodotto: verrà inviato un webhook ogni volta che viene creato un prodotto.
   • Eliminazione prodotto: verrà inviato un webhook ogni volta che viene eliminato un prodotto.
   • Aggiornamento prodotto: verrà inviato un webhook ogni volta che viene aggiornato un prodotto.
   • Creazione rimborso: verrà inviato un webhook ogni volta che viene emesso un rimborso.
   • Aggiornamento negozio: verrà inviato un webhook ogni volta che viene aggiornata una proprietà negozio.
   • Creazione tema: verrà inviato un webhook ogni volta che viene creato un tema.
   • Eliminazione tema: verrà inviato un webhook ogni volta che viene eliminato un tema.
   • Aggiornamento tema: verrà inviato un webhook ogni volta che viene aggiornata una proprietà tema.

5. Dal secondo menu a discesa, scegli il formato in cui desideri che Shopify ti invii queste informazioni. Le possibilità sono due: JSON o XML.

6. In URL, inserisci l'URL dove desideri che i dati vengano memorizzati. È importante osservare che i webhook non possono essere rimandati ai seguenti URL:

   • Localhost
   • Qualsiasi URL che finisca con la parola "internal" (ad esempio thisshop.com/internal)
   • URL provenienti da qualsiasi dominio personalizzato collegato al negozio
   • "Falsi" domini come www.example.com
   • Domini Shopify (ad esempio shopify.com e myshopify.com)

7. Fai clic su Aggiungi webhook. Il tuo webhook adesso dovrebbe apparire nella sezione "Webhook".

8. Hai anche la possibilità di provare il tuo webhook, per assicurarti che le informazioni che desideri vengano inviate all'URL corretto. Per fare ciò clicca sul link invia notifica di prova. Controlla all'URL che hai specificato se funziona.

Elimina webhook

Passaggi:

Desktop

1. Dal tuo pannello di controllo Shopify, vai su Impostazioni > Notifiche.
2. Scorri verso il basso fino alla sezione Webhook.
3. Accanto al webhook che hai creato, dovrebbe esserci una piccola icona del cestino.
4. Fai clic sull'icona del cestino per eliminare il webhook.

Nota

Se la destinazione del webhook restituisce ripetutamente una risposta con stato diverso da 200, la sottoscrizione webhook verrà eliminata automaticamente dal pannello di controllo Shopify.