> For the complete documentation index, see [llms.txt](https://docs.opencityitalia.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencityitalia.it/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/le-funzioni-generali-delladmin/configurare-i-webhook.md).

# Configurare i Webhook

{% hint style="warning" %}
Verifica che il sistema esterno possa ricevere correttamente i dati all'indirizzo indicato.
{% endhint %}

Un **webhook** invia automaticamente dati e aggiornamenti dalla piattaforma a un sistema esterno. Puoi usarlo per integrare altri applicativi e mantenere le informazioni aggiornate in tempo reale. Dopo la configurazione, l'invio avviene senza esportazioni manuali.

## Accedere alla sezione Webhook

Per accedere alla configurazione dei webhook, clicca su Impostazioni e poi sulla voce Webhook

<figure><img src="/files/sgk09djhTK71FK8z0DrE" alt=""><figcaption></figcaption></figure>

Apri la sezione **Webhook** per visualizzare le configurazioni esistenti. Da qui puoi anche crearne una nuova.

<figure><img src="/files/XIemFvnv3K8CyOG419UV" alt=""><figcaption></figcaption></figure>

L'elenco mostra tutti i webhook già configurati.

## Creare un webhook

Per creare un webhook, clicca su **Crea webhook**.

<figure><img src="/files/H41Nz7iskYldRyro8LvU" alt=""><figcaption></figcaption></figure>

### Compilare i dati

{% hint style="info" %}
Usa un nome chiaro. Sarà più semplice trovare il webhook quando dovrai modificarlo.
{% endhint %}

Compila i campi richiesti dal sistema esterno che riceverà i dati. In genere devi indicare:

* Nome (obbligatorio): un nome che permetta di riconoscere facilmente il webhook;

<figure><img src="/files/rqqVmvnPnTMuHeRlOR3r" alt=""><figcaption></figcaption></figure>

* Endpoint (obbligatorio): l'URL di destinazione a cui la piattaforma invia i dati;

<figure><img src="/files/M2pOBeBPfx7zCVMYmdZ5" alt=""><figcaption></figcaption></figure>

* Method (obbligatorio): il metodo HTTP con cui inviare la richiesta (es. POST);

<figure><img src="/files/5SNjLIyIGBHUeZxHy97w" alt=""><figcaption></figcaption></figure>

* Attivatore (obbligatorio): l'evento che scatena l'invio del webhook. Puoi scegliere Tutti oppure un evento specifico tra: Pratica pagata, Pratica inviata, Pratica acquisita, Pratica protocollata, Pratica presa in carico, Richiesta integrazioni, In attesa di integrazioni, Integrazioni concluse, Pratica protocollata dopo integrazioni, Pratica approvata, Pratica rifiutata, Pratica ritirata, Pratica annullata, Messaggio creato, Modulo operatore aggiornato;

<figure><img src="/files/gB6esTnJEYJkUPi4QfbC" alt=""><figcaption></figcaption></figure>

* Servizi abilitati: seleziona i servizi per cui il webhook deve attivarsi. Puoi aggiungere i servizi uno alla volta, usare Aggiungi tutti per includerli tutti oppure Rimuovi tutti per svuotare la selezione;

<figure><img src="/files/7Jpc2gRy8khBuuFddPSM" alt=""><figcaption></figcaption></figure>

* Headers (json): eventuali header HTTP da inviare con la richiesta, in formato JSON (ad esempio l'header di autenticazione Authorization richiesto dal sistema esterno);

<figure><img src="/files/oKdl85OAoVbQAUbVGMS0" alt=""><figcaption></figcaption></figure>

* Versione (obbligatorio): la versione del formato dei dati inviati (1.0 oppure 2.0).
* Attivo: spunta questa casella per rendere operativo il webhook. Se deselezionata, il webhook resta configurato ma non invia dati.
* Test (facoltativo): prima di salvare puoi inserire l'Id di una pratica e usare il pulsante Test per verificare che l'invio verso l'endpoint funzioni correttamente.

<figure><img src="/files/QPgqN5uHgTOEDc0j5dJF" alt=""><figcaption></figcaption></figure>

### Salvare il webhook

Al termine della configurazione, clicca su **Salva**.

<figure><img src="/files/XGTsJ6fgLEDubTVZmkzQ" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Prima di salvare, verifica che l'endpoint esterno sia corretto e raggiungibile. Se l'indirizzo non è valido, idati non vengono inviati.
{% endhint %}

## Caso d'uso: popolamento automatico della mappa delle segnalazioni

{% hint style="info" %}
Per attivare questo caso d'uso, l'Ente deve disporre di:

* il sito fornito da OpenCity;
* il [servizio Helpdesk di Segnalazione disservizio](https://docs.google.com/presentation/d/1u0bwR3RGbU56A2Pd2k0Bxidf04U-Q6s4XUgc0tT6YdY/edit?usp=sharing).
  {% endhint %}

Un caso d'uso dei webhook è l'aggiornamento automatico del dataset della mappa pubblica delle segnalazioni. È disponibile nel servizio di Segnalazione disservizi.

Quando l'operatore rende pubblica una segnalazione, l'evento attiva il webhook. Il webhook invia al sito dell'Ente i dati georeferenziati e anonimizzati. Il sito riceve i dati e aggiorna la mappa senza interventi manuali.

I cittadini possono così consultare le segnalazioni pubblicate sul territorio. L'Ente offre informazioni aggiornate e rende più trasparenti i disservizi segnalati.

<figure><img src="/files/Q3X4VxuuzzMs1dqqYjU5" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.opencityitalia.it/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/le-funzioni-generali-delladmin/configurare-i-webhook.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.