> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exoid.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurazione

> Attiva il webhook di una campagna, imposta URL e secret e consulta il log delle richieste inviate.

Ogni campagna ha il proprio webhook. Da qui attivi l'invio, indichi l'endpoint che riceverà le notifiche HTTP in tempo reale e controlli cosa è stato consegnato.

<Info>
  Il pannello si trova in **Impostazioni (toolbar laterale) → Webhook**.
</Info>

<Frame caption="Schermata di configurazione webhook">
  ![Schermata di configurazione webhook in Exoid](https://69247ac52a74519d4fe5e2eb.featurebase-attachments.com/c/article/6925ab07b65089fc8e52b6f7/019adfdc-37e5-77dc-9f98-59d7aa900b08/b64u-d2ViaG9vay5wbmc.png)
</Frame>

## Campi del pannello

<ParamField path="Abilita Webhook" type="interruttore">
  Attiva o disattiva l'invio automatico delle richieste HTTP per questa campagna.
</ParamField>

<ParamField path="URL Webhook" type="url" required>
  Indirizzo completo dell'endpoint che riceverà le richieste, ad esempio `https://tuodominio.com/webhook`.
</ParamField>

<ParamField path="Chiave Segreta Webhook" type="stringa">
  Il segreto usato per firmare digitalmente ogni payload con HMAC-SHA256. Vedi [Firma e sicurezza](/it/webhooks/sicurezza) per implementare la verifica.
</ParamField>

## Webhook Requests

Sotto ai campi trovi l'elenco cronologico di tutte le chiamate effettuate. Per ogni riga vedi:

| Colonna             | Contenuto                                       |
| ------------------- | ----------------------------------------------- |
| Timestamp           | Momento in cui la richiesta è stata inviata     |
| URL di destinazione | Endpoint contattato                             |
| Codice di stato     | Esito HTTP restituito, ad esempio `200` o `405` |
| Dettaglio           | Contenuto completo della richiesta effettuata   |

Anche le richieste fallite vengono registrate, con il codice di stato che le ha fatte fallire.

### Azioni rapide

| Azione       | Effetto                                         |
| ------------ | ----------------------------------------------- |
| Refresh      | Aggiorna l'elenco delle richieste               |
| Test Webhook | Invia una richiesta di prova al tuo endpoint    |
| Salva        | Applica le modifiche alla configurazione        |
| Annulla      | Chiude il pannello senza applicare le modifiche |

<Tip>
  Usa **Test Webhook** prima di pubblicare il tuo studio: ti conferma che l'endpoint risponde `200` e che la verifica della firma funziona, senza mettere a rischio risposte reali.
</Tip>

## Dettagli tecnici della richiesta

| Proprietà    | Valore                    |
| ------------ | ------------------------- |
| Metodo       | `POST`                    |
| Content-Type | `application/json`        |
| X-Signature  | `sha256=...` (firma HMAC) |
| User-Agent   | `Exoid-Webhook/1.0`       |
| Timeout      | 30 secondi                |

<Note>
  Se il tuo endpoint non risponde entro 30 secondi, la richiesta viene considerata fallita e rientra nella logica dei ritentativi. Rispondi `200` subito e processa il payload in modo asincrono.
</Note>

## Prossimi passi

<CardGroup cols={2}>
  <Card title="Firma e sicurezza" icon="shield" href="/it/webhooks/sicurezza">
    Ricalcola la firma HMAC-SHA256 e rifiuta le richieste non autentiche.
  </Card>

  <Card title="Struttura del payload" icon="file-json" href="/it/webhooks/payload">
    Cosa contiene il JSON che ricevi, campo per campo.
  </Card>
</CardGroup>


## Related topics

- [1 luglio 2026](/it/novita/2026-07-01.md)
- [Risoluzione dei problemi](/it/domande-frequenti.md)
- [Recluta partecipanti](/it/distribuzione/recruiting.md)