Vai al contenuto
Ultimo aggiornamento

Webhook


Questa sezione è visibile solo se il feature flag OrganizationWebhook è abilitato per la propria organizzazione.

Panoramica

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:

EventoDescrizione
Pratica completataAttivato 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.


Elenco dei webhook

L'elenco mostra il webhook configurato con le seguenti colonne:

ColonnaDescrizione
EventoL'evento che attiva il webhook.
URLL'endpoint che riceve la notifica.
AzioniDettagli per visualizzare la configurazione del webhook, oppure l'icona del cestino per eliminarlo.

Se non è configurato alcun webhook, l'elenco mostra Nessun webhook presente.

No image

Creazione di un webhook

Fare clic su Nuovo webhook e compilare il modulo.

CampoObbligatorioDescrizione
EventoSìL'evento che attiva il webhook. È disponibile solo Pratica completata.
URLSìL'URL del proprio endpoint che riceve la notifica.
IntestazioniNoIntestazioni personalizzate inviate con ogni richiesta. Ogni intestazione è composta da un Nome e un Valore.
Certificato clientNoCertificato client (testo) utilizzato per autenticare NSE presso il proprio endpoint.
Chiave clientNoChiave privata (testo) corrispondente al certificato client.
No image

Intestazioni

Utilizzare le intestazioni per trasmettere informazioni statiche al proprio endpoint, ad esempio un token di autorizzazione.

  1. Fare clic su Aggiungi intestazione (+).
  2. Inserire il Nome e il Valore dell'intestazione.
  3. Ripetere per ogni intestazione aggiuntiva. Utilizzare l'azione di rimozione per eliminare un'intestazione.

Certificato client e chiave

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.


Visualizzazione ed eliminazione di un webhook

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.
No image