> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 通知の仕組み

> 8 種類の外部プラットフォームからの新規配信、動画、投稿、エピソードを Discord サーバーで直接告知します。

Vetox は 8 種類の外部プラットフォームを監視し、新しいものが現れるとサーバーに告知を投稿します。

<CardGroup cols={4}>
  <Card title="Twitch" icon="twitch" href="/ja/notifications/twitch" />

  <Card title="Kick" icon="tower-broadcast" href="/ja/notifications/kick" />

  <Card title="YouTube" icon="youtube" href="/ja/notifications/youtube" />

  <Card title="Reddit" icon="reddit" href="/ja/notifications/reddit" />

  <Card title="Bluesky" icon="cloud" href="/ja/notifications/bluesky" />

  <Card title="Steam" icon="steam" href="/ja/notifications/steam" />

  <Card title="RSS" icon="rss" href="/ja/notifications/rss" />

  <Card title="ポッドキャスト" icon="podcast" href="/ja/notifications/podcasts" />
</CardGroup>

## 3 つの条件がすべて必要

通知が動かないように見える最大の原因はこれです。3 つすべてが必要で、通知ページに表示されるのは最初の 1 つのみです。

<Steps>
  <Step title="プレミアム Basic 以上">
    すべてのプラットフォームで少なくとも **Basic** ティアが必要です。Starter での追加はプラットフォーム名を明示して拒否されます。

    チェックは 2 回走ります — 追加時と、告知が送信される瞬間の 2 度。
  </Step>

  <Step title="サーバーセットアップのプラットフォームトグル">
    各プラットフォームは [サーバーセットアップ](/ja/server-management/setup) にスイッチを持ち、**既定でオフ** です。通知自体を設定するだけでは足りません。

    <Warning>
      どちらの通知ページもこのトグルの状態を表示しません。完全に設定されプレミアム支払済みのフィードが、通知 UI のどこにも兆候を出さずに黙って発火しないことがあります。**まずサーバーセットアップを確認してください。**
    </Warning>
  </Step>

  <Step title="チャンネル権限">
    対象チャンネルで Vetox に **View Channel**、**Send Messages**、**Embed Links** が必要です。下記参照。
  </Step>
</Steps>

## 上限

**プラットフォームごと、サーバーごとに 10 個** — Twitch ストリーマー 10、YouTube チャンネル 10、subreddit 10、といった具合です。

これは固定の製品上限です。プレミアムティアで **増えず**、Basic、Max、Black で同じです。

## 通知が届くまでの速さ

Vetox は各プラットフォームを固定スケジュールでポーリングします。コンテンツが出現した次のポーリングで告知が届きます。

| プラットフォーム | 確認間隔 | ソースごとのクールダウン |
| -------- | ---- | ------------ |
| Twitch   | 60 秒 | 10 分         |
| Kick     | 60 秒 | 10 分         |
| Bluesky  | 60 秒 | 2 分          |
| Reddit   | 3 分  | 2 分          |
| Steam    | 3 分  | 2 分          |
| YouTube  | 5 分  | 10 分         |
| RSS      | 5 分  | 5 分          |
| ポッドキャスト  | 5 分  | 5 分          |

**クールダウン** は同じソースの 2 つの告知の間の最低間隔で、ポーリング間隔とは独立です。1 分間に 3 回投稿する subreddit は、3 回ではなく 1 回の告知になります。

<Note>
  ポーリングは 1 つの選出されたインスタンスが行うため、忙しいサーバーでも並列ワーカーからの重複を受け取ることはありません。
</Note>

### 2 種類の追跡モデル

| モデル         | プラットフォーム    | 挙動                             |
| ----------- | ----------- | ------------------------------ |
| **ライブ状態**   | Twitch、Kick | 配信中／オフラインを追跡し、状態が *変化した* 瞬間に告知 |
| **新規コンテンツ** | 他 6 種類      | 個々のアイテムを追跡し、新規のものを 1 回だけ告知     |

<Warning>
  **既に配信中のストリーマーを追加しても何も出ません。** ライブ状態トラッカーは、オフライン → オンラインの遷移でのみ発火します。配信中に追加した場合、最初の告知は *次回* の配信になります。

  現在オフラインの人でテストするか、単に待ってください。
</Warning>

<Note>
  ライブ／オフライン状態は **ストリーマーごとに追跡され、サーバーごとではありません**。複数サーバーが同じストリーマーをフォローしている場合、1 つの共有状態から駆動されます。
</Note>

## 告知されないもの

<AccordionGroup>
  <Accordion title="追加前に公開されたもの" icon="clock-rotate-left">
    追加してもバックフィルされません。追加後に公開されたコンテンツのみ告知されるため、セットアップ中にチャンネルが溢れることはありません。
  </Accordion>

  <Accordion title="2 時間以上前のコンテンツ" icon="hourglass-end">
    6 つのコンテンツ系プラットフォームでは、Vetox が未見であっても 2 時間より前に公開されたものは無視されます。障害後にバックログがまとめて投稿されるのを防ぎます。

    フィードが読める公開日を提供しないアイテムはこのチェックを迂回し、経過時間に関係なく告知され得ます。ときどき古い RSS アイテムが表示される理由です。
  </Accordion>

  <Accordion title="同一アイテムの重複" icon="copy">
    告知済みアイテムはサーバーごとに **7 日間** 記憶されるため、再起動や遅いポーリングでも重複しません。同じフィードをフォローする 2 つのサーバーはそれぞれ独立にコピーを受け取ります — 一方のサーバーが見たからといって、他方で抑制されることはありません。
  </Accordion>

  <Accordion title="Bluesky の返信とリポスト" icon="reply">
    オリジナル投稿のみ告知されます。返信とリポストは二重にフィルタされます。**引用投稿はフィルタされず**、告知されます。
  </Accordion>

  <Accordion title="プレミアム失効中に到着したもの" icon="triangle-exclamation">
    プレミアム非アクティブ中に確認されたアイテムは、投稿されなくても 7 日間見た扱いになります。アップグレードしても遡って告知されません。

    プレミアム再開後は、本当に新しいコンテンツが現れるまで静かな期間があります。
  </Accordion>
</AccordionGroup>

## Discord 権限

送信時に対象チャンネルでのボットの実効権限をチェックします:

| 権限                | 理由                                                   |
| ----------------- | ---------------------------------------------------- |
| **View Channel**  | 見えないチャンネルには投稿できません                                   |
| **Send Messages** | 告知の投稿                                                |
| **Embed Links**   | すべての通知が埋め込みです。ない場合、Send Messages があってもメッセージ自体が拒否されます |

<Warning>
  **権限失敗はそのアイテムを永久に失います。** 送信試行前にアイテムが見た扱いになり、リトライはありません。**気にするコンテンツが公開される前に** 権限を修正してください。
</Warning>

<Tip>
  チャンネルにカスタム権限上書きがある場合、サーバー全体のロールではなくそのチャンネルでのボットの *実効* 権限を確認してください。最も欠けやすいのは Embed Links です。
</Tip>

## 告知のカスタマイズ

| オプション               | 効果                                         |
| ------------------- | ------------------------------------------ |
| **Discord channel** | 告知の投稿先。追跡アイテムごとに設定でき、ストリーマーごとに別チャンネルへ投稿可能  |
| **Mention role**    | 告知と共に ping されるロール                          |
| **Custom embed**    | タイトル、説明、色、著者、フッター、サムネイル、画像、フィールドを完全制御      |
| **Custom message**  | 埋め込み本体として使うプレーンテキスト。**RSS とポッドキャストでのみ利用可** |

<Note>
  カスタムメッセージのコントロールは RSS とポッドキャストのページにのみ存在します。他の 6 つはカスタム埋め込みを使用します。
</Note>

### 埋め込みサイズ上限

| フィールド        | 上限                  |
| ------------ | ------------------- |
| タイトル         | 256 文字              |
| 説明           | 4,096 文字            |
| 著者名          | 256 文字              |
| フッターテキスト     | 2,048 文字            |
| フィールド        | 25、各 256 / 1,024 文字 |
| 画像・サムネイル URL | 500 文字、SVG 不可       |

### 変数

埋め込みとメッセージフィールドは `{streamer.name}` のような波括弧の変数をサポートします。プラットフォームごとにセットが異なり、各プラットフォームのページに記載されています。

<Warning>
  **未知の変数はエラーではなく空文字列になります。** そして、タイトルまたは値が空になった埋め込みフィールドはメッセージから丸ごと破棄されます。

  フィールドが消え続ける場合、ほぼ確実に変数のスペルミスか、そのプラットフォームで存在しない変数です。エディターのドロップダウンが正 — 各プラットフォームページの一覧と照合してください。
</Warning>

<Note>
  Twitch と Kick のストリーム変数（`{stream.title}`、`{stream.viewers}` など）は **ライブ** 告知にのみ存在します。オフライン埋め込みで使うと空に解決され、フィールドが消えます。
</Note>

## メンション

設定したメンションロールは通常通り ping されます。

<Warning>
  通知埋め込み内のメンションは、設定したロールに **限定されません**。カスタムメッセージや埋め込み本体に書いたロール／ユーザーメンションは ping します。カスタムテンプレートでの `@everyone` に注意。
</Warning>

## 変更できない 2 つの設定

<Note>
  各プラットフォームの **マスター有効化スイッチ** と **埋め込み色** は保存されますが、ダッシュボードには動作するコントロールがありません。各プラットフォームはブランド既定色を使い、マスタースイッチは切り替えられません。

  プラットフォームをオフにするには [サーバーセットアップ](/ja/server-management/setup) のトグル、色設定にはカスタム埋め込みを使ってください。
</Note>

## トラブルシューティング

<AccordionGroup>
  <Accordion title="まったく投稿されない">
    順に:

    1. **サーバーセットアップ** ページのプラットフォームトグルがオン — 既定オフでここからは見えません
    2. サーバーがアクティブな **Basic** プレミアム以上
    3. 対象チャンネルが存在する
    4. Vetox に **View Channel + Send Messages + Embed Links** がある
    5. Twitch と Kick では — 追加以降にストリーマーがオフラインになって戻ってきた
  </Accordion>

  <Accordion title="ライブ告知は来るがオフライン告知が来ない">
    Twitch と Kick ではオフライン告知は **既定でオフ** です。追跡中のストリーマーで有効化してください。
  </Accordion>

  <Accordion title="埋め込みフィールドが消え続ける">
    タイトルまたは値が空に解決され破棄されました。ほぼ確実にスペルミスか別プラットフォーム用の変数です。
  </Accordion>

  <Accordion title="11 個目を追加できない">
    プラットフォームあたり 10 個が上限で、ティアで拡大しません。1 つ削除してください。
  </Accordion>

  <Accordion title="動いていたのにプレミアム失効後に止まった">
    設定は削除されず保持され、自動的に再開します。ただし失効中に公開されたものは既に見た扱いで、遡って告知されません。
  </Accordion>

  <Accordion title="Twitch や Kick でチャンネルをクリアしても効かない">
    空にしたチャンネルフィールドは送信されず、前のチャンネルが保持され、エラーは表示されません。クリアではなく別のチャンネルを選択してください。
  </Accordion>
</AccordionGroup>