Creazione di webhook

I webhook sono uno strumento per recuperare e archiviare i dati di un determinato evento. Ti consentono di registrare un URL https:// in cui archiviare i dati dell'evento in formato JSON o XML. I webhook sono comunemente utilizzati per i seguenti motivi:

• Emissione di un ordine
• Modifica del prezzo di un prodotto
• Invio di una notifica al client di messaggistica istantanea o al cercapersone quando sei offline
• Raccolta di dati per il data warehousing
• Integrazione del software di contabilità
• Filtraggio degli articoli dell'ordine e notifica ai vari corrieri in merito all'ordine
• Rimozione dei dati dei clienti dal database quando disinstallano l'app

Nota

Ricevi un'email all'indirizzo email del proprietario del negozio quando un webhook non funziona. L'email viene inviata solo se il webhook è stato creato da un'app dallo Shopify App Store o da un'app personalizzata. Se la destinazione del webhook restituisce ripetutamente una risposta di stato diversa da 200, la sottoscrizione webhook viene eliminata automaticamente dal pannello di controllo Shopify.

Suggerimento

Per la risoluzione avanzata dei problemi relativi ai webhook, gli sviluppatori possono consultare la guida Risoluzione dei problemi dei webhook nella documentazione per gli sviluppatori.

Eventi webhook supportati

Quando crei un webhook, puoi selezionare uno qualsiasi degli eventi elencati. Ad esempio, se desideri creare un webhook da inviare ogni volta che un ordine viene pagato, seleziona Pagamento ordine. Oppure, se desideri creare un webhook da inviare ogni volta che una proprietà del negozio viene aggiornata, seleziona Aggiornamento negozio.

Tabella che elenca gli eventi webhook supportati disponibili nel pannello di controllo Shopify.

Categoria	Eventi
Carrello	Creazione carrello Aggiornamento carrello
Check-out	Creazione check-out Eliminazione check-out Aggiornamento check-out
Collezione	Creazione collezione Eliminazione collezione Aggiornamento collezione
Cliente	Aggiornamento consenso SMS marketing del cliente Aggiornamento impostazioni account cliente Creazione cliente Eliminazione cliente Disabilitazione cliente Aggiornamento consenso email marketing del cliente Abilitazione cliente Creazione gruppo di clienti Eliminazione gruppo di clienti Aggiornamento gruppo di clienti Tag cliente aggiunti Tag cliente rimossi Aggiornamento cliente
Sconto	Creazione sconto Eliminazione sconto Aggiornamento sconto
Bozza di ordine	Creazione bozza di ordine Eliminazione bozza di ordine Aggiornamento bozza di ordine
Evasione	Creazione evasione Impossibilità di completare l'ordine di evasione da parte del servizio logistico Voci dell'ordine di evasione preparate per il ritiro Ordine di evasione spostato Ordine di evasione messo in sospeso Ordine di evasione riprogrammato Scadenza dell'ordine di evasione programmato Completamento dello smistamento dell'ordine di evasione Ordini di evasione annullati Richiesta di annullamento degli ordini di evasione accettata Richiesta di annullamento degli ordini di evasione rifiutata Richiesta di annullamento degli ordini di evasione inviata Richiesta di evasione degli ordini di evasione accettata Richiesta di evasione degli ordini di evasione rifiutata Richiesta di evasione degli ordini di evasione inviata Sospensione degli ordini di evasione rimossa Voci degli ordini di evasione preparate per la consegna locale Ordini di evasione uniti Ordini di evasione divisi Aggiornamento evasione
Scorte	Creazione voce di inventario Eliminazione voce di inventario Aggiornamento voce di inventario Collegamento livello delle scorte Scollegamento livello delle scorte Aggiornamento livello delle scorte
Sede	Attivazione sede Creazione sede Disattivazione sede Eliminazione sede Aggiornamento articolo della sede
Mercato	Creazione mercato Eliminazione mercato Aggiornamento mercato
Ordine	Annullamento ordine Creazione ordine Eliminazione ordine Modifica ordine Evasione ordine Pagamento ordine Modifica valutazione del rischio dell'ordine Aggiornamento ordine
Prodotto	Creazione prodotto Eliminazione prodotto Aggiornamento prodotto
Rimborso	Creazione rimborso
Shop	Aggiornamento Shop
Pagamento	Creazione transazione di pagamento
Tema	Creazione tema Eliminazione tema Pubblicazione tema Aggiornamento tema
Transazione	Creazione transazione

Suggerimento

Gli sviluppatori possono fare riferimento all'elenco completo degli argomenti dei webhook durante la creazione di sottoscrizioni webhook.

Creazione di webhook

Puoi creare un webhook in qualsiasi momento. I webhook sono firmati con un ID composto da una combinazione di lettere e numeri, univoco per il negozio.

Passaggi:

Desktop

1. Dal pannello di controllo Shopify vai a Impostazioni > Notifiche.

2. Clicca su Webhook.

3. Clicca su ⊕ Crea webhook.

4. Nel menu a discesa Evento, seleziona uno degli eventi webhook supportati da utilizzare come evento webhook. Non potrai modificare l'evento webhook dopo la creazione del webhook.

5. Nel menu a discesa Formato, scegli il formato in cui desideri che Shopify ti invii queste informazioni. Le due opzioni sono JSON o XML.

6. Nel campo URL, inserisci l'URL in cui desideri archiviare i dati. I webhook non possono essere inviati ai seguenti URL:

   • Localhost
   • Qualsiasi URL che termina con la parola «internal» (ad esempio example.com/internal)
   • Qualsiasi URL da un dominio personalizzato collegato al negozio
   • Domini «fittizi» (ad esempio www.example.com)
   • Domini Shopify (ad esempio shopify.com e myshopify.com)

7. In Versione API webhook, seleziona la versione del webhook che preferisci.

8. Clicca su Salva.

Dispositivo mobile

1. Dall'app Shopify, tocca , quindi tocca Impostazioni.

2. Nella sezione Impostazioni negozio, tocca Notifiche.

3. Tocca Webhook.

4. Tocca ⊕ Crea webhook.

5. Nel menu a discesa Evento, seleziona uno degli eventi webhook supportati da utilizzare come evento webhook. Non potrai modificare l'evento webhook dopo la creazione del webhook.

6. Nel menu a discesa Formato, scegli il formato in cui desideri che Shopify ti invii queste informazioni. Le due opzioni sono JSON o XML.

7. Nel campo URL, inserisci l'URL in cui desideri archiviare i dati. I webhook non possono essere inviati ai seguenti URL:

   • Localhost
   • Qualsiasi URL che termina con la parola «internal» (ad esempio example.com/internal)
   • Qualsiasi URL da un dominio personalizzato collegato al negozio
   • Domini «fittizi» (ad esempio www.example.com)
   • Domini Shopify (ad esempio shopify.com e myshopify.com)

8. In Versione API webhook, seleziona la versione del webhook che preferisci.

9. Tocca Salva o ✓.

Una volta salvato, il nuovo webhook viene visualizzato nella pagina Webhook.

Modifica di webhook

Puoi modificare la configurazione di un webhook dopo la sua creazione. Tuttavia, non puoi modificare l'evento webhook selezionato.

Passaggi:

Desktop

1. Dal pannello di controllo Shopify vai a Impostazioni > Notifiche.

2. Clicca su Webhook.

3. Nella riga contenente il webhook che desideri modificare, clicca su ... > Modifica.

4. Nella finestra di dialogo Modifica webhook, modifica il webhook come richiesto.

5. Clicca su Salva.

Dispositivo mobile

1. Dall'app Shopify, tocca , quindi tocca Impostazioni.

2. Nella sezione Impostazioni negozio, tocca Notifiche.

3. Tocca Webhook.

4. Nella riga contenente il webhook che desideri modificare, tocca ... > Modifica.

5. Nella finestra di dialogo Modifica webhook, modifica il webhook come richiesto.

6. Tocca Salva o ✓.

Test dei webhook

Puoi testare il webhook per assicurarti che le informazioni sull'evento desiderate vengano inviate all'URL corretto.

Passaggi:

Desktop

1. Dal pannello di controllo Shopify vai a Impostazioni > Notifiche.

2. Clicca su Webhook.

3. Nella riga contenente il webhook che desideri testare, clicca su ... > Invia test.

4. All'URL specificato per il webhook, verifica che la notifica funzioni.

Dispositivo mobile

1. Dall'app Shopify, tocca , quindi tocca Impostazioni.

2. Nella sezione Impostazioni negozio, tocca Notifiche.

3. Tocca Webhook.

4. Nella riga contenente il webhook che desideri testare, tocca ... > Invia test.

5. All'URL specificato per il webhook, verifica che la notifica funzioni.

Eliminazione di webhook

Puoi eliminare un webhook dal pannello di controllo Shopify. Questa azione non può essere annullata.

Nota

Se la destinazione del webhook restituisce ripetutamente una risposta di stato diversa da 200, la sottoscrizione webhook viene eliminata automaticamente dal pannello di controllo Shopify.

Passaggi:

Desktop

1. Dal pannello di controllo Shopify vai a Impostazioni > Notifiche.

2. Clicca su Webhook.

3. Nella riga contenente il webhook che desideri eliminare, clicca su ... > Elimina.

Dispositivo mobile

1. Dall'app Shopify, tocca , quindi tocca Impostazioni.

2. Nella sezione Impostazioni negozio, tocca Notifiche.

3. Tocca Webhook.

4. Nella riga contenente il webhook che desideri eliminare, tocca ... > Elimina.