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

# Custom Bot

> Rode o Vetox sob o nome, avatar e perfil do seu próprio bot. Um add-on para Max e Black.

Todo recurso do Vetox, rodando sob **sua** conta de bot — seu nome, seu avatar, seu status.

<Info>
  Disponível em **Max** e **Black** como add-on: **Max+** e **Black+**. Veja [Server Premium](/pt/premium/overview) para preços.
</Info>

<Warning>
  **O Custom Bot não concede acesso à IA.** É uma flag separada do seu tier, e a IA é bloqueada apenas pelo tier. **Max+ não tem IA.** Apenas Black e Black+ têm.
</Warning>

## O que muda

|                            | Efeito                                                                                           |
| -------------------------- | ------------------------------------------------------------------------------------------------ |
| **Nome, avatar, banner**   | Os do seu bot                                                                                    |
| **Descrição**              | Até 400 caracteres                                                                               |
| **Status**                 | Playing, Watching, Listening ou Competing                                                        |
| **Slash commands**         | Registrados na sua própria aplicação                                                             |
| **O bot público do Vetox** | **Fica silencioso naquele servidor** — para de responder para que os dois nunca respondam juntos |

<Note>
  O Discord não permite que bots usem um status personalizado simples. Seu status precisa ser um dos quatro tipos de atividade.
</Note>

<Note>
  Atualizações de identidade são aditivas. Limpar um campo mantém o valor anterior em vez de removê-lo — defina uma substituição.
</Note>

## Um servidor por bot

<Warning>
  Um Custom Bot atende **um servidor**. Ao iniciar, ele sai de qualquer outro servidor onde tenha sido adicionado.

  Não use a mesma aplicação de bot em várias comunidades.
</Warning>

## Configurando

<Steps>
  <Step title="Crie uma aplicação do Discord">
    No Discord Developer Portal, crie uma aplicação e adicione um bot a ela.
  </Step>

  <Step title="Habilite as intents privilegiadas">
    **Server Members**, **Presence** e **Message Content** são todas obrigatórias. Sem elas o bot não pode iniciar.
  </Step>

  <Step title="Copie o token e envie-o">
    Cole no dashboard. O Vetox o valida com o Discord antes de aceitar.

    <Warning>
      **O token é somente para escrita.** Uma vez enviado, você não pode lê-lo de volta pelo Vetox. Guarde sua própria cópia primeiro — se perder, precisará regenerar no Developer Portal e enviar o novo.
    </Warning>
  </Step>

  <Step title="Convide seu bot para o seu servidor">
    Usando o link de convite da sua própria aplicação, com as permissões que o Vetox precisa.
  </Step>

  <Step title="Espere ele ficar online">
    Ele inicia em instantes. O bot público do Vetox então para de responder naquele servidor.
  </Step>
</Steps>

<Note>
  Seu token é criptografado em repouso. O Vetox valida o formato, confirma que pertence a uma conta de bot, verifica a aplicação e as três intents necessárias antes de aceitá-lo.
</Note>

## Transferindo para outro servidor

Mover um Custom Bot é uma confirmação em dois passos, e o pedido expira após **30 minutos**.

<Warning>
  Uma transferência é final após a confirmação. O bot sai do servidor antigo e o bot público do Vetox volta a operar lá.
</Warning>

## Desativando

Desativar interrompe o bot e **apaga o token armazenado**. Suas configurações de branding e o log de auditoria são mantidos.

Para reativar, envie o token novamente.

## Se ele travar

Um bot que trava três vezes em um minuto é interrompido automaticamente para proteger a plataforma. Corrija a causa — normalmente um token revogado ou intents faltando — e reative.

## Solução de problemas

<AccordionGroup>
  <Accordion title="O bot não fica online">
    Todas as três intents privilegiadas precisam estar habilitadas no Developer Portal: Server Members, Presence e Message Content. Essa é a causa mais comum.
  </Accordion>

  <Accordion title="Ambos os bots respondem a tudo">
    O bot público fica silencioso apenas no servidor que o Custom Bot atende. Se você vê os dois, o Custom Bot pode não ter iniciado — verifique o status no dashboard.
  </Accordion>

  <Accordion title="Perdi meu token">
    O Vetox não pode mostrá-lo. Regenere no Developer Portal e envie o novo.
  </Accordion>

  <Accordion title="Meu bot saiu de um servidor sozinho">
    Esperado — um Custom Bot atende um servidor e sai dos outros ao iniciar.
  </Accordion>

  <Accordion title="Estou no Max+ e a IA está bloqueada">
    Correto. O Custom Bot não é uma mudança de tier; a IA requer Black.
  </Accordion>

  <Accordion title="Mudei o avatar e o antigo ainda aparece">
    O Discord faz cache agressivo de avatares de bot. Dê tempo antes de reenviar.
  </Accordion>
</AccordionGroup>

<Card title="Manage Bots" icon="gauge" horizontal href="/pt/account/manage-bots">
  A página do dashboard onde isso é configurado.
</Card>