---
title: "テイクが完成したときにWebhookを受け取るにはどうしますか？"
description: "プロデューサーかオーナーが、API経由でURLを登録します。配信にはx-fs-signatureの署名が付き、サーバーが失敗したときは再試行されます。"
url: https://www.filmsquare.ai/help/ja/connect/webhooks/
lang: ja
section: connect
updated: 2026-11-13
---

Webhookは、テイクが完成したとき、テイクが採用されたとき、新しいバージョンが届いたときに、あなたのURLにイベントを送ります。ポーリングする必要はありません。Webhookは、プロデューサーかオーナーが、API経由で設定します。スタジオに、そのための画面はありません。

## 登録する

`/v1/workspaces/{ws}/webhooks`に`POST`を送り、`url`と、欲しい`events`（すべてなら`["*"]`）を指定します。応答には`secret`が1回だけ含まれます。配信のたびに検証に使うので、保管してください。URLは、公開されたホストの`http`か`https`のアドレスである必要があります。キーが必要です。[APIキーの取得のしかた](https://www.filmsquare.ai/help/ja/connect/api-keys/)を参照してください。リクエストは、ドキュメントの[登録](https://www.filmsquare.ai/docs/ja/api/webhooks/#subscribe)にあります。

## イベント

イベントは4つです。`generation.succeeded`、`generation.failed`、`take.selected`、`asset_version.created`です。個人のスケッチブックのテイクに関するイベントは、送られません。それぞれのフィールドは、[各イベントのデータ](https://www.filmsquare.ai/docs/ja/api/webhooks/#the-data-of-each-event)にあります。

## 検証と応答

配信にはすべて、`x-fs-signature`ヘッダーが付きます。`sha256=`に、生のボディに対する、シークレットをキーとしたHMAC-SHA256の16進が続きます。署名が一致しない配信は、拒否してください。コードは、[署名を検証する](https://www.filmsquare.ai/docs/ja/api/webhooks/#check-the-signature)にあります。

応答は、`2xx`のステータスで、すばやく返してください。`5xx`、`429`、タイムアウト、ネットワークエラーは、バックオフしながら、最大8回再試行されます。そのほかの`4xx`では、配信が終わります。配信は、複数回届くことがあるので、処理済みのイベントを飛ばすには、`x-fs-delivery`を使ってください。

> [!NOTE]
> お手持ちのClaudeは、Webhookに触れません。Webhookは、Filmsquareの外にデータを送るためのものだからです。
