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

# Notificações do Twitch

> Anuncie no Discord quando um streamer do Twitch fica ao vivo ou offline, com um embed totalmente customizável.

<Info>
  Requer **Basic**. Até **10 streamers** por servidor. Veja [como as notificações funcionam](/pt/notifications/overview) para as regras compartilhadas por todas as plataformas.
</Info>

## Adicionando um streamer

Pesquise o canal pelo nome — o Vetox o busca no Twitch e confirma que existe antes de adicionar. Um username que não resolve é rejeitado com **Twitch user not found**.

Usernames têm de 1 a 25 caracteres, apenas letras, números e underscores.

## Configurações

| Configuração                  | Padrão           | Observações                                                                                      |
| ----------------------------- | ---------------- | ------------------------------------------------------------------------------------------------ |
| **Discord Channel**           | —                | Obrigatório. Definido por streamer, então diferentes streamers podem postar em canais diferentes |
| **Notify when online**        | **On**           | O anúncio de live                                                                                |
| **Notify when offline**       | **Off**          | Um segundo anúncio quando a stream termina                                                       |
| **Mention Role**              | Nenhum           | Mencionado com o anúncio                                                                         |
| **Custom Notification Embed** | Padrão do Twitch | Roxo, com título da stream, jogo e contagem de viewers                                           |

## Variáveis

| Variável             | Resolve para                                                |
| -------------------- | ----------------------------------------------------------- |
| `{streamer.name}`    | O nome de exibição do streamer                              |
| `{streamer.url}`     | A URL do canal no Twitch                                    |
| `{streamer.avatar}`  | A foto de perfil                                            |
| `{stream.title}`     | O título da stream — **apenas anúncio de live**             |
| `{stream.game}`      | A categoria transmitida — **apenas live**                   |
| `{stream.viewers}`   | Contagem de viewers no momento do anúncio — **apenas live** |
| `{stream.thumbnail}` | A imagem de preview da stream — **apenas live**             |

<Warning>
  As quatro variáveis `{stream.*}` não têm valor num anúncio **offline**. Qualquer field de embed construído com elas desaparece dessa mensagem. Mantenha seu embed offline apenas com variáveis `{streamer.*}`.
</Warning>

## Como o live é detectado

O Vetox verifica a cada **60 segundos** e rastreia se o canal está ao vivo.

<Steps>
  <Step title="Offline → live">
    O anúncio dispara, sujeito a um **cooldown de 10 minutos** por streamer.
  </Step>

  <Step title="Ainda ao vivo">
    Nada. O estado é simplesmente atualizado — uma stream longa produz exatamente um anúncio.
  </Step>

  <Step title="Live → offline">
    O anúncio de offline dispara, se você o habilitou.
  </Step>
</Steps>

<Warning>
  **Adicionar um streamer que já está ao vivo não anuncia nada.** O tracker dispara na transição, não no estado atual. Seu primeiro anúncio será a próxima stream dele.
</Warning>

<Note>
  Uma stream que cai brevemente e reconecta dentro da janela de cooldown produz um anúncio, não dois — isso é deliberado, e é por isso que o cooldown é de 10 minutos e não 1.
</Note>

## Configuração real

<Steps>
  <Step title="Ligue o Twitch em Server Setup">
    Está desligado por padrão. Nada funciona até isso ser ligado.
  </Step>

  <Step title="Adicione o streamer">
    Pesquise o nome e selecione dos resultados.
  </Step>

  <Step title="Escolha um canal e um cargo">
    Um canal dedicado `#going-live` e um cargo `@Stream Ping` que os membros optam via [Self-Roles](/pt/engagement/self-roles) é o padrão que a maioria dos servidores adota.
  </Step>

  <Step title="Verifique as permissões do bot ali">
    View Channel, Send Messages e **Embed Links**.
  </Step>

  <Step title="Aguarde a próxima stream">
    Não julgue adicionando alguém no meio da stream.
  </Step>
</Steps>

## Solução de problemas

<AccordionGroup>
  <Accordion title="Ficou ao vivo e nada foi postado">
    Verifique o toggle de Twitch em Server Setup, se o premium está ativo, e Embed Links no canal. Se você adicionou enquanto já estavam transmitindo, é esperado — aguarde a próxima stream.
  </Accordion>

  <Accordion title="O jogo ou a contagem de viewers está faltando">
    Você está olhando o anúncio de offline. Essas variáveis só existem enquanto está ao vivo.
  </Accordion>

  <Accordion title="Mudar o canal não pegou">
    Limpar o campo de canal não envia nada e mantém silenciosamente o valor antigo. Selecione um canal diferente em vez de limpá-lo.
  </Accordion>

  <Accordion title="Dois servidores seguem o mesmo streamer e apenas um recebeu o ping">
    Ambos deveriam disparar. Se as permissões de um canal falharam, esse item é perdido sem retry — verifique Embed Links no lado que falhou.
  </Accordion>
</AccordionGroup>

<Card title="Kick" icon="tower-broadcast" horizontal href="/pt/notifications/kick">
  O mesmo modelo live/offline no Kick.
</Card>