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 vengono generalmente utilizzati per i seguenti motivi:

• 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.

Eventi webhook supportati

Quando crei un webhook, puoi selezionare uno degli eventi elencati. Ad esempio, se desideri creare un webhook che viene inviato ogni volta che viene pagato un ordine, seleziona Pagamento dell'ordine. Per fare un altro esempio, se vuoi creare un webhook da inviare ad ogni aggiornamento di una proprietà negozio, seleziona Aggiornamento negozio.

Tabella in cui sono elencati gli eventi di webhook supportati disponibili nel pannello di controllo Shopify.

Categoria	Eventi
Carrello	Creazione carrello Aggiornamento del carrello
Check-out	Creazione check-out Eliminazione check-out Aggiornamento check-out
Collezione	Creazione collezione Cancellazione collezione Aggiornamento collezione
Cliente	Aggiornamento del consenso agli SMS di marketing del cliente Aggiornamento impostazioni account cliente Creazione cliente Cancellazione cliente Disattivazione cliente Aggiornamento del consenso alle email di marketing del cliente Attivazione cliente Creazione gruppi clienti Cancellazione gruppo clienti Aggiornamento gruppo clienti Tag cliente aggiunti Tag cliente rimossi Aggiornamento cliente
Sconto	Creazione dello sconto Eliminazione dello sconto Aggiornamento dello sconto
Bozza di ordine	Creazione bozza di ordine Cancellazione bozza di ordine Aggiornamento bozza di ordine
Evasione	Creazione evasione L'ordine di evasione non può essere completato dal servizio logistico Le voci dell'ordine di evasione sono pronte per il ritiro Ordine di evasione spostato Evasione dell'ordine sospesa Ordine di evasione riprogrammato L'ordine di evasione programmato è in scadenza Smistamento degli ordini dell'ordine di evasione completato Ordini di evasione annullati Richiesta di annullamento degli ordini di evasione accettata Richiesta di annullamento degli ordini di evasione rifiutata Annullamento richiesta ordini di evasione inviata Richiesta di evasione ordini accettata Richiesta di evasione ordini rifiutata Richiesta di evasione ordini inviata Sospensione ordini di evasione annullata Voci dell'ordine di evasione pronte per la consegna locale Ordini di evasione uniti Suddivisione ordini di evasione Aggiornamento evasione
Scorte	Creazione voce di inventario Eliminazione voce di inventario Aggiornamento voce di inventario Connessione livello scorte Disconnessione livello scorte Aggiornamento livello scorte
Località	Attivazione sede Creazione della posizione Disattivazione sede Cancellazione della posizione Aggiornamento della posizione
Promuovi	Creazione mercato Eliminazione mercato Aggiornamento mercato
Ordine	Annullamento ordine Creazione ordini Cancellazione ordine Modifica ordine Evasione degli ordini Pagamento dell'ordine Valutazione del rischio dell'ordine modificata Aggiornamento ordine
Prodotto	Creazione prodotto Cancellazione prodotto Aggiornamento prodotto
Rimborso	Rimborso emesso
Shop	Aggiornamento negozio
Transazione di pagamento	Creazione transazione di pagamento
Tema	Creazione tema Cancellazione tema Pubblicazione tema Aggiornamento tema
Transazione	Creazione transazione

Suggerimento

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

Crea webhook

Puoi creare un webhook in qualsiasi momento. I tuoi webhook sono contrassegnati con un ID composto da una combinazione di lettere e numeri univoci per il tuo negozio.

Passaggi:

Desktop

1. Dal pannello di controllo Shopify, vai su Impostazioni > Notifiche.

2. Clicca su Webhook.

3. Clicca su ⊕ Crea webhook.

4. Nel menu a discesa Evento seleziona uno degli eventi webhook supportati che desideri utilizzare come evento webhook. Non puoi modificare l'evento webhook dopo la creazione.

5. Nel menu a discesa Formato, seleziona 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. Non è possibile rimandare i webhook ai seguenti URL:

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

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

8. Clicca su Salva.

iPhone

1. Nell'app di Shopify tocca il pulsante …, 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 che desideri utilizzare come evento webhook. Non puoi modificare l'evento webhook dopo la creazione.
6. Nel menu a discesa Formato, seleziona 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. Non è possibile rimandare i webhook ai seguenti URL:

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

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

9. Tocca Salva.

Android

1. Nell'app di Shopify, tocca il pulsante ☰, 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 che desideri utilizzare come evento webhook. Non puoi modificare l'evento webhook dopo la creazione.
6. Nel menu a discesa Formato, seleziona 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. Non è possibile rimandare i webhook ai seguenti URL:

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

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

9. Tocca ✓.

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

Modifica webhook

Puoi modificare la configurazione di un webhook dopo che è stato creato. Tuttavia, non puoi modificare l'evento webhook selezionato.

Passaggi:

Desktop

1. Dal pannello di controllo Shopify, vai su 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, cambia il webhook secondo le istruzioni.

5. Clicca su Salva.

iPhone

1. Nell'app di Shopify tocca il pulsante …, 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, cambia il webhook secondo le istruzioni.
6. Tocca Salva.

Android

1. Nell'app di Shopify, tocca il pulsante ☰, 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, cambia il webhook secondo le istruzioni.
6. Tocca ✓.

Test dei webhook

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

Passaggi:

Desktop

1. Dal pannello di controllo Shopify, vai su Impostazioni > Notifiche.

2. Clicca su Webhook.

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

4. Verifica che la notifica sia funzionante all'URL specificato per il webhook.

iPhone

1. Nell'app di Shopify tocca il pulsante …, quindi tocca Impostazioni.
2. Nella sezione Impostazioni negozio tocca Notifiche.
3. Tocca Webhook.
4. Nella riga contenente il webhook che desideri modificare, tocca ... > Invia test.
5. Verifica che la notifica sia funzionante all'URL specificato per il webhook.

Android

1. Nell'app di Shopify, tocca il pulsante ☰, quindi tocca Impostazioni.
2. Nella sezione Impostazioni negozio tocca Notifiche.
3. Tocca Webhook.
4. Nella riga contenente il webhook che desideri modificare, tocca ... > Invia test.
5. Verifica che la notifica sia funzionante all'URL specificato per il webhook.

Elimina webhook

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

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.

Passaggi:

Desktop

1. Dal pannello di controllo Shopify, vai su Impostazioni > Notifiche.

2. Clicca su Webhook.

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

iPhone

1. Nell'app di Shopify tocca il pulsante …, quindi tocca Impostazioni.
2. Nella sezione Impostazioni negozio tocca Notifiche.
3. Tocca Webhook.
4. Nella riga contenente il webhook che desideri eliminare, tocca ... > Elimina.

Android

1. Nell'app di Shopify, tocca il pulsante ☰, quindi tocca Impostazioni.
2. Nella sezione Impostazioni negozio tocca Notifiche.
3. Tocca Webhook.
4. Nella riga contenente il webhook che desideri eliminare, tocca ... > Elimina.