Webhookイベント一覧

Webhookで配信されるすべてのイベントとペイロード例です。購読するイベントは設定ページの「Webhook」から選べます（未選択の場合は全イベントを受け取ります）。

イベント一覧

イベント	説明
`status_change`	工程のステータスが変わった
`retake`	リテイクが発生した
`comment`	工程にコメントが投稿された
`delay`	工程の遅延を検知した
`reminder`	締切前のリマインドを送った

共通のペイロード形式

すべてのイベントは event /timestamp /data の3キーを持つJSONを POSTします。シークレットを設定している場合はX-Webhook-Signature ヘッダーにsha256= 形式のHMAC署名が付きます。

宛先URLがDiscordまたはTeamsの場合は、以下の形式ではなくそれぞれの互換形式（Discordのembeds／ TeamsのMessageCard）に変換して送信します。

ペイロード例

`status_change`

工程のステータスが変わった

{
  "event": "status_change",
  "timestamp": "2026-09-06T05:30:00.000Z",
  "data": {
    "project": "作品タイトル",
    "episode": "1",
    "cut": "C-005",
    "processType": "KEY_ANIMATION",
    "oldStatus": "IN_PROGRESS",
    "newStatus": "COMPLETED",
    "actor": "変更した人の表示名"
  }
}

`retake`

リテイクが発生した

{
  "event": "retake",
  "timestamp": "2026-09-06T05:30:00.000Z",
  "data": {
    "project": "作品タイトル",
    "episode": "1",
    "cut": "C-005",
    "processType": "KEY_ANIMATION",
    "reason": "リテイクの内容"
  }
}

`comment`

工程にコメントが投稿された

{
  "event": "comment",
  "timestamp": "2026-09-06T05:30:00.000Z",
  "data": {
    "project": "作品タイトル",
    "episode": "1",
    "cut": "C-005",
    "processType": "KEY_ANIMATION",
    "author": "投稿者の表示名",
    "message": "コメント本文（先頭200文字まで）"
  }
}

`delay`

工程の遅延を検知した

{
  "event": "delay",
  "timestamp": "2026-09-06T05:30:00.000Z",
  "data": {
    "project": "作品タイトル",
    "episode": "1",
    "cut": "C-005",
    "processType": "KEY_ANIMATION",
    "delayDays": 3
  }
}

ストレージ使用量の警告（cron）も同じ delay で飛びます。その場合は project が「システム通知」、episode / cut / processType が空文字で、alertType・level・message・orgUsageGB・totalUsageGB が追加されます。

`reminder`

締切前のリマインドを送った

{
  "event": "reminder",
  "timestamp": "2026-09-06T05:30:00.000Z",
  "data": {
    "project": "作品タイトル",
    "episode": "1",
    "cut": "C-005",
    "processType": "KEY_ANIMATION",
    "daysBeforeDue": 1
  }
}

工程API エラーコード一覧