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

# Comment fonctionnent les notifications

> Annoncez les nouveaux streams, vidéos, posts et épisodes de huit plateformes externes directement dans votre serveur Discord.

Vetox surveille huit plateformes externes et publie une annonce dans votre serveur chaque fois que quelque chose de nouveau apparaît.

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

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

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

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

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

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

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

  <Card title="Podcasts" icon="podcast" href="/fr/notifications/podcasts" />
</CardGroup>

## Trois choses doivent être vraies

C'est la raison la plus courante pour laquelle les notifications semblent ne pas fonctionner. Les trois sont requises, et seule la première est visible sur la page des notifications elle-même.

<Steps>
  <Step title="Premium Basic ou supérieur">
    Chaque plateforme nécessite au moins le palier **Basic**. Ajouter un abonnement sur Starter est rejeté avec un message nommant la plateforme.

    La vérification s'exécute deux fois — une fois lorsque vous ajoutez l'élément, et à nouveau au moment où une annonce serait envoyée.
  </Step>

  <Step title="L'interrupteur de la plateforme dans Configuration du serveur">
    Chaque plateforme a son propre interrupteur sur la page [Configuration du serveur](/fr/server-management/setup), et il est **désactivé par défaut**. Configurer la notification elle-même ne suffit pas.

    <Warning>
      Aucune des deux pages de notification ne vous montre l'état de cet interrupteur. Un flux entièrement configuré, avec premium payé, ne se déclenchera jamais silencieusement, sans indication où que ce soit dans l'UI de notifications. **Vérifiez d'abord la Configuration du serveur.**
    </Warning>
  </Step>

  <Step title="Permissions du salon">
    Vetox a besoin de **Voir le salon**, **Envoyer des messages** et **Intégrer des liens** dans le salon cible. Voir ci-dessous.
  </Step>
</Steps>

## Limites

**10 éléments par plateforme, par serveur** — 10 streamers Twitch, 10 chaînes YouTube, 10 subreddits, et ainsi de suite.

C'est une limite produit fixe. Elle n'**augmente pas** avec un palier premium supérieur, et elle est la même sur Basic, Max et Black.

## À quelle vitesse les notifications arrivent

Vetox interroge chaque plateforme selon un calendrier fixe. Une annonce arrive au sondage suivant après l'apparition du contenu.

| Plateforme | Vérifié toutes les | Cooldown par source |
| ---------- | ------------------ | ------------------- |
| Twitch     | 60 secondes        | 10 minutes          |
| Kick       | 60 secondes        | 10 minutes          |
| Bluesky    | 60 secondes        | 2 minutes           |
| Reddit     | 3 minutes          | 2 minutes           |
| Steam      | 3 minutes          | 2 minutes           |
| YouTube    | 5 minutes          | 10 minutes          |
| RSS        | 5 minutes          | 5 minutes           |
| Podcasts   | 5 minutes          | 5 minutes           |

Le **cooldown** est un plancher entre deux annonces pour la même source, indépendant de l'intervalle de sondage. Un subreddit qui publie trois fois en une minute produit une annonce, pas trois.

<Note>
  Le sondage est effectué par une seule instance élue, donc un serveur occupé ne reçoit jamais de doublons de travailleurs parallèles.
</Note>

### Deux modèles de suivi différents

| Modèle              | Plateformes    | Comportement                                                                             |
| ------------------- | -------------- | ---------------------------------------------------------------------------------------- |
| **État en direct**  | Twitch, Kick   | Suit si le stream est en direct ou hors ligne, et annonce le moment où cet état *change* |
| **Nouveau contenu** | Les six autres | Suit les éléments individuels et annonce chaque nouveau une seule fois                   |

<Warning>
  **Ajouter un streamer qui est déjà en direct ne produit rien.** Le suivi d'état en direct ne se déclenche que sur une transition hors ligne → en ligne. Si vous ajoutez quelqu'un en plein stream, la première annonce que vous recevrez sera son *prochain* stream.

  Testez avec quelqu'un qui est actuellement hors ligne, ou attendez simplement.
</Warning>

<Note>
  L'état direct/hors ligne est suivi **par streamer, pas par serveur**. Si plusieurs serveurs suivent le même streamer, ils sont pilotés depuis un état partagé.
</Note>

## Ce qui ne sera pas annoncé

<AccordionGroup>
  <Accordion title="Tout ce qui a été publié avant que vous l'ajoutiez" icon="clock-rotate-left">
    L'ajout d'un abonnement ne fait jamais de backfill. Seul le contenu publié après l'ajout de l'élément est annoncé, pour que votre salon ne soit pas inondé pendant la configuration.
  </Accordion>

  <Accordion title="Contenu de plus de 2 heures" icon="hourglass-end">
    Pour les six plateformes basées sur le contenu, tout ce qui a été publié il y a plus de 2 heures est ignoré même si Vetox ne l'a jamais vu. Cela empêche qu'un backlog soit déversé après une panne.

    Un élément dont le flux ne fournit pas de date de publication lisible contourne cette vérification et peut être annoncé quel que soit son âge. C'est parfois pourquoi un vieil élément RSS apparaît.
  </Accordion>

  <Accordion title="Le même élément deux fois" icon="copy">
    Chaque élément annoncé est mémorisé pendant **7 jours**, par serveur, pour qu'un redémarrage ou un sondage lent ne puisse pas produire un doublon. Deux serveurs suivant le même flux obtiennent chacun leur propre copie — un serveur voyant un élément ne le supprime pas pour un autre.
  </Accordion>

  <Accordion title="Réponses et reposts Bluesky" icon="reply">
    Seuls les posts originaux sont annoncés. Les réponses et reposts sont filtrés deux fois. **Les quote posts ne sont pas filtrés** et seront annoncés.
  </Accordion>

  <Accordion title="Tout ce qui est arrivé pendant que premium était expiré" icon="triangle-exclamation">
    Un élément vu pendant que votre premium est inactif est marqué comme vu pendant 7 jours même si rien n'a été posté. Faire un upgrade ne l'annonce pas rétroactivement.

    Après avoir réactivé premium, attendez-vous à une période calme jusqu'à ce que du nouveau contenu véritablement nouveau apparaisse.
  </Accordion>
</AccordionGroup>

## Permissions Discord

Vérifiées sur les permissions en direct du bot dans le salon cible au moment de l'envoi :

| Permission               | Pourquoi                                                                                                                            |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| **Voir le salon**        | Vetox ne peut pas poster dans un salon qu'il ne peut pas voir                                                                       |
| **Envoyer des messages** | Pour publier l'annonce                                                                                                              |
| **Intégrer des liens**   | Chaque notification est un embed. Sans cela, le message est rejeté purement et simplement, même si Envoyer des messages est accordé |

<Warning>
  **Un échec de permission perd cet élément définitivement.** L'élément est marqué comme vu avant que l'envoi soit tenté, et il n'y a pas de retry. Corrigez les permissions *avant* que le contenu qui vous intéresse ne soit publié — pas après.
</Warning>

<Tip>
  Si un salon a des overwrites de permission personnalisés, vérifiez les permissions *effectives* du bot là plutôt que son rôle au niveau serveur. Intégrer des liens est celle qui manque le plus souvent.
</Tip>

## Personnaliser l'annonce

| Option                   | Ce qu'elle fait                                                                                                     |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------- |
| **Salon Discord**        | Où l'annonce est publiée. Défini par élément suivi, différents streamers peuvent donc poster dans différents salons |
| **Rôle mentionné**       | Un rôle pingé avec l'annonce                                                                                        |
| **Embed personnalisé**   | Contrôle total du titre, description, couleur, auteur, pied de page, miniature, image et champs                     |
| **Message personnalisé** | Texte brut utilisé comme corps de l'embed. **Disponible uniquement sur RSS et Podcasts**                            |

<Note>
  Un contrôle de message personnalisé n'apparaît que sur les pages RSS et Podcast. Les six autres plateformes utilisent un embed personnalisé à la place.
</Note>

### Limites de taille d'embed

| Champ                       | Limite                            |
| --------------------------- | --------------------------------- |
| Titre                       | 256 caractères                    |
| Description                 | 4 096 caractères                  |
| Nom de l'auteur             | 256 caractères                    |
| Texte du pied de page       | 2 048 caractères                  |
| Champs                      | 25, chacun 256 / 1 024 caractères |
| URL d'image et de miniature | 500 caractères, pas de SVG        |

### Variables

Les champs d'embed et de message prennent en charge les variables entre accolades, comme `{streamer.name}`. Chaque plateforme a son propre ensemble, listé sur la page de cette plateforme.

<Warning>
  **Une variable inconnue devient un texte vide, pas une erreur.** Et un champ d'embed dont le titre ou la valeur finit vide est supprimé du message entièrement.

  Ainsi, un champ qui continue à disparaître signifie presque toujours une variable mal orthographiée, ou une qui n'existe pas pour cette plateforme. Vérifiez le nom par rapport à la liste sur la page de la plateforme — le dropdown dans l'éditeur fait foi.
</Warning>

<Note>
  Les variables de stream Twitch et Kick (`{stream.title}`, `{stream.viewers}` et ainsi de suite) n'existent que dans l'annonce **en direct**. Utilisées dans un embed hors ligne, elles se résolvent à rien et leur champ disparaît.
</Note>

## Mentions

Le rôle mentionné que vous configurez est pingé normalement.

<Warning>
  Les mentions dans un embed de notification ne sont **pas** restreintes au rôle configuré. Une mention de rôle ou d'utilisateur tapée dans un message personnalisé ou dans le corps d'un embed pingera. Attention avec `@everyone` dans un modèle personnalisé.
</Warning>

## Deux paramètres que vous ne pouvez pas changer

<Note>
  L'**interrupteur maître** et la **couleur d'embed** pour chaque plateforme sont stockés mais n'ont pas de contrôle fonctionnel dans le tableau de bord. Chaque plateforme utilise sa couleur de marque par défaut, et l'interrupteur maître ne peut pas être basculé.

  Utilisez l'interrupteur [Configuration du serveur](/fr/server-management/setup) pour désactiver une plateforme, et un embed personnalisé pour définir une couleur.
</Note>

## Dépannage

<AccordionGroup>
  <Accordion title="Rien n'est publié du tout">
    Dans l'ordre :

    1. L'interrupteur de la plateforme sur la page **Configuration du serveur** est activé — désactivé par défaut et invisible depuis ici
    2. Le serveur a un premium **Basic** actif ou supérieur
    3. Le salon cible existe toujours
    4. Vetox a **Voir le salon + Envoyer des messages + Intégrer des liens** là-bas
    5. Pour Twitch et Kick — le streamer est passé hors ligne puis revenu depuis que vous l'avez ajouté
  </Accordion>

  <Accordion title="Je reçois l'annonce en direct mais pas celle hors ligne">
    Les annonces hors ligne sont **désactivées par défaut** sur Twitch et Kick. Activez-les sur le streamer suivi.
  </Accordion>

  <Accordion title="Un champ d'embed continue à disparaître">
    Son titre ou sa valeur s'est résolu à vide et le champ a été supprimé. Presque toujours une variable mal orthographiée ou de la mauvaise plateforme.
  </Accordion>

  <Accordion title="Je ne peux pas ajouter un onzième élément">
    Dix par plateforme est le maximum et ne s'échelonne pas avec le palier. Retirez-en un d'abord.
  </Accordion>

  <Accordion title="Ça marchait, puis ça s'est arrêté après l'expiration de mon premium">
    La configuration est conservée, pas supprimée, et reprend automatiquement. Mais tout ce qui a été publié pendant l'interruption est déjà marqué comme vu et ne sera pas annoncé rétroactivement.
  </Accordion>

  <Accordion title="Vider le salon sur un streamer Twitch ou Kick n'a rien fait">
    Un champ de salon vidé n'est pas envoyé, donc le salon précédent est conservé et aucune erreur n'est affichée. Sélectionnez un autre salon au lieu de le vider.
  </Accordion>
</AccordionGroup>