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

# Twitch

> Twitch-Chat-@Erwähnungen und optionale Flüsternachrichten beantworten

Twitch lässt den Assistenten antworten, wenn jemand den Bot im Kanal-Chat mit @ erwähnt. Flüsternachrichten sind optional und brauchen ein zusätzliches User-Token.

## Wann du ihn nutzt

Nutze ihn für einen Live-Kanal, in dem Zuschauer schon im Chat fragen. Der Bot-Account ist ein eigener Twitch-Nutzer. Jeder Broadcaster muss dem Bot **channel:bot** geben oder ihn zum Moderator machen.

## Was der Assistent hört

Der Assistent hört **channel.chat.message** erst, nachdem du dieses EventSub-Ereignis auf die Famulor-URL abonnierst. Famulor legt das EventSub-Abo nicht für dich an. Der Callback muss HTTPS auf Port 443 sein.

## Woher die Schlüssel kommen

Die verlinkte Anbieter-Anleitung zeigt die Bildschirme zu diesen Klicks. Folge den Klicks unten zusammen mit diesen Bildern.

Das EventSub-Secret (10 bis 100 Zeichen) denkst du dir vor dem Abo aus, es existiert also vor der Famulor-URL. Registriere die Anwendung unter [dev.twitch.tv/console/apps](https://dev.twitch.tv/console/apps). Die Client-ID steht an der Anwendung, das Client-Secret erscheint, wenn du es erzeugst. Die Abo-Klicks und die Anfrage stehen in [Handling webhook events](https://dev.twitch.tv/docs/eventsub/handling-webhook-events). Chat-Berechtigungen sind `user:read:chat`, `user:write:chat` und `user:bot`.

## Beim Anbieter anlegen

1. Melde dich unter [dev.twitch.tv/console/apps](https://dev.twitch.tv/console/apps) an.
2. Wähle **Register Your Application**. Setze den OAuth-Redirect auf `http://localhost`, wähle **Confidential** und lege sie an.
3. Kopiere die **Client ID**. Erzeuge ein **Client Secret** und kopiere es sofort.
4. Denk dir ein EventSub-Secret mit 10 bis 100 Zeichen aus.
5. Nutze einen eigenen Bot-Account. Sein Login-Name ist der Wert, den Famulor verlangt. Notiere die numerische User-ID, wenn du sie hast.
6. Nur für Flüsternachrichten legst du zusätzlich ein User-Access-Token und ein Refresh-Token für diesen Bot an. Chat-\@Erwähnungen brauchen sie nicht.

## In Famulor verbinden

Dein Plan enthält diesen Kanal. Öffne **Settings → Channels**, wähle die Karte, benenne die Verbindung, wähle einen Assistenten und speichere. Die gemeinsamen Konversationseinstellungen — Antwortverzögerung (Standard 5 Sekunden) und Inaktivitätszeit (Standard 30 Minuten) — stehen auf der Seite [Messaging-Kanäle](https://docs.famulor.io/de/channels/messaging.md).

Füge auf der Karte **Twitch** **Application Client ID**, **Application Client Secret**, **EventSub webhook secret** und **Bot account login** ein. **Bot numeric user ID**, **User access token for whispers** und **Refresh token for whispers** bleiben leer, außer du nutzt Flüsternachrichten.

Öffne nach dem Speichern das Menü der Verbindung und wähle **Copy webhook URL**. Füge genau diese Adresse beim Anbieter ein. Eine verifizierte eigene Domain ist in der angezeigten Adresse bereits enthalten.

## Den Anbieter auf Famulor zeigen lassen

1. Kopiere die Famulor-Webhook-URL.
2. Abonniere EventSub **channel.chat.message** auf diese HTTPS-URL auf Port 443, mit demselben Secret. Nutze das Bot-Token mit `user:read:chat`, `user:write:chat` und `user:bot`.
3. Füge den Bot auf jedem Kanal als Moderator hinzu oder lass den Broadcaster **channel:bot** vergeben.
4. Erwähne den Bot im Chat mit @. Die Nachricht erscheint im Verlauf.

## Verlauf

Öffne den [Verlauf](https://docs.famulor.io/de/monitoring/history.md) und filtere nach **Twitch**. Der Thread, die Antwort des Assistenten und eine vorhandene Auswertung erscheinen dort. Du kannst den Assistenten pausieren und selbst antworten.

## API, MCP und Kommandozeile

Dieselbe Verbindung lässt sich über die öffentliche API, das MCP-Tool `create_messaging_connector` oder die Kommandozeile anlegen. Ersetze die Platzhalter durch deine eigenen Werte.

```bash theme={null}
famulor create-messaging-connector --platform twitch --name "Support" \
  --assistant-id ASSISTANT_UUID --client-id CLIENT_ID --client-secret CLIENT_SECRET --webhook-secret YOUR_10_TO_100_CHAR_SECRET --bot-username my_twitch_bot
```


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