# Invia eventi ai tuoi sistemi con i webhook

> Un webhook avvisa il tuo sistema nel momento in cui succede qualcosa nel negozio, come un nuovo ordine o una variazione delle scorte. Aggiungi l’URL di un endpoint in Impostazioni > Webhook, scegli gli eventi, invia una prova e vedi ogni consegna con la sua risposta.

Centro assistenza / Integrazioni - Aggiornato il 2 novembre 2026

Un webhook invia un messaggio a un indirizzo web che scegli tu, nel momento in cui succede qualcosa nel negozio. Per esempio, un nuovo ordine può andare direttamente al tuo sistema di evasione, una variazione delle scorte al tuo foglio di magazzino o un nuovo cliente al tuo CRM. I tuoi sistemi non devono continuare a chiedere a Shoprocket se ci sono novità.

Ti serve un posto dove arrivino i messaggi: un indirizzo sul tuo server, o uno strumento che te ne dia uno, come una piattaforma di automazione. Configurare la parte che li riceve è di solito compito di uno sviluppatore.

## Prima di cominciare

- I webhook sono disponibili dal piano **Growth** in su. Con un piano inferiore, la schermata indica quale piano li include.
- Fanno parte dell’app **Strumenti per sviluppatori**, insieme alle **Chiavi API**. Se non vedi **Webhook** sotto **Impostazioni** nella barra laterale, vai su **App**, trova **Strumenti per sviluppatori** sotto **Sviluppatori** e fai clic su **Aggiungi**. Vedi [Aggiungere e rimuovere app](https://shoprocket.io/it/aiuto/aggiungere-e-rimuovere-app.md).

## Aggiungere un endpoint

1. Nella dashboard, vai su **Impostazioni > Webhook** e fai clic su **Aggiungi endpoint**.
2. Inserisci un **Nome**. Chiamalo come il sistema a cui invia, così sai cosa smette di funzionare se lo rimuovi.
3. Inserisci l’**URL dell’endpoint**. Deve iniziare con `https://`.
4. Lascia **Endpoint in modalità di prova** disattivato per l’endpoint della tua attività reale. Attivalo per un endpoint che deve ricevere solo ordini di prova.
5. Scegli gli eventi da inviare. Seleziona gli eventi uno per uno, usa **Seleziona tutto** per un gruppo, o **Iscriviti a tutti gli eventi**. È meglio scegliere solo gli eventi che il tuo sistema usa. Fai clic su **Esempio** accanto a un evento per vedere il messaggio che invia.
6. Fai clic su **Aggiungi endpoint**.

![Il pannello per aggiungere un endpoint webhook: il nome Evasione, un URL https, Endpoint in modalità di prova disattivato e order.created selezionato con il suo payload di esempio aperto](https://shoprocket.io/img/help/webhooks/add-endpoint.webp)

## Gli eventi

| Gruppo | Eventi |
|---|---|
| **Ordini** | Creato, aggiornato, pagato, rimborsato, evaso, parzialmente evaso, eliminato |
| **Clienti** | Creato, aggiornato, eliminato |
| **Prodotti** | Creato, aggiornato, eliminato |
| **Inventario** | Scorte aggiornate |
| **Sconti** | Creato, aggiornato, eliminato |
| **Categorie** | Creata, aggiornata, eliminata |
| **Abbonamenti** | Creato, rinnovato, rinnovo non riuscito, in pausa, ripreso, annullato, scaduto |
| **Chiavi di licenza** | Assegnata, sospesa, ripristinata, scaduta, revocata |

## Inviare una prova

Fai clic su **Invia prova** su un endpoint. Shoprocket invia subito un evento di prova e ti dice se l’endpoint l’ha accettato e cosa ha risposto il tuo server, per esempio "Risposta 200 in 140 ms.", o che non è stato proprio raggiungibile.

## Vedere cosa è stato inviato

La scheda **Consegne recenti**, sotto gli endpoint, elenca ogni evento che Shoprocket ha provato a inviare: quando, il codice di risposta del tuo server e quanti tentativi sono serviti. Una consegna è **Consegnata**, **In coda**, **Nuovo tentativo** o **Non riuscito**. Dopo aver risolto un problema dalla tua parte, fai clic su **Reinvia** su qualsiasi consegna per inviarla di nuovo.

![Le consegne recenti di un endpoint: eventi consegnati con HTTP 200, uno in Nuovo tentativo con HTTP 500 e il pulsante Reinvia](https://shoprocket.io/img/help/webhooks/recent-deliveries.webp)

## Quando le consegne non riescono

Il tuo server deve rispondere a ogni messaggio con un qualsiasi codice di risposta 2xx. Se non lo fa, Shoprocket continua a provare per circa un giorno.

Se le consegne a un endpoint falliscono 20 volte di fila, l’endpoint viene disattivato e ne indica il motivo. Correggi l’endpoint, poi fai clic su **Riattiva ora**. Viene poi inviato tutto ciò che è rimasto in coda nel frattempo. Prima che un endpoint venga disattivato, ti avvisa man mano che gli errori si accumulano, per esempio "3 consegne non sono riuscite di fila. Dopo 20 disattiviamo automaticamente questo endpoint."

## Modificare o eliminare un endpoint

Fai clic sul pulsante di modifica di un endpoint per cambiarne nome, indirizzo o eventi, poi su **Salva**. Per smettere definitivamente di inviargli messaggi, fai clic su **Elimina** e conferma.

## Per gli sviluppatori

Ogni messaggio è firmato con il segreto di firma dell’endpoint, così il tuo server può verificare che arrivi davvero da Shoprocket. Fai clic su **Mostra segreto di firma** sull’endpoint per copiarlo. Ogni messaggio include anche il nome dell’evento e un ID di consegna, così il tuo server può ignorare le ripetizioni. La guida per sviluppatori contiene la verifica della firma, il payload di ogni evento e i dettagli dei nuovi tentativi. Vedi [Webhook](https://shoprocket.io/docs/webhooks.md).

## Articoli correlati

- [Creare una chiave API](https://shoprocket.io/it/aiuto/creare-una-chiave-api.md)
- [Zapier](https://shoprocket.io/it/aiuto/zapier.md)
- [Modalità di prova e modalità reale](https://shoprocket.io/it/aiuto/modalita-di-prova-e-pagamenti-reali.md)

[Apri Webhook nella dashboard](https://app.shoprocket.io/go/settings/webhooks)

---

- HTML version: https://shoprocket.io/it/aiuto/invia-eventi-con-i-webhook
- Language: Italiano (it)
- Also in: [العربية](https://shoprocket.io/ar/help/webhooks.md), [Deutsch](https://shoprocket.io/de/hilfe/ereignisse-mit-webhooks-senden.md), [Ελληνικά](https://shoprocket.io/el/help/webhooks.md), [English](https://shoprocket.io/help/webhooks.md), [Español](https://shoprocket.io/es/ayuda/envia-eventos-con-webhooks.md), [Français](https://shoprocket.io/fr/aide/envoyer-des-evenements-avec-les-webhooks.md), [עברית](https://shoprocket.io/he/help/webhooks.md), [हिन्दी](https://shoprocket.io/hi/help/webhooks.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/webhook.md), [日本語](https://shoprocket.io/ja/help/webhooks.md), [Lietuvių](https://shoprocket.io/lt/pagalba/webhookai.md), [Norsk](https://shoprocket.io/nb/hjelp/webhooks.md), [Nederlands](https://shoprocket.io/nl/hulp/webhooks.md), [Polski](https://shoprocket.io/pl/pomoc/webhooki.md), [Português](https://shoprocket.io/pt/ajuda/envie-eventos-com-webhooks.md), [Română](https://shoprocket.io/ro/ajutor/webhooks.md), [Русский](https://shoprocket.io/ru/help/webhooks.md), [ไทย](https://shoprocket.io/th/help/webhooks.md), [Türkçe](https://shoprocket.io/tr/yardim/webhooklar.md), [中文](https://shoprocket.io/zh/help/webhooks.md)
