---
title: "Webhook"
description: "Ricevi una notifica appena un job finisce e verifica che i webhook siano autentici."
url: https://help.samsa.ai/it/articles/142-webhook
collection: "API & MCP"
updated: 2026-07-07
language: it
alternates: [en, de, fr]
---

# Webhook

Ricevi una notifica appena un job finisce e verifica che i webhook siano autentici.

## Webhook

I job di immagini e video vengono eseguiti in background. Invece di controllare di continuo se un job è finito, puoi far sì che Samsa **avvisi la tua app nel momento in cui finisce**. È a questo che servono i webhook.

### Come funziona

Quando avvii una generazione tramite l'API, puoi includere un **URL webhook** — un indirizzo nella tua app. Non appena il job finisce, Samsa invia un messaggio a quell'indirizzo con il risultato, così la tua app può reagire subito. Come includere esattamente l'URL webhook è spiegato nella [guida ai webhook](https://docs.samsa.ai/guides/webhooks) della documentazione per sviluppatori (si apre in una nuova scheda).

### Verificare che un messaggio arrivi davvero da Samsa

Perché tu possa fidarti delle notifiche, Samsa **firma** ogni webhook e ti fornisce un **secret di firma webhook** per verificare quella firma.

Per trovare il tuo secret:

1.  Apri **Impostazioni organizzazione** > **Chiavi API**.
    
2.  Individua il **secret di firma webhook** e scegli **Mostra** (o **Copia**).
    

Tieni questo secret privato, proprio come una chiave API. La tua app lo usa per confermare che ogni messaggio in arrivo è autentico — la verifica passo passo è nella [guida ai webhook](https://docs.samsa.ai/guides/webhooks) (si apre in una nuova scheda).

### Buono a sapersi

-   I webhook sono **facoltativi** — puoi sempre controllare tu stesso lo stato di un job.
    
-   Se pensi che il tuo secret di firma sia stato esposto, trattalo come una chiave: rigeneralo e aggiorna la tua app.
