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

# Painéis de candidatura

> Recrute staff e processe pedidos de cargo com formulários de perguntas, gates de elegibilidade, votação de reviewers e ações automatizadas.

Um membro clica em um botão, responde às suas perguntas, e a staff aceita ou nega. Na aceitação, o Vetox pode atribuir cargos, mandar DM, renomear, abrir um canal de entrevista e mais.

## Limites

|                                 | Starter | Basic | Max | Black |
| ------------------------------- | ------- | ----- | --- | ----- |
| Painéis                         | 1       | 3     | 10  | 10    |
| Perguntas por formulário        | 5       | 15    | 50  | 50    |
| Ações por etapa                 | 1       | 3     | 10  | 10    |
| Formulários (botões) por painel | 1       | 3     | 5   | 10    |

<Warning>
  **Fazer downgrade apaga permanentemente as perguntas acima do novo limite.** Este é o único lugar no Vetox onde um downgrade destrói dados em vez de desativá-los.

  Ir de Max (50 perguntas) para Basic (15) remove as perguntas 16 em diante de forma definitiva. Fazer upgrade de novo não as traz de volta.

  **Exporte ou copie suas perguntas antes de fazer downgrade.**
</Warning>

Todo o resto num downgrade é desativado em vez de deletado, e volta no upgrade.

## Dois fluxos de submissão

<CardGroup cols={2}>
  <Card title="Dialog Button" icon="window-maximize">
    Um pop-up de formulário do Discord. Gratuito em todo tier. **Máximo 5 perguntas.**
  </Card>

  <Card title="Private Message" icon="envelope">
    O Vetox manda DM para o candidato e faz perguntas uma de cada vez. Suporta o limite total de perguntas.
  </Card>
</CardGroup>

<Warning>
  **Um dialog form com 6 ou mais perguntas onde qualquer pergunta além da quinta seja obrigatória nunca pode ser enviado.**

  Pop-ups do Discord comportam 5 campos. Perguntas além disso não são mostradas, mas uma obrigatória ainda é verificada — então o candidato é informado de que uma resposta obrigatória está faltando, sem como fornecê-la. Nada te alerta ao salvar isso.

  Se você precisa de mais de 5 perguntas, use o fluxo **Private Message**.
</Warning>

### O que o fluxo por DM não pode fazer

O fluxo por DM faz perguntas como mensagens de chat, então os tipos de pergunta mais ricos degradam:

| Tipo de pergunta       | Dialog Button | Private Message                   |
| ---------------------- | ------------- | --------------------------------- |
| Texto curto, Parágrafo | Nativo        | Nativo                            |
| Dropdown               | Nativo        | Seletor nativo                    |
| **User picker**        | Nativo        | **Texto digitado, sem validação** |
| **Role picker**        | Nativo        | **Texto digitado, sem validação** |
| **Channel picker**     | Nativo        | **Texto digitado, sem validação** |
| **User/Role picker**   | Nativo        | **Texto digitado, sem validação** |
| **Upload de arquivo**  | Nativo        | **Apenas nomes de arquivo**       |

<Warning>
  No fluxo por DM, os quatro tipos de picker aceitam **qualquer texto** sem validação. Um candidato pode digitar qualquer coisa e será armazenado como resposta. Não dependa de uma resposta de picker ser um usuário, cargo ou canal real num formulário por DM.
</Warning>

## Perguntas

Oito tipos. Perguntas de texto aceitam de 0 a 4.000 caracteres; dropdowns aceitam até 25 opções; uploads de arquivo aceitam até 10 arquivos.

## Elegibilidade

Quem pode candidatar-se:

| Gate                          | O que verifica                                               |
| ----------------------------- | ------------------------------------------------------------ |
| **Idade mínima da conta**     | Quão antiga é a conta Discord                                |
| **Tempo mínimo no servidor**  | Há quanto tempo estão no seu servidor                        |
| **Required roles**            | Precisam ter **qualquer** ou **todos** desses                |
| **Blocked roles**             | Não podem ter **qualquer** ou **todos** desses               |
| **Multi-server verification** | Precisam ser membros de outros servidores nomeados (**Max**) |
| **Cooldown**                  | 0–1.440 minutos entre applications                           |
| **Max pending**               | 1–5 applications abertas por pessoa                          |
| **DM alcançável**             | As DMs devem estar abertas (ligado por padrão)               |

<Info>
  Required e blocked roles, e auto-deny, requerem **Basic**. Multi-server verification requer **Max**.
</Info>

<Warning>
  **Não existe um gate de "já aceito".** Uma vez que alguém é aceito, pode se candidatar novamente assim que o cooldown expira. Se você não quer applications repetidas, defina um cooldown longo ou adicione o cargo de aceito aos **Blocked roles**.
</Warning>

## Ações de workflow

O que acontece no envio, aceitação ou negação.

| Ação                                    | Tier   |
| --------------------------------------- | ------ |
| Adicionar cargos, Remover cargos        | Grátis |
| Enviar embed, Enviar DM, Ping em cargos | Grátis |
| Editar apelido, Definir tags de fórum   | Grátis |
| Kick, Ban, Timeout do membro            | Basic  |
| Editar nome da thread                   | Basic  |
| Criar canal de entrevista               | Basic  |
| Auto-atribuir cargo de probation        | Max    |
| Adiar uma ação / encadear ações         | Max    |
| **Execute command**                     | Max    |

<Warning>
  **Execute command não faz nada.** Salva, é bloqueado atrás do Max, e o bot o loga e segue em frente sem executar o comando. O editor o rotula de acordo, mas ainda é apresentado como uma capacidade paga.

  Não construa um workflow que dependa dele.
</Warning>

### Variáveis em mensagens de ação

<Warning>
  Variáveis de membro e servidor — `{username}`, `{user.displayName}`, `{nickname}`, `{guildname}`, `{server.name}`, `{server.memberCount}` — **resolvem para nada dentro de templates de ação de workflow.**

  Um template como `[{answer1}] {username}` renderiza como `[resposta]` com um espaço no final. Use variáveis de resposta e texto estático em ações de workflow; coloque detalhes do membro nas mensagens de DM em vez disso, onde funcionam.
</Warning>

## Revisão pela staff

Applications são postadas em um canal de review onde os reviewers aceitam ou negam.

| Opção                        | Observações                                                      |
| ---------------------------- | ---------------------------------------------------------------- |
| **Review channel**           | Texto, anúncio ou fórum                                          |
| **Reviewer roles**           | Até 10                                                           |
| **Add thread to submission** | Uma thread por application (**Basic**)                           |
| **Voting**                   | Requer N aprovações ou negações antes de uma decisão (**Basic**) |
| **Auto-deny**                | Negar após 1–720 horas pendente (**Basic**)                      |

<Note>
  A opção de **private thread** para threads de review não tem efeito — threads de review são sempre públicas para qualquer um que possa ver o canal de review. Restrinja o próprio canal.
</Note>

<Note>
  Um reviewer não pode revisar a própria application.
</Note>

## Permissões que o Vetox precisa

| Ação                        | Permissão                                                   |
| --------------------------- | ----------------------------------------------------------- |
| Adicionar ou remover cargos | **Manage Roles**, e o cargo deve estar **abaixo** do Vetox  |
| Editar apelido              | **Manage Nicknames**, e o membro deve estar abaixo do Vetox |
| Kick / Ban / Timeout        | A permissão correspondente, e o membro abaixo do Vetox      |
| Postar o embed de review    | **View Channel**, **Send Messages**, **Embed Links**        |
| Threads de review           | **Manage Threads**                                          |
| Canais de entrevista        | **Manage Channels**                                         |

<Warning>
  **Se o Vetox não consegue postar no canal de review, o candidato ainda é informado de que sua application foi enviada** — enquanto a staff nunca a vê. Verifique se o bot pode postar no canal de review antes de ir ao ar.
</Warning>

A maioria das outras falhas é reportada no canal de review para que a staff veja o que deu errado.

## Configurando uma

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

  <Step title="Comece de um template">
    Seis são fornecidos — Staff Application, Game Member, Role Request, Event Signup, Partner Inquiry, Verification — ou comece em branco.
  </Step>

  <Step title="Escolha o fluxo">
    Cinco perguntas ou menos, Dialog Button serve. Mais de cinco, use Private Message.
  </Step>

  <Step title="Defina o canal de review e os reviewer roles">
    Confirme que o Vetox pode postar ali.
  </Step>

  <Step title="Adicione ações de aceitação">
    Tipicamente: adicionar o cargo, enviar uma DM de boas-vindas. Verifique que o cargo está abaixo do Vetox.
  </Step>

  <Step title="Defina a elegibilidade">
    Uma idade mínima de conta bloqueia contas descartáveis com quase nenhum custo para candidatos genuínos.
  </Step>

  <Step title="Envie o painel e teste você mesmo">
    Envie uma application real e a leve até a aceitação antes de anunciar.
  </Step>
</Steps>

## Solução de problemas

<AccordionGroup>
  <Accordion title="Candidatos recebem um erro de resposta obrigatória que não conseguem corrigir">
    Um dialog form com mais de 5 perguntas onde uma posterior é obrigatória. Mude para o fluxo Private Message, ou torne as perguntas 6+ opcionais.
  </Accordion>

  <Accordion title="Applications são enviadas mas a staff nunca as vê">
    O Vetox não pode postar no canal de review. O candidato é informado de que funcionou independentemente disso.
  </Accordion>

  <Accordion title="O cargo não é atribuído na aceitação">
    Manage Roles, e o cargo precisa estar abaixo do Vetox na lista de cargos.
  </Accordion>

  <Accordion title="Alguém que já foi aceito se candidatou de novo">
    Esperado — não há gate para isso. Adicione o cargo de aceito aos Blocked roles.
  </Accordion>

  <Accordion title="Minhas variáveis renderizam em branco em uma ação de aceitação">
    Variáveis de membro e servidor não resolvem em ações de workflow. Mova esse texto para a DM de aceitação.
  </Accordion>

  <Accordion title="Perguntas sumiram depois que mudei de plano">
    Um downgrade trunca perguntas além do novo limite e elas não podem ser recuperadas.
  </Accordion>

  <Accordion title="O botão não faz nada quando clicado">
    Geralmente um painel que foi editado ou recriado após a mensagem ser enviada. Envie o painel de novo.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Submissions" icon="inbox" href="/pt/utility/applications/submissions">
    Revise, filtre e exporte applications.
  </Card>

  <Card title="Analytics" icon="chart-line" href="/pt/utility/applications/analytics">
    Taxas de aceitação e onde os candidatos desistem.
  </Card>
</CardGroup>