---
title: "Come ricevo un webhook quando un ciak è pronto?"
description: "Un produttore o un proprietario iscrive un URL tramite l'API. Le consegne sono firmate con x-fs-signature e ritentate quando il tuo server fallisce."
url: https://www.filmsquare.ai/help/it/connect/webhooks/
lang: it
section: connect
updated: 2026-11-13
---

Un webhook manda un evento al tuo URL quando un ciak finisce, un ciak viene scelto o arriva una nuova versione, così
non devi interrogare di continuo. I webhook si impostano tramite l'API da un produttore o un proprietario. Nello
studio non c'è nessuna schermata per loro.

## Iscriviti

Manda una `POST` a `/v1/workspaces/{ws}/webhooks` con il tuo `url` e gli `events` che vuoi, oppure `["*"]` per
tutti. La risposta contiene un `secret` una sola volta: conservalo, perché ti serve per controllare ogni consegna.
L'URL deve essere un indirizzo `http` o `https` su un host pubblico. Ti serve una chiave: vedi
[come ottenere una chiave API](https://www.filmsquare.ai/help/it/connect/api-keys/). La richiesta è nella documentazione sotto
[iscriviti](https://www.filmsquare.ai/docs/it/api/webhooks/#subscribe).

## Eventi

Esistono quattro eventi: `generation.succeeded`, `generation.failed`, `take.selected` e `asset_version.created`. Gli
eventi sui ciak nello sketchbook privato di una persona non vengono mai inviati. I campi di ciascuno sono in
[i dati di ogni evento](https://www.filmsquare.ai/docs/it/api/webhooks/#the-data-of-each-event).

## Controlla e rispondi

Ogni consegna porta un header `x-fs-signature`: `sha256=` più l'HMAC-SHA256 in esadecimale del corpo grezzo, con il
tuo secret come chiave. Rifiuta una consegna la cui firma non corrisponde; il codice è in
[controllare la firma](https://www.filmsquare.ai/docs/it/api/webhooks/#check-the-signature).

Rispondi con qualsiasi stato `2xx`, in fretta. Un `5xx`, un `429`, un timeout o un errore di rete viene ritentato con
backoff, fino a 8 tentativi. Qualsiasi altro `4xx` chiude la consegna. Una consegna può arrivare più di una volta,
quindi usa `x-fs-delivery` per saltare un evento che hai già gestito.

> [!NOTE]
> Il tuo Claude non può raggiungere i webhook, perché mandano dati fuori da Filmsquare.
