Questa sezione è visibile solo se il feature flag OrganizationWebhook è abilitato per la propria organizzazione.
Un webhook consente a NSE di notificare automaticamente un sistema esterno quando si verifica un evento nella propria organizzazione. Quando l'evento viene attivato, NSE invia una richiesta HTTP all'URL configurato, in modo che i propri sistemi possano reagire in tempo reale senza interrogare periodicamente l'API.
Attualmente è supportato il seguente evento:
| Evento | Descrizione |
|---|---|
| Pratica completata | Attivato quando una pratica è stata completata. |
È possibile configurare un solo webhook dell'organizzazione. Una volta creato un webhook, il pulsante Nuovo webhook viene disabilitato. Un webhook non può essere modificato: per cambiarne la configurazione, eliminarlo e crearne uno nuovo.
È inoltre possibile configurare i webhook tramite API (sia a livello di organizzazione sia a livello di pratica): Riferimento webhook.
Impostazioni dell'organizzazione → Webhook
L'accesso ai Webhook nelle Impostazioni dell'organizzazione è riservato agli amministratori dell'organizzazione.
L'elenco mostra il webhook configurato con le seguenti colonne:
| Colonna | Descrizione |
|---|---|
| Evento | L'evento che attiva il webhook. |
| URL | L'endpoint che riceve la notifica. |
| Azioni | Dettagli per visualizzare la configurazione del webhook, oppure l'icona del cestino per eliminarlo. |
Se non è configurato alcun webhook, l'elenco mostra Nessun webhook presente.

Fare clic su Nuovo webhook e compilare il modulo.
| Campo | Obbligatorio | Descrizione |
|---|---|---|
| Evento | Sì | L'evento che attiva il webhook. È disponibile solo Pratica completata. |
| URL | Sì | L'URL del proprio endpoint che riceve la notifica. |
| Intestazioni | No | Intestazioni personalizzate inviate con ogni richiesta. Ogni intestazione è composta da un Nome e un Valore. |
| Certificato client | No | Certificato client (testo) utilizzato per autenticare NSE presso il proprio endpoint. |
| Chiave client | No | Chiave privata (testo) corrispondente al certificato client. |

Utilizzare le intestazioni per trasmettere informazioni statiche al proprio endpoint, ad esempio un token di autorizzazione.
- Fare clic su Aggiungi intestazione (+).
- Inserire il Nome e il Valore dell'intestazione.
- Ripetere per ogni intestazione aggiuntiva. Utilizzare l'azione di rimozione per eliminare un'intestazione.
Se il proprio endpoint richiede TLS reciproco (mutual TLS), incollare il certificato client in Certificato client e la chiave privata corrispondente in Chiave client. Entrambi i campi sono facoltativi.
Fare clic su Salva per creare il webhook, oppure su Annulla per scartare le modifiche. Il pulsante Salva si abilita una volta compilati i campi obbligatori.
I webhook non possono essere modificati dopo la creazione.
- Dettagli — apre il webhook per visualizzarne la configurazione (evento, URL, intestazioni).
- Elimina (icona del cestino) — rimuove il webhook. Dopo l'eliminazione, Nuovo webhook torna disponibile, consentendo di creare un nuovo webhook con la configurazione aggiornata.
