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

> Anuncie novos itens de qualquer feed RSS ou Atom no seu servidor do Discord.

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

O RSS é o coringa. Se um site publica um feed, o Vetox pode anunciá-lo — blogs, changelogs, sites de notícias, seções de fórum, notas de lançamento.

## Adicionando um feed

Cole a URL do feed. O Vetox busca e faz o parse antes de salvar; qualquer coisa que não seja um feed legível é rejeitada com **Invalid RSS feed URL or unable to parse feed**.

<Tip>
  Use a URL do feed, não a URL do site. Costuma terminar em `/feed`, `/rss`, `/atom.xml` ou `/index.xml`. Se não tiver certeza, veja o código-fonte da página e procure por um link `application/rss+xml`.
</Tip>

## Configurações

| Configuração                  | Padrão        | Observações                                                                 |
| ----------------------------- | ------------- | --------------------------------------------------------------------------- |
| **Discord Channel**           | —             | Obrigatório                                                                 |
| **Notify on New Items**       | **On**        |                                                                             |
| **Custom Message**            | Nenhuma       | Texto puro, até 2.000 caracteres — uma das duas únicas plataformas com isso |
| **Mention Role**              | Nenhum        |                                                                             |
| **Custom Notification Embed** | Padrão do RSS | Laranja                                                                     |

## Variáveis

| Variável             | Resolve para            |
| -------------------- | ----------------------- |
| `{item.title}`       | Título do item          |
| `{item.url}`         | Link para o item        |
| `{item.description}` | Resumo ou corpo do item |
| `{item.author}`      | Autor                   |
| `{feed.name}`        | O título do feed        |
| `{feed.url}`         | A URL do site do feed   |

<Note>
  Quanto de texto `{item.description}` carrega depende totalmente do publicador. Alguns feeds trazem um resumo de uma linha, outros o artigo inteiro. O Vetox não trunca, mas o limite de 4.096 caracteres da description do Discord se aplica.
</Note>

## O que é anunciado

Verificado a cada **5 minutos** com **cooldown de 5 minutos** por feed.

<Warning>
  **O RSS não tem cap por polling.** As outras plataformas olham os 5 itens mais recentes; o RSS considera cada item no feed como candidato.

  Na prática, o cutoff de idade de 2 horas e a lista de vistos de 7 dias mantêm isso sob controle. Mas um feed que de repente republica muitos itens com datas frescas pode produzir uma rajada de anúncios.
</Warning>

<Note>
  Itens sem data de publicação legível ignoram o cutoff de idade de 2 horas. Um feed mal formado pode, portanto, anunciar itens mais antigos. Se um feed faz isso repetidamente, é um defeito do feed, não do Vetox.
</Note>

O Vetox usa requisições condicionais, então um feed que não mudou custa quase nada para verificar.

## Exemplos reais

<AccordionGroup>
  <Accordion title="Patch notes de um jogo">
    Muitos estúdios publicam um feed de changelog. Isso costuma ser melhor do que a integração do Steam, porque carrega apenas posts oficiais.
  </Accordion>

  <Accordion title="Uma página de status">
    A maioria das páginas de status expõe um feed. Direcione-o para seu canal de staff como um aviso antecipado de uma indisponibilidade que afeta sua comunidade.
  </Accordion>

  <Accordion title="Um blog ou newsletter">
    `{item.title}` como título do embed, `{item.description}` como corpo, `{item.url}` como link.
  </Accordion>
</AccordionGroup>

## Solução de problemas

<AccordionGroup>
  <Accordion title="O feed não salva">
    O Vetox precisa conseguir buscar e fazer o parse na hora. Verifique a URL em um navegador — se renderiza como página web em vez de XML, não é a URL do feed.

    A própria busca também tem limites. Um feed é rejeitado se não responder em **10 segundos**, tiver mais de **5 MB** ou redirecionar mais de **3 vezes**. O endereço precisa ser `http://` ou `https://` e apontar para um host público — endereços privados, locais ou de rede interna são recusados.
  </Accordion>

  <Accordion title="Itens antigos foram anunciados">
    O feed não fornece datas de publicação utilizáveis, então o cutoff de idade não pode se aplicar.
  </Accordion>

  <Accordion title="Uma rajada de anúncios chegou de uma vez">
    O publicador redatou vários itens. Não há rate limit além do cooldown por feed.
  </Accordion>

  <Accordion title="A descrição está vazia">
    Aquele feed não inclui uma. Use `{item.title}` e `{item.url}` em vez disso.
  </Accordion>
</AccordionGroup>

<Card title="Podcasts" icon="podcast" horizontal href="/pt/notifications/podcasts">
  Uma visão especializada da mesma máquina de feed.
</Card>