---
title: "Bagaimana cara mendapat webhook saat take siap?"
description: "Produser atau pemilik mendaftarkan URL lewat API. Pengiriman ditandatangani dengan x-fs-signature dan dicoba ulang kalau server Anda gagal."
url: https://www.filmsquare.ai/help/id/connect/webhooks/
lang: id
section: connect
updated: 2026-11-13
---

Webhook mengirim event ke URL Anda saat take selesai, take dipilih, atau versi baru tiba, jadi Anda tidak perlu polling. Webhook diatur lewat API oleh produser atau pemilik. Tidak ada layar untuknya di studio.

## Berlangganan

Kirim `POST` ke `/v1/workspaces/{ws}/webhooks` dengan `url` Anda dan `events` yang Anda mau, atau `["*"]` untuk semuanya. Jawabannya memuat `secret` satu kali: simpan, karena Anda membutuhkannya untuk memeriksa setiap pengiriman. URL harus alamat `http` atau `https` di host publik. Anda butuh kunci: lihat [cara mendapat kunci API](https://www.filmsquare.ai/help/id/connect/api-keys/). Permintaannya ada di panduan di bawah [berlangganan](https://www.filmsquare.ai/docs/id/api/webhooks/#subscribe).

## Event

Ada empat event: `generation.succeeded`, `generation.failed`, `take.selected`, dan `asset_version.created`. Event tentang take di buku sketsa pribadi seseorang tidak pernah dikirim. Kolom tiap event ada di [data tiap event](https://www.filmsquare.ai/docs/id/api/webhooks/#the-data-of-each-event).

## Periksa dan jawab

Setiap pengiriman membawa header `x-fs-signature`: `sha256=` ditambah HMAC-SHA256 heksadesimal dari body mentah, dengan secret Anda sebagai kuncinya. Tolak pengiriman yang tanda tangannya tidak cocok; kodenya ada di [periksa tanda tangan](https://www.filmsquare.ai/docs/id/api/webhooks/#check-the-signature).

Jawab dengan status `2xx` apa pun, dengan cepat. `5xx`, `429`, timeout, atau error jaringan dicoba ulang dengan backoff, hingga 8 percobaan. `4xx` lainnya mengakhiri pengiriman. Satu pengiriman bisa datang lebih dari sekali, jadi pakai `x-fs-delivery` untuk melewati event yang sudah Anda tangani.

> [!NOTE]
> Claude Anda sendiri tidak bisa menjangkau webhook, karena webhook mengirim data keluar dari Filmsquare.
