> ## 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

> Répondre aux @mentions du chat Twitch et aux chuchotements

Twitch permet à l'assistant de répondre quand quelqu'un mentionne le bot avec @ dans le chat d'une chaîne. Les chuchotements sont facultatifs et demandent un jeton utilisateur en plus.

## Quand l'utiliser

Utilisez-le pour une chaîne en direct où les spectateurs posent déjà des questions dans le chat. Le compte bot est un utilisateur Twitch séparé. Chaque diffuseur doit accorder **channel:bot** au bot ou en faire un modérateur.

## Ce que l'assistant entend

L'assistant entend **channel.chat.message** seulement après que vous abonnez cet événement EventSub à l'URL Famulor. Famulor ne crée pas l'abonnement EventSub. Le callback doit être en HTTPS sur le port 443.

## Où trouver les clés

Le guide du fournisseur lié montre les écrans de ces clics. Suivez les clics ci-dessous avec ces images.

Vous inventez le secret EventSub (10 à 100 caractères) avant l'abonnement, donc il existe avant l'URL Famulor. Enregistrez l'application sur [dev.twitch.tv/console/apps](https://dev.twitch.tv/console/apps). Le Client ID est sur l'application, et le Client Secret s'affiche quand vous le générez. Les clics et la forme de la demande sont dans [Handling webhook events](https://dev.twitch.tv/docs/eventsub/handling-webhook-events). Les portées de chat sont `user:read:chat`, `user:write:chat` et `user:bot`.

## Le créer chez le fournisseur

1. Connectez-vous sur [dev.twitch.tv/console/apps](https://dev.twitch.tv/console/apps).
2. Choisissez **Register Your Application**. Mettez la redirection OAuth sur `http://localhost`, choisissez **Confidential** et créez-la.
3. Copiez le **Client ID**. Générez un **Client Secret** et copiez-le tout de suite.
4. Inventez un secret EventSub de 10 à 100 caractères.
5. Utilisez un compte bot séparé. Son identifiant de connexion est la valeur demandée par Famulor. Notez l'ID numérique si vous l'avez.
6. Pour les chuchotements seulement, créez aussi un jeton d'accès utilisateur et un jeton de rafraîchissement. Les @mentions du chat n'en ont pas besoin.

## Le connecter dans Famulor

Votre forfait inclut ce canal. Ouvrez **Settings → Channels**, choisissez la carte, nommez la connexion, sélectionnez un assistant et enregistrez. Les paramètres de conversation communs — délai de réponse (5 secondes par défaut) et délai d'inactivité (30 minutes par défaut) — sont décrits sur la page [canaux de messagerie](https://docs.famulor.io/fr/channels/messaging.md).

Sur la carte **Twitch**, collez **Application Client ID**, **Application Client Secret**, **EventSub webhook secret** et **Bot account login**. **Bot numeric user ID**, **User access token for whispers** et **Refresh token for whispers** restent vides sauf pour les chuchotements.

Après l'enregistrement, ouvrez le menu de la connexion et choisissez **Copy webhook URL**. Collez cette adresse exacte chez le fournisseur. Un domaine personnalisé vérifié fait déjà partie de l'adresse affichée.

## Pointer le fournisseur vers Famulor

1. Copiez l'URL de webhook Famulor.
2. Abonnez EventSub **channel.chat.message** à cette URL HTTPS sur le port 443, avec le même secret. Utilisez le jeton du bot qui a `user:read:chat`, `user:write:chat` et `user:bot`.
3. Sur chaque chaîne, ajoutez le bot comme modérateur ou faites accorder **channel:bot** par le diffuseur.
4. Mentionnez le bot avec @ dans le chat. Le message apparaît dans l'historique.

## Historique

Ouvrez l'[historique](https://docs.famulor.io/fr/monitoring/history.md) et filtrez par **Twitch**. Le fil, la réponse de l'assistant et l'analyse éventuelle y apparaissent. Vous pouvez mettre l'assistant en pause et répondre vous-même.

## API, MCP et ligne de commande

La même connexion se crée avec l'API publique, l'outil MCP `create_messaging_connector` ou la ligne de commande. Remplacez les exemples par vos propres valeurs.

```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.