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

# Notifications Twitch

> Annoncez dans Discord quand un streamer Twitch passe en direct ou hors ligne, avec un embed entièrement personnalisable.

<Info>
  Nécessite **Basic**. Jusqu'à **10 streamers** par serveur. Voir [comment fonctionnent les notifications](/fr/notifications/overview) pour les règles partagées par toutes les plateformes.
</Info>

## Ajouter un streamer

Recherchez la chaîne par nom — Vetox la recherche sur Twitch et confirme qu'elle existe avant d'ajouter. Un nom d'utilisateur qui ne se résout pas est rejeté avec **Utilisateur Twitch introuvable**.

Les noms d'utilisateur font 1–25 caractères, lettres, chiffres et underscores seulement.

## Paramètres

| Paramètre                              | Défaut            | Notes                                                                                        |
| -------------------------------------- | ----------------- | -------------------------------------------------------------------------------------------- |
| **Salon Discord**                      | —                 | Requis. Défini par streamer, différents streamers peuvent donc poster dans différents salons |
| **Notifier en ligne**                  | **Activé**        | L'annonce en direct                                                                          |
| **Notifier hors ligne**                | **Désactivé**     | Une seconde annonce à la fin du stream                                                       |
| **Rôle mentionné**                     | Aucun             | Pingé avec l'annonce                                                                         |
| **Embed de notification personnalisé** | Twitch par défaut | Violet, avec le titre du stream, le jeu et le nombre de spectateurs                          |

## Variables

| Variable             | Résout en                                                               |
| -------------------- | ----------------------------------------------------------------------- |
| `{streamer.name}`    | Le nom d'affichage du streamer                                          |
| `{streamer.url}`     | Son URL de chaîne Twitch                                                |
| `{streamer.avatar}`  | Sa photo de profil                                                      |
| `{stream.title}`     | Le titre du stream — **annonce en direct uniquement**                   |
| `{stream.game}`      | La catégorie en cours de diffusion — **en direct uniquement**           |
| `{stream.viewers}`   | Nombre de spectateurs au moment de l'annonce — **en direct uniquement** |
| `{stream.thumbnail}` | L'image d'aperçu du stream — **en direct uniquement**                   |

<Warning>
  Les quatre variables `{stream.*}` n'ont pas de valeur dans une annonce **hors ligne**. Tout champ d'embed construit à partir d'elles disparaît de ce message. Gardez votre embed hors ligne aux variables `{streamer.*}` uniquement.
</Warning>

## Comment le passage en direct est détecté

Vetox vérifie toutes les **60 secondes** et suit si la chaîne est en direct.

<Steps>
  <Step title="Hors ligne → en direct">
    L'annonce se déclenche, sous réserve d'un **cooldown de 10 minutes** par streamer.
  </Step>

  <Step title="Toujours en direct">
    Rien. L'état est simplement rafraîchi — un long stream produit exactement une annonce.
  </Step>

  <Step title="En direct → hors ligne">
    L'annonce hors ligne se déclenche, si vous l'avez activée.
  </Step>
</Steps>

<Warning>
  **Ajouter un streamer qui est déjà en direct n'annonce rien.** Le suivi se déclenche sur la transition, pas sur l'état actuel. Votre première annonce sera son prochain stream.
</Warning>

<Note>
  Un stream qui coupe brièvement et se reconnecte dans la fenêtre de cooldown produit une annonce, pas deux — c'est délibéré, et c'est pourquoi le cooldown est de 10 minutes plutôt que 1.
</Note>

## Configuration concrète

<Steps>
  <Step title="Activez Twitch dans Configuration du serveur">
    Il est désactivé par défaut. Rien ne fonctionne tant que ce n'est pas activé.
  </Step>

  <Step title="Ajoutez le streamer">
    Recherchez son nom et sélectionnez-le dans les résultats.
  </Step>

  <Step title="Choisissez un salon et un rôle">
    Un salon `#going-live` dédié et un rôle `@Stream Ping` que les membres choisissent via [Self-Roles](/fr/engagement/self-roles) est le modèle que la plupart des serveurs adoptent.
  </Step>

  <Step title="Vérifiez les permissions du bot là-bas">
    Voir le salon, Envoyer des messages et **Intégrer des liens**.
  </Step>

  <Step title="Attendez leur prochain stream">
    Ne jugez pas en ajoutant quelqu'un en plein stream.
  </Step>
</Steps>

## Dépannage

<AccordionGroup>
  <Accordion title="Ils sont passés en direct et rien n'a été posté">
    Vérifiez l'interrupteur Twitch dans la Configuration du serveur, que premium est actif, et Intégrer des liens dans le salon. Si vous les avez ajoutés pendant qu'ils étaient déjà en stream, c'est attendu — attendez le prochain stream.
  </Accordion>

  <Accordion title="Le jeu ou le nombre de spectateurs est manquant">
    Vous regardez l'annonce hors ligne. Ces variables n'existent qu'en direct.
  </Accordion>

  <Accordion title="Changer le salon n'a pas pris">
    Vider le champ salon n'envoie rien et conserve silencieusement l'ancienne valeur. Sélectionnez un autre salon plutôt que de le vider.
  </Accordion>

  <Accordion title="Deux serveurs suivent le même streamer et un seul a eu le ping">
    Les deux devraient se déclencher. Si les permissions d'un salon ont échoué, cet élément est perdu sans retry — vérifiez Intégrer des liens sur le côté défaillant.
  </Accordion>
</AccordionGroup>

<Card title="Kick" icon="tower-broadcast" horizontal href="/fr/notifications/kick">
  Le même modèle direct/hors ligne sur Kick.
</Card>