> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amees.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Allowlist

> Aprenda a configurar e usar o sistema de allowlist da FiveDesk, com perguntas, análise da equipe e códigos de acesso!

A allowlist é a porta de entrada da sua comunidade: antes de liberar o acesso ao servidor, você pode exigir que o usuário responda a um pequeno questionário, que depois é analisado pela equipe. Isso ajuda a conhecer melhor quem está entrando e a manter o espaço seguro:

* Perguntas totalmente personalizáveis, com tempo limite para responder cada uma;
* Sessão retomável — o usuário pode voltar de onde parou se cair no meio do processo;
* Leitura assistida pela equipe, com o histórico de respostas recriado em uma thread;
* Aprovação ou rejeição com feedback, cargos automáticos e mensagens personalizadas;
* Bloqueio temporário ou permanente de usuários, e limite de tentativas;
* Sistema de códigos, para usuários pularem a allowlist inteira com um código de convite.

### Como o sistema é organizado

Esta seção da documentação está dividida em páginas menores, cada uma cobrindo uma parte do sistema:

<CardGroup cols={2}>
  <Card title="Configuração" icon="sliders" href="/products/fivedesk/allowlist/configuracao">
    Ative o sistema, defina canais, tentativas máximas e cargos de aprovação.
  </Card>

  <Card title="Perguntas" icon="list-check" href="/products/fivedesk/allowlist/perguntas">
    Crie, edite, exporte e importe as perguntas do questionário.
  </Card>

  <Card title="Mensagens" icon="message" href="/products/fivedesk/allowlist/mensagens">
    Mensagem principal e as mensagens de aprovação/rejeição enviadas ao usuário.
  </Card>

  <Card title="Preenchendo a allowlist" icon="pen" href="/products/fivedesk/allowlist/preenchendo">
    Como um usuário inicia, responde e envia sua allowlist.
  </Card>

  <Card title="Avaliando allowlists" icon="user-check" href="/products/fivedesk/allowlist/avaliando">
    Como a equipe lê, aprova ou rejeita as allowlists recebidas.
  </Card>

  <Card title="Bloqueios" icon="ban" href="/products/fivedesk/allowlist/bloqueios">
    Bloqueie usuários, gerencie tentativas e veja o perfil de um membro.
  </Card>

  <Card title="Códigos" icon="ticket" href="/products/fivedesk/allowlist/codigos">
    Gere códigos para que usuários pulem a allowlist e recebam cargos automáticos.
  </Card>
</CardGroup>

### Comandos e formas de acesso

* `/gerenciar` - Abre o painel administrativo geral do servidor. A partir dele, selecione a opção **Allowlist** para acessar as configurações do sistema.
* `/allowlist perfil` - Exibe o perfil de allowlist de um membro (tentativas, entradas, bloqueios). Sem mencionar ninguém, mostra o seu próprio.

<Steps>
  <Step title="Acesse o painel de gerenciamento">
    Execute `/gerenciar` no seu servidor e selecione a opção **Allowlist** na lista de opções.
  </Step>

  <Step title="Configure os canais e ative o sistema">
    Defina os três canais obrigatórios (leitura, resultados e histórico de ações) e ligue o sistema. Veja como em [Configuração](/products/fivedesk/allowlist/configuracao).
  </Step>

  <Step title="Cadastre as perguntas">
    Sem perguntas configuradas, ninguém consegue iniciar uma allowlist. Veja como em [Perguntas](/products/fivedesk/allowlist/perguntas).
  </Step>

  <Step title="Publique a mensagem principal">
    Envie a mensagem com o botão de iniciar a allowlist. Veja como em [Mensagens](/products/fivedesk/allowlist/mensagens).
  </Step>
</Steps>

### Fluxo geral

1. O usuário clica em **Iniciar** na mensagem principal e responde às perguntas dentro do tempo limite de cada uma;
2. Ao final, ele escolhe **Enviar** para submeter as respostas, que ficam com status **Pendente**;
3. Um membro da equipe inicia uma leitura, que sorteia uma allowlist pendente e recria a conversa em uma thread privada;
4. A equipe aprova ou rejeita, com um feedback opcional;
5. O usuário recebe o resultado por mensagem direta e no canal de resultados, com os cargos configurados aplicados se aprovado.

Alternativamente, um usuário com um código válido pode pular todo esse processo — veja [Códigos](/products/fivedesk/allowlist/codigos).