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

# Social Feeds

> Beobachte die YouTube- und Twitch-Kanäle deiner Organisation und kündige neue Uploads und Streams per Flow in Discord an.

**Social Feeds** beobachtet die YouTube- und Twitch-Kanäle deiner Organisation. Sobald ein neues Video online geht oder ein Twitch-Kanal live geht, löst SquadVault ein Flow-Event aus, und ein Flow postet es in Discord.

Du findest es unter **Verbindungen → Social Feeds** in der Seitenleiste, über die Karte **Social Feeds** in den [Integrationen](https://docs.squadvault.xyz/de/user-guide/integrations.md) oder per **Strg K** mit der Suche nach „YouTube“ oder „Twitch“. Wer Flows lesen darf, sieht die Seite. Wer Flows erstellen darf, kann Kanäle hinzufügen und entfernen.

## Kanal hinzufügen

1. Öffne **Social Feeds**.
2. Wähle die Plattform: **YouTube** oder **Twitch**.
3. Füge den Kanal ein:
   * **YouTube:** eine Kanal-URL, ein `@Handle` oder eine Kanal-ID (`UC…`)
   * **Twitch:** den Kanalnamen oder die URL (`twitch.tv/deinteam`)
4. Klicke auf **Kanal hinzufügen**.

Wenn ein YouTube-Handle nicht aufgelöst werden kann, nimm stattdessen die Kanal-ID. Du findest sie in der Kanal-URL (`youtube.com/channel/UC…`).

> [!NOTE]
>
> Videos und Streams, die beim Hinzufügen schon existieren, werden nie angekündigt. Nur Uploads und Streams, die danach starten, lösen ein Event aus.

> [!NOTE]
>
> Ist **Twitch** ausgegraut, ist Twitch auf diesem Server noch nicht eingerichtet. Ein Server-Admin muss `TWITCH_CLIENT_ID` und `TWITCH_CLIENT_SECRET` aus einer Twitch-Developer-App setzen.

## In Discord posten

Social Feeds postet nicht selbst. Dafür nutzt du einen Flow:

1. Geh zu **Flows → Vorlagen** und aktiviere **Neuen Social-Post ankündigen** (Uploads) und/oder **Twitch-Stream ankündigen** (Livegang).
2. Wähle den Discord-Channel, in den gepostet wird. Standardmäßig nutzen die Vorlagen deinen Log-Channel.
3. Pass die Nachricht bei Bedarf an, zum Beispiel mit `{{feed.displayName}}`, `{{post.title}}`, `{{stream.title}}` oder `{{stream.gameName}}`.

Weil es normale Flows sind, kannst du Bedingungen (zum Beispiel nur ein bestimmter Kanal), Embeds oder eine [Webhook](https://docs.squadvault.xyz/de/user-guide/webhooks.md)-Aktion ergänzen.

## Was du siehst

1. **Status:** wie viele Kanäle verbunden sind und ob Prüfungen fehlschlagen
2. **Kanäle:** Formular und Liste der verbundenen Kanäle mit letzter Prüfung oder letztem Fehler
3. **So funktioniert’s:** direkter Weg zu den Flow-Vorlagen

YouTube-Kanäle werden etwa alle 5 Minuten geprüft, Twitch-Kanäle etwa jede Minute. Schlägt eine Prüfung fehl (zum Beispiel weil der Kanal gelöscht wurde), zeigt die Zeile den Fehler, und SquadVault versucht es bei der nächsten Prüfung erneut.

## Flow-Events

| Ereignis | Löst aus, wenn | Variablen |
| - | - | - |
| `social.post.published` | Ein verbundener Kanal ein neues YouTube-Video oder ein Twitch-Highlight bzw. einen Upload veröffentlicht | `feed.platform`, `feed.displayName`, `feed.accountUrl`, `post.id`, `post.url`, `post.title`, `post.thumbnailUrl`, `post.publishedAt` |
| `social.stream.started` | Ein verbundener Twitch-Kanal live geht | `feed.platform`, `feed.displayName`, `feed.accountUrl`, `stream.id`, `stream.url`, `stream.title`, `stream.gameName`, `stream.thumbnailUrl`, `stream.startedAt` |

## Tipps

* YouTube-Shorts zählen als Uploads und werden wie normale Videos angekündigt.
* Twitch-VODs vergangener Übertragungen werden nicht angekündigt, weil der Livestream schon angekündigt wurde. Highlights und Uploads schon.
* Jedes Video und jeder Stream wird höchstens einmal angekündigt, auch wenn sich Prüfungen überschneiden.
* Wenn du einen Kanal entfernst, stoppen die Ankündigungen sofort. Fügst du ihn erneut hinzu, werden alte Videos nicht noch einmal angekündigt.
* TikTok und X werden noch nicht unterstützt.

## Weiter

* [Flows](https://docs.squadvault.xyz/de/user-guide/flows.md)
* [Flows-Referenz](https://docs.squadvault.xyz/de/user-guide/flows-reference.md)
* [Discord](https://docs.squadvault.xyz/de/user-guide/discord.md)
* [Integrationen](https://docs.squadvault.xyz/de/user-guide/integrations.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.