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

> Anuncie novos uploads e lives do YouTube no seu servidor do Discord.

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

## Adicionando um canal

Pesquise pelo nome do canal. O Vetox o resolve para um channel ID; um canal não resolvível é rejeitado com **YouTube channel not found**.

## Configurações

| Configuração                  | Padrão            | Observações  |
| ----------------------------- | ----------------- | ------------ |
| **Discord Channel**           | —                 | Obrigatório  |
| **Notify on upload**          | **On**            | Novos vídeos |
| **Notify on live**            | **On**            | Lives        |
| **Mention Role**              | Nenhum            |              |
| **Custom Notification Embed** | Padrão do YouTube | Vermelho     |

<Warning>
  Desligar **ambos** os toggles salva sem reclamar e garante que o canal nunca anuncie nada. Não há aviso para esse estado.
</Warning>

## Variáveis

| Variável            | Resolve para               |
| ------------------- | -------------------------- |
| `{channel.name}`    | Nome do canal              |
| `{channel.avatar}`  | Avatar do canal            |
| `{video.title}`     | Título do vídeo            |
| `{video.url}`       | URL do vídeo               |
| `{video.thumbnail}` | Thumbnail do vídeo         |
| `{video.type}`      | Se é um upload ou uma live |

## Como novo conteúdo é encontrado

Verificado a cada **5 minutos**, com **cooldown de 10 minutos** por canal. O Vetox lê o feed do canal e considera as **5 entradas mais recentes** a cada vez.

<Note>
  Um canal que publica mais de 5 vídeos numa janela de 5 minutos pode ter o mais antigo deles perdido.
</Note>

<Warning>
  **Uma estreia agendada é anunciada como um upload**, usando a redação de upload em vez de live. Se seu embed diz "went live", uma estreia lerá incorretamente.
</Warning>

## Configuração real

<Steps>
  <Step title="Ligue o YouTube em Server Setup" />

  <Step title="Adicione o canal pelo nome" />

  <Step title="Separe uploads de lives se quiser redação diferente">
    Você não pode direcionar uploads e lives para canais diferentes do Discord para o mesmo canal do YouTube — um canal por entrada. Use `{video.type}` no embed para distingui-los.
  </Step>

  <Step title="Verifique Embed Links no canal de destino" />
</Steps>

## Solução de problemas

<AccordionGroup>
  <Accordion title="Um novo vídeo não foi anunciado">
    Verifique primeiro o toggle em Server Setup e o premium. Depois confirme que ao menos um dos dois toggles de notify está ligado. Se o vídeo tem mais de 2 horas, é deliberadamente pulado.
  </Accordion>

  <Accordion title="Uma estreia foi anunciada como upload normal">
    Esperado — estreias são classificadas como uploads.
  </Accordion>

  <Accordion title="Shorts são anunciados e eu não quero">
    Não há filtro para excluir Shorts. Tudo no feed do canal é tratado igual.
  </Accordion>

  <Accordion title="Anúncios chegam até cinco minutos atrasados">
    Esse é o intervalo de polling. O YouTube é verificado a cada 5 minutos, não instantaneamente.
  </Accordion>
</AccordionGroup>

<Card title="Twitch" icon="twitch" horizontal href="/pt/notifications/twitch">
  Streaming ao vivo com tracking instantâneo de estado.
</Card>