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

# Notificaciones de Twitch

> Anuncia en Discord cuándo un streamer de Twitch se pone en vivo o se desconecta, con un embed totalmente personalizable.

<Info>
  Requiere **Basic**. Hasta **10 streamers** por servidor. Consulta [cómo funcionan las notificaciones](/es/notifications/overview) para las reglas compartidas por todas las plataformas.
</Info>

## Añadir un streamer

Busca el canal por nombre: Vetox lo busca en Twitch y confirma que exista antes de añadirlo. Un nombre de usuario que no se resuelva se rechaza con **Usuario de Twitch no encontrado**.

Los nombres de usuario son de 1 a 25 caracteres: letras, números y guiones bajos.

## Ajustes

| Ajuste                                  | Predeterminado           | Notas                                                                                                |
| --------------------------------------- | ------------------------ | ---------------------------------------------------------------------------------------------------- |
| **Canal de Discord**                    | —                        | Requerido. Se define por streamer, para que distintos streamers puedan publicar en canales distintos |
| **Notificar en línea**                  | **Activado**             | El anuncio en vivo                                                                                   |
| **Notificar al desconectar**            | **Desactivado**          | Un segundo anuncio cuando termina la emisión                                                         |
| **Rol a mencionar**                     | Ninguno                  | Se le hace ping con el anuncio                                                                       |
| **Embed de notificación personalizado** | Predeterminado de Twitch | Púrpura, con el título de la emisión, juego y número de espectadores                                 |

## Variables

| Variable             | Se resuelve como                                                |
| -------------------- | --------------------------------------------------------------- |
| `{streamer.name}`    | Nombre visible del streamer                                     |
| `{streamer.url}`     | URL de su canal de Twitch                                       |
| `{streamer.avatar}`  | Su foto de perfil                                               |
| `{stream.title}`     | El título de la emisión, **solo en el anuncio en vivo**         |
| `{stream.game}`      | La categoría que se está emitiendo, **solo en vivo**            |
| `{stream.viewers}`   | Número de espectadores al momento del anuncio, **solo en vivo** |
| `{stream.thumbnail}` | La imagen de vista previa de la emisión, **solo en vivo**       |

<Warning>
  Las cuatro variables `{stream.*}` no tienen valor en un anuncio **offline**. Cualquier campo de embed construido con ellas desaparece de ese mensaje. Deja tu embed offline con variables `{streamer.*}` únicamente.
</Warning>

## Cómo se detecta que están en vivo

Vetox comprueba cada **60 segundos** y sigue si el canal está en vivo.

<Steps>
  <Step title="Desconectado → en vivo">
    Se dispara el anuncio, sujeto a un **enfriamiento de 10 minutos** por streamer.
  </Step>

  <Step title="Siguen en vivo">
    Nada. El estado simplemente se refresca: una emisión larga produce exactamente un anuncio.
  </Step>

  <Step title="En vivo → desconectado">
    Se dispara el anuncio de desconexión, si lo activaste.
  </Step>
</Steps>

<Warning>
  **Añadir un streamer que ya está en vivo no anuncia nada.** El seguimiento se dispara con la transición, no con el estado actual. Tu primer anuncio será su próxima emisión.
</Warning>

<Note>
  Una emisión que se cae brevemente y se reconecta dentro de la ventana de enfriamiento produce un anuncio, no dos: es deliberado, y esa es la razón por la que el enfriamiento es de 10 minutos y no de 1.
</Note>

## Configuración real

<Steps>
  <Step title="Activa Twitch en Configuración del servidor">
    Está desactivado por defecto. Nada funciona hasta que esté activado.
  </Step>

  <Step title="Añade el streamer">
    Busca su nombre y selecciónalo entre los resultados.
  </Step>

  <Step title="Elige un canal y un rol">
    Un canal `#en-vivo` dedicado y un rol `@Aviso de Stream` al que los miembros se apunten vía [Autoroles](/es/engagement/self-roles) es el patrón en el que aterrizan la mayoría de los servidores.
  </Step>

  <Step title="Comprueba los permisos del bot ahí">
    Ver canal, Enviar mensajes e **Insertar enlaces**.
  </Step>

  <Step title="Espera a su próxima emisión">
    No lo juzgues añadiendo a alguien a mitad de emisión.
  </Step>
</Steps>

## Solución de problemas

<AccordionGroup>
  <Accordion title="Se pusieron en vivo y no se publicó nada">
    Comprueba el conmutador de Twitch en Configuración del servidor, que premium está activo, e Insertar enlaces en el canal. Si los añadiste mientras ya estaban emitiendo, es lo esperado: espera a la siguiente emisión.
  </Accordion>

  <Accordion title="Falta el juego o el número de espectadores">
    Estás mirando el anuncio de desconexión. Esas variables solo existen en vivo.
  </Accordion>

  <Accordion title="Cambiar el canal no surtió efecto">
    Vaciar el campo del canal no envía nada y conserva silenciosamente el valor anterior. Selecciona un canal distinto en lugar de vaciarlo.
  </Accordion>

  <Accordion title="Dos servidores siguen al mismo streamer y solo uno recibió el ping">
    Ambos deberían dispararse. Si los permisos de un canal fallan, ese elemento se pierde sin reintento: comprueba Insertar enlaces en el lado que falla.
  </Accordion>
</AccordionGroup>

<Card title="Kick" icon="tower-broadcast" horizontal href="/es/notifications/kick">
  El mismo modelo en vivo/desconectado en Kick.
</Card>