# Whitelist Escolha como cada pessoa entra na cidade (quiz, análise, entrevista ou liberação direta) e libere o ID no jogo pelo Discord, na hora. Source: https://fivedash.fivex.gg/docs/pt/discord/whitelist A whitelist é a portaria da sua cidade. Pelo Discord, a pessoa responde às perguntas, passa pela equipe (se você quiser) e, no fim, manda o ID do jogo num painel. O bot libera esse ID na hora, dá o cargo de acesso e troca o apelido. Com o recurso `fivedash` instalado no servidor FiveM, o ID também é liberado dentro do jogo. Esta página é para donos e equipe que configuram e analisam whitelists. [Vídeo: como fazer em menos de 20 segundos](https://fivedash.fivex.gg/docs/videos/discord-whitelist-pt.mp4) ## Antes de começar * **Plano:** a whitelist faz parte do módulo Discord, em todos os planos (Plus, Pro e Ultra). * **Bot conectado:** o bot da cidade precisa estar ligado ao servidor do Discord. Veja [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot). * **Cargos acima:** o cargo do bot precisa ficar **acima** dos cargos que ele dá e tira (aprovado, liberado, entrevista, cargo a remover). Senão, o bot avisa "o cargo do bot precisa ficar acima dele". * **Liberação no jogo (opcional):** instale o recurso `fivedash` e conecte o servidor. Veja [Instalar o recurso](https://fivedash.fivex.gg/docs/pt/getting-started/install-resource). * **Permissões no painel** (área **Whitelist**): | Nível | O que libera | | -------------- | ------------------------------------------------------------------------------------------- | | **Ver** | Whitelists, entrevistas e liberados (Visão geral, fichas, lista de codiguinhos e quem usou) | | **Gerenciar** | Aprovar, recusar e gerar codiguinhos (também desativar, reativar e excluir códigos) | | **Configurar** | Perguntas, modos e painéis (salvar configurações, publicar, reenviar e apagar painéis) | > Os modelos de acesso > > **Equipe de whitelist** > > ("Aprova e recusa whitelists e gera codiguinhos") e > > **Leitura de whitelist e suporte** > > ("Só vê a whitelist e os tickets") já vêm prontos. Veja > > [Equipe e permissões](https://fivedash.fivex.gg/docs/pt/dashboard/team-and-permissions) > > . ## Onde fica Abra **Discord → Whitelist**. O topo da página tem a chave **Ativa / Desativada**, o botão **Publicar painéis** (vira **Reenviar painéis** depois da primeira vez) e, no menu de três pontos, **Apagar painéis**. Abaixo, quatro abas: | Aba | O que tem | | ----------------- | ---------------------------------------------------------------------------------------------------------- | | **Visão geral** | Números da whitelist, quadro ou lista de whitelists, fila da entrevista e **Liberados** | | **Configurações** | **Modo**, **Etapas** (início, perguntas, entrevista), **Regras**, **Resultado no canal** e **Registros** | | **Liberação** | Painel de liberação, formulário, o que acontece **Ao liberar**, **Comando /liberar** e **Na cidade** | | **Codiguinhos** | Painel do codiguinho e a lista de **Códigos**. Só aparece nos modos **Análise manual** e **Só entrevista** | Cada aba tem uma **Prévia no Discord** ao lado. Alterações ficam marcadas com um ponto na aba até você clicar em **Salvar** (ou **Descartar**). ## Modos O modo decide o caminho de quem entra. Escolha em **Configurações → Modo**. | Modo | Como funciona | Perguntas | Equipe decide | Entrevista | Codiguinhos | | ------------------------- | ---------------------------------------------------------------------------- | --------- | ----------------- | ---------- | ----------- | | **Perguntas automáticas** | Quiz de múltipla escolha. Quem acerta o mínimo passa ou vai à entrevista. | ✓ | — (a nota decide) | Opcional | — | | **Análise manual** | A equipe lê as respostas e aprova ou recusa. Pode ter entrevista. | ✓ | ✓ | Opcional | ✓ | | **Só entrevista** | Sem perguntas. A equipe entrevista no canal dela e dá o cargo a quem passar. | — | ✓ | Sempre | ✓ | | **Só liberação** | Sem perguntas. A pessoa manda o ID do jogo e é liberada na hora. | — | — | — | — | O caminho completo, do clique à cidade: 1. A pessoa clica em **Fazer whitelist** no painel (modos com perguntas). 2. **Perguntas automáticas:** a nota decide. **Análise manual:** a equipe aprova ou recusa. 3. Com a entrevista ligada (ou em **Só entrevista**), a pessoa vai para a fila da entrevista e a equipe decide depois da conversa. 4. Aprovada, ganha o **Cargo de quem foi aprovado** e usa o painel de liberação para mandar o ID. 5. O bot dá o **Cargo de quem foi liberado**, troca o apelido e, com o servidor conectado, libera o ID no jogo. No modo **Só liberação**, a pessoa vai direto ao passo 4, sem precisar de cargo. > Se você ainda não mexeu nas perguntas de exemplo, trocar entre > > **Perguntas automáticas** > > e > > **Análise manual** > > troca o conjunto de exemplo junto: um quiz de 4 perguntas de múltipla escolha (RDM, VDM, metagaming, amor à vida) ou 6 perguntas escritas. ## Configurar a whitelist ### Escolha o modo Em **Discord → Whitelist → Configurações**, no grupo **Modo**, clique no cartão do modo que a cidade usa. ### Monte o início Em **Etapas**, abra **Início** e escolha o **Canal do painel**: é onde o bot posta a mensagem com o botão **Fazer whitelist**. Clique em **Título, texto, botão e imagem** para mudar os textos. (Os modos **Só entrevista** e **Só liberação** não têm esse painel.) ### Escreva as perguntas Em **Perguntas**, clique em **Adicionar pergunta**. Para cada uma, preencha **Pergunta**, escolha o **Tipo** e, em múltipla escolha, crie as **Opções** e clique no círculo da resposta certa. Arraste para reordenar; use **Duplicar** e **Excluir** no menu da pergunta. ### Decida sobre a entrevista No cartão **Entrevista**, use **Ligar a entrevista** se quem passa ainda deve conversar com a equipe. Escolha o **Cargo durante a entrevista**, as **Salas de espera (voz)** e monte a colinha. ### Ajuste as regras No grupo **Regras**, defina **Nota para passar**, **Tempo para responder**, **Canal privado**, **Tentar de novo** e **Canal da equipe**. ### Configure a liberação Vá para a aba **Liberação** e escolha o **Canal**, o **Cargo de quem foi aprovado** e o **Cargo de quem foi liberado**. Veja a seção **Liberação** abaixo. ### Ative, salve e publique Ligue a chave **Ativa**, clique em **Salvar** e depois em **Publicar painéis**. O aviso **Painéis publicados** mostra onde eles estão. > **Publicar painéis** > > fica bloqueado enquanto houver alterações não salvas ("Salve as alterações antes de publicar."), com a whitelist desativada ("Ative a whitelist e salve para publicar os painéis.") ou com algo faltando ("Termine as configurações primeiro."). Depois de publicados, salvar de novo atualiza as mensagens no Discord. ### O que o painel exige para salvar O painel aponta o primeiro problema e leva você até o campo: | Mensagem | Quando aparece | | ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | | Escolha o canal do painel da whitelist. | Modos com perguntas, whitelist ativa, sem **Canal do painel** | | Escreva o título ou o texto do painel da whitelist. | Título e texto do painel vazios | | Crie pelo menos uma pergunta. | Modos com perguntas, sem nenhuma | | O modo automático precisa de pelo menos uma pergunta de múltipla escolha. | **Perguntas automáticas** só com perguntas escritas | | Pergunta N: escreva a pergunta. / dê pelo menos duas opções. / preencha ou tire as opções vazias. / marque a resposta certa. | Pergunta incompleta (a resposta certa só é exigida no modo automático) | | Escolha o cargo que quem for aprovado recebe para fazer a liberação. | Todos os modos menos **Só liberação** | | Escolha o canal do painel de liberação. | Whitelist ativa | | Escolha o cargo de quem já foi liberado. | Whitelist ativa | | O cargo a remover não pode ser o mesmo cargo de quem foi liberado. | **Cargo a remover** igual ao **Cargo de quem foi liberado** | | Escolha o canal do painel do codiguinho. | **Usar codiguinhos** ligado, whitelist ativa | | Escolha o canal onde os resultados são anunciados. | **Anunciar o resultado** ligado sem canal | | Escreva o formato do apelido ou desligue "Pedir o nome do personagem". | **Formato do apelido** vazio | ## Perguntas Até **25 perguntas** por whitelist, cada uma com até **10 opções**. | Tipo | Como a pessoa responde | Conta na nota | | -------------------- | ------------------------------------------- | ---------------------- | | **Múltipla escolha** | Escolhe numa lista ("Escolha uma resposta") | ✓ (no modo automático) | | **Resposta curta** | Escreve uma linha | — | | **Resposta longa** | Escreve um texto | — | | Campo | O que faz | Padrão | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | | **Pergunta** | O enunciado (até 200 caracteres) | Vazio | | **Descrição** | Opcional. Aparece embaixo da pergunta (até 300) | Vazio | | **Tipo** | **Múltipla escolha**, **Resposta curta** ou **Resposta longa** | Escolhido ao adicionar | | **Texto de exemplo** | Respostas escritas: aparece dentro da caixa de resposta (até 100). No modo automático, as respostas escritas ficam salvas, mas não contam na nota | Vazio | | **Opções** | Múltipla escolha: pelo menos duas, até 100 caracteres cada. Clique no círculo da resposta certa | 2 opções vazias | | **Obrigatória** | Desligado, a pessoa vê o botão **Pular** | Ligado | Respostas escritas aceitam até 1.000 caracteres. ### Como a pessoa responde no Discord 1. Clica em **Fazer whitelist** no painel. 2. Recebe uma pergunta por vez ("Pergunta 1 de 6"), com o tempo que falta. Múltipla escolha abre uma lista; respostas escritas abrem um formulário pelo botão **Responder**. Há sempre **Cancelar** e, em perguntas opcionais, **Pular**. 3. No fim: * **Perguntas automáticas:** recebe a nota na hora. "Você passou!" (ou "Você passou no quiz!", se tiver entrevista) ou "Não foi dessa vez", com quando pode tentar de novo. * **Análise manual:** "Respostas enviadas". O resultado chega na DM, então a pessoa precisa deixar as mensagens diretas abertas. Com **Canal privado** ligado, cada pessoa responde num canal só dela, criado ao começar e apagado ao terminar. Nesse canal, se o bot tiver a intent **Message Content** ligada, respostas escritas são digitadas direto no chat ("Responda aqui no chat."), sem formulário. ## Regras Em **Configurações → Regras** (modos **Perguntas automáticas** e **Análise manual**): | Campo | O que faz | Opções | Padrão | | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- | ---------- | | **Nota para passar** | A parte das perguntas de múltipla escolha que precisa estar certa. Só no modo automático | 50%, 60%, 70%, 80%, 90%, **Acertar todas** | 70% | | **Tempo para responder** | Depois disso, a whitelist expira e a pessoa começa de novo | 5, 10, 15, 20, 30 minutos, 1 hora | 15 minutos | | **Canal privado** | Cada pessoa responde num canal só dela. Desligado, as perguntas aparecem numa mensagem que só ela vê | Ligado / desligado | Desligado | | **Categoria dos canais** | Onde os canais da whitelist são criados. Sem categoria, ficam no topo da lista. Aparece com **Canal privado** ligado | Qualquer categoria | Nenhuma | | **Tentar de novo** | Quanto tempo esperar depois de ser recusado ou reprovado | **Na hora**, 10 min, 30 min, 1 hora, 6 horas, 1 dia | 30 min | | **Canal da equipe** | Opcional. O bot avisa aqui quando chega uma whitelist para analisar ou uma entrevista para marcar. Aparece na **Análise manual** ou com entrevista | Qualquer canal | Nenhum | > Com > > **Canal privado** > > ligado, o bot precisa de permissão para criar canais. Sem ela, a pessoa vê "O bot não tem permissão para criar o seu canal." ## Entrevista A entrevista é uma conversa com a equipe antes da liberação. Ela é opcional em **Perguntas automáticas** e **Análise manual** (chave **Ligar a entrevista** no cartão **Entrevista**) e sempre existe em **Só entrevista**. | Campo | O que faz | Modos | Padrão | | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | --------------------------------------------------------------------------------------------------------- | | **Cargo durante a entrevista** | Opcional. Dado enquanto a pessoa espera; sai quando a entrevista termina | Automático, manual | Nenhum | | **Mensagem na DM** | Vai na DM de quem passa no quiz (ou de quem teve as respostas aprovadas) | Automático, manual | "Agora falta a entrevista, {membro}! Fique de olho no Discord, a equipe vai te chamar para uma conversa." | | **Canal das entrevistas** | Opcional. O canal onde a equipe entrevista. Quem tentar a liberação antes de ser aprovado é mandado para lá | Só entrevista | Nenhum | | **Salas de espera (voz)** | Até 10 canais de voz. Em **Só entrevista**, quem entra numa sala entra sozinho na fila. Nos outros modos, quem já espera aparece como "na sala" | Todos com entrevista | Nenhuma | | **Colinha da entrevista** | Até 20 perguntas para guiar a conversa, cada uma com "O que esperar da resposta". Só a equipe vê | Todos com entrevista | 6 perguntas de exemplo | > As > > **Salas de espera (voz)** > > precisam do worker do Gateway ligado para o painel saber quem entrou e saiu. ### Conduzir uma entrevista ### Veja a fila Em **Discord → Whitelist → Visão geral**, a coluna **Aguardando entrevista** mostra quem está na sala de espera, ao vivo, com quanto tempo está esperando. A coluna **Entrevista** mostra quem espera fora da sala. ### Abra a ficha e a colinha Clique no cartão da pessoa. A ficha mostra como ela chegou (quiz, respostas aprovadas, sala de espera ou codiguinho). Ao lado, a **Colinha da entrevista**: marque o que já perguntou. Em **Só entrevista**, use o botão **Abrir colinha**. ### Decida Depois da conversa, clique em **Aprovar entrevista** ou **Reprovar**. Ao recusar, escreva o **Motivo** (opcional, até 500 caracteres): ele vai na DM da pessoa. ## Analisar whitelists Em **Discord → Whitelist → Visão geral**, alterne entre **Quadro** e **Lista** em **Modo de exibição**. Busque por nome ou ID do Discord e filtre por status. Analisar exige o nível **Gerenciar**. ### Quadro As colunas mudam com o modo: | Configuração | Colunas | | -------------------------------------------------------------- | ------------------------------------------------------------------------- | | **Análise manual** sem entrevista | **Em análise** → **Aprovadas** / **Recusadas** | | **Análise manual** com entrevista | **Em análise** → **Entrevista**, **Aguardando entrevista**, **Recusadas** | | **Perguntas automáticas** com entrevista, ou **Só entrevista** | **Entrevista**, **Aguardando entrevista** → **Aprovadas** / **Recusadas** | | **Perguntas automáticas** sem entrevista, ou **Só liberação** | Sem quadro: só a lista | Arraste um cartão para a coluna da decisão ("Solte para aprovar", "Solte para recusar", "Solte para mandar à entrevista"). Pelo teclado: espaço para pegar, setas para escolher a coluna, espaço para soltar, Esc para cancelar. Com entrevista na análise manual, a aprovação final acontece na ficha. ### Ficha Clique numa whitelist para ver **Começou**, **Nota** (por exemplo, "3 de 4 · 75%"), **Decidida por**, **Tempo até decidir** e cada resposta (com a certa, nas de múltipla escolha). Os botões mudam com a etapa: | Etapa | Botões | | ------------------------------ | ----------------------------------------- | | **Em análise**, sem entrevista | **Aprovar** · **Recusar** | | **Em análise**, com entrevista | **Aprovar para entrevista** · **Recusar** | | **Entrevista** | **Aprovar entrevista** · **Reprovar** | Se outra pessoa da equipe decidir antes, o painel avisa "Outra pessoa decidiu essa whitelist agora há pouco." ### Status | Status | Significado | | --------------- | --------------------------------------------------------------------------------- | | **Respondendo** | A pessoa ainda está respondendo | | **Em análise** | Respostas enviadas, esperando a equipe | | **Entrevista** | Esperando a entrevista | | **Aprovada** | Ganhou o cargo de aprovado e já pode fazer a liberação | | **Recusada** | Recusada ou reprovada (pode tentar de novo depois do tempo em **Tentar de novo**) | | **Expirada** | O tempo acabou ou a pessoa cancelou | ### Números da whitelist O topo da **Visão geral** mostra os números dos últimos dias, comparados aos 7 dias anteriores: entradas (**Quizzes feitos**, **Whitelists enviadas** ou **Pediram entrevista**, conforme o modo), **Nota média no quiz**, **Aguardando entrevista** ou **Na fila da equipe**, **Reprovados**, **Tempo até decidir**, **Aprovadas** (com a taxa de aprovação) e **Liberados**. ## Resultado no canal e registros | Campo | O que faz | Padrão | | ------------------------ | ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- | | **Anunciar o resultado** | Posta uma mensagem num canal quando a whitelist é aprovada ou reprovada, marcando a pessoa | Desligado | | **Canal dos resultados** | Onde o bot posta as aprovações e reprovações | Nenhum | | **Aprovada** | Texto da aprovação | "{membro}, sua **WHITELIST** foi **APROVADA** no nosso servidor, parabéns e seja bem-vindo! 🎉" | | **Reprovada** | Texto da reprovação. {motivo} vira a nota ou o motivo | "{membro}, sua **WHITELIST** foi **REPROVADA** no nosso servidor. **MOTIVO:** *{motivo}*" | | **Canal de logs** | Opcional. Aprovações, recusas, entrevistas e liberações | Nenhum | O **Resultado no canal** não existe no modo **Só liberação**. O ícone do pacote do bot entra na frente de cada mensagem. ## Liberação A liberação é **automática**: quem foi aprovado manda o ID do jogo pelo painel e o bot libera na hora, sem ninguém da equipe precisar fazer nada. No modo **Só liberação**, qualquer pessoa usa o painel. Configure em **Discord → Whitelist → Liberação**. ### Painel | Campo | O que faz | Padrão | | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | | **Canal** | Onde fica o painel com o botão de liberação | Nenhum (obrigatório com a whitelist ativa) | | **Cargo de quem foi aprovado** | Só quem tem esse cargo usa o painel. O bot dá o cargo a quem passa na whitelist (em **Só entrevista**, a equipe dá depois da entrevista), e ele sai quando o ID é liberado. Não existe em **Só liberação** | Nenhum (obrigatório) | | **Marcar quem foi aprovado** | Quando a whitelist é aprovada, o bot marca a pessoa neste canal e apaga a mensagem logo depois: o canal fica destacado | Desligado | | **Título, texto, botão e imagem** | Textos do painel | Título "Liberação", botão "Liberar meu ID" | ### Formulário | Campo | O que faz | Padrão | | ------------------------------ | ---------------------------------------------------------------------------------------------------------------- | ------ | | **Pedir o nome do personagem** | Além do ID, o formulário pede o nome do personagem (até 60 caracteres). Com ele, o bot troca o apelido da pessoa | Ligado | | **Um ID por conta** | Recusa um ID que já foi liberado para outra conta do Discord | Ligado | O ID tem até 12 caracteres e só números (por exemplo, `1234`). ### Ao liberar Na hora, a pessoa ganha o cargo de liberado, perde o de aprovado, tem o apelido trocado e, com o servidor conectado, é liberada na cidade. | Campo | O que faz | Padrão | | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | | **Cargo de quem foi liberado** | O acesso à cidade | Nenhum (obrigatório com a whitelist ativa) | | **Cargo a remover** | Opcional. O bot tira esse cargo de quem é liberado (um cargo de "não liberado", por exemplo) | Nenhum | | **Formato do apelido** | O apelido que o bot coloca. Digite `/` para inserir {personagem}, {id} ou {nome}. Até 60 caracteres; o apelido final é cortado em 32. Não funciona com o dono do servidor nem com cargos acima do bot | `{personagem} \| {id}` | | **Mensagem** | Aparece para a pessoa assim que o ID é liberado, com o ID e o apelido embaixo | "Tudo pronto, {membro}! Seu ID foi liberado em **{servidor}**. Bom jogo!" | Exemplo: com o formato padrão, o personagem "Carlos Andrade" e o ID `1234`, o apelido vira `Carlos Andrade | 1234`. ### Comando /liberar A equipe usa `/liberar` no Discord para liberar um ID na hora, e `/remover` para tirar a whitelist. | Campo | O que faz | Padrão | | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | --------------------------- | | **Cargos que podem usar** | Até 10 cargos da equipe que podem usar `/liberar` e `/remover`. Administradores e quem pode gerenciar o servidor sempre podem | Nenhum (só administradores) | | Comando | Opções | O que faz | | ---------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | `/liberar` | `id` (o ID ou token do jogo, até 12 caracteres), `membro` | Libera o ID na cidade. Com `membro`, o bot também dá o cargo de liberado e passa a tirar a whitelist se a pessoa sair do Discord | | `/remover` | `id`, `membro` (informe um ou os dois) | Tira a whitelist do ID ou do membro e o cargo de liberado | Sem o servidor conectado, informe o `membro`: o bot só dá (ou tira) o cargo. Veja todos os comandos em [Comandos](https://fivedash.fivex.gg/docs/pt/discord/commands). ## Liberação no jogo Com o recurso `fivedash` instalado e o servidor conectado, o cartão **Na cidade** mostra **Servidor conectado** e a liberação também **libera o ID no jogo**. Sem conexão, a whitelist fica só no Discord (cargos e apelido). | Campo | O que faz | Padrão | | --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | | **Tirar a whitelist de quem for expulso ou banido** | Expulso ou banido do Discord (pelo `/kick`, pelo `/ban`, pela proteção ou à mão), perde a whitelist na cidade e, se estiver jogando, é desconectado | Ligado | | **Tirar a whitelist de quem sair do Discord** | Qualquer saída do servidor do Discord, até por conta própria, tira a whitelist na cidade e desconecta quem estiver jogando | Ligado | O que a pessoa manda na liberação depende da framework da cidade, que o recurso detecta sozinho: | Framework | O que a pessoa informa | | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Creative Network Enchanted | O ID do jogo (**Seu ID no jogo**) ou, se a cidade libera por token, o token (**Seu token do jogo**) | | vRP / vRPex | O ID do jogo | | QBCore, Qbox, ESX (`esx_whitelist`) | Nada além do nome do personagem: a cidade encontra a pessoa pelo Discord. Ela precisa tentar entrar no servidor uma vez, com o Discord aberto, antes de liberar | | ox_core | Sem whitelist pelo FiveDash ainda: a liberação continua dando o cargo no Discord | Detalhes por framework em [Frameworks](https://fivedash.fivex.gg/docs/pt/developers/frameworks). | Status no jogo | Significado | | -------------- | --------------------------------------------------------------------------------------------- | | **Na fila** | Esperando o servidor liberar o ID na cidade (servidor offline: a liberação espera ele voltar) | | **Na cidade** | Liberado no jogo | | **Falhou** | O servidor não conseguiu liberar o ID na cidade. Libere pelo jogo | | **Removido** | Saiu do Discord e perdeu a whitelist na cidade | > Se o cartão mostrar > > **whitelist no jogo indisponível** > > , a whitelist da framework não está ligada na cidade. Os avisos em > > **Servidor → Conexão com o jogo** > > dizem o que falta. Até lá, a liberação só dá o cargo no Discord. ### Liberados Na **Visão geral**, a lista **Liberados** mostra cada liberação com o ID, o personagem, o apelido, o status no jogo e, se for o caso, "Pulou a whitelist com o codiguinho …". Busque por nome, personagem, ID do jogo ou codiguinho e filtre por código. ## Codiguinhos Codiguinhos deixam alguém pular a whitelist: para parceiros, sorteios ou quem a equipe quiser liberar. A pessoa digita o código num painel próprio e ganha o cargo de aprovado na hora. Existem nos modos **Análise manual** e **Só entrevista**, na aba **Codiguinhos**. ### Painel do codiguinho | Campo | O que faz | Padrão | | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | | **Usar codiguinhos** | Posta um painel num canal só dele, com o botão para digitar o código | Desligado | | **Canal do painel** | Onde fica o botão para usar o codiguinho | Nenhum (obrigatório com a whitelist ativa) | | **E a entrevista?** | Só em **Análise manual** com entrevista. **Pula a entrevista**: ganha o cargo de aprovado na hora. **Vai para a entrevista**: entra na fila, como quem teve as respostas aprovadas | **Pula a entrevista** | | **Título, texto, botão e imagem** | Textos do painel e da resposta **Aceito** | Título "Codiguinho", botão "Usar codiguinho" | O codiguinho sempre pula as perguntas. Em **Só entrevista**, ele pula a entrevista também. ### Gerar códigos ### Abra o gerador Em **Discord → Whitelist → Codiguinhos**, role até **Códigos** e clique em **Gerar códigos**. ### Escolha o tipo **Vários aleatórios** (com **Quantidade** e **Prefixo** opcional) ou **Um personalizado** (por exemplo, `PARCEIRO-VIP`). ### Defina limite, validade e nota Escolha o **Limite de usos**, a **Validade** e, se quiser, uma **Nota** para lembrar para quem foi. ### Crie e copie Clique em **Gerar 10 códigos** (ou **Criar código**). Use **Copiar todos** e mande para quem vai usar. Clique em **Concluir**. | Campo | O que faz | Padrão | | ------------------ | -------------------------------------------------------------------------------------------------------------- | ----------------- | | **Tipo de código** | **Vários aleatórios** ou **Um personalizado** | Vários aleatórios | | **Quantidade** | Quantos códigos aleatórios gerar (1 a 50) | 10 | | **Prefixo** | Opcional. Até 10 letras, números ou hífens, como `CIDADE`. Os códigos ficam como `CIDADE-7KQ2M9XA` | Vazio | | **Código** | Personalizado: de 3 a 24 letras, números ou hífens | Vazio | | **Limite de usos** | **Uma** pessoa, **Até um limite** (até 10.000 pessoas) ou **Sem limite**. Cada pessoa usa um código uma vez só | Uma | | **Validade** | **Sem validade**, 1 dia, 7 dias, 30 dias ou 90 dias | Sem validade | | **Nota** | Só a equipe vê (até 80 caracteres) | Vazio | Os códigos aleatórios não usam `0`, `O`, `1`, `I` nem `L`, para ninguém confundir ao digitar. Maiúsculas e espaços não importam na hora de digitar. ### Gerenciar códigos Na lista **Códigos**, busque por código ou nota e filtre por **Ativos**, **Esgotados**, **Expirados** ou **Desativados**. No menu de cada código: **Copiar código**, **Ver quem usou**, **Desativar** / **Reativar** e **Excluir**. Tudo isso exige **Gerenciar**. | Status | Significado | | -------------- | ---------------------------------- | | **Ativo** | Pode ser usado | | **Esgotado** | Chegou ao limite de usos | | **Expirado** | Passou da validade | | **Desativado** | A equipe desativou (pode reativar) | Excluir um código tira ele da lista junto com quem usou. As liberações feitas com ele continuam marcadas. ## Mensagens e visual Cada aba tem dois atalhos: **Mensagens** (textos e imagens) e **Embed**. ### Mensagens | Mensagem | Quando aparece | Padrão | | ----------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- | | **Painel** (whitelist) | O painel público com o botão | Título "Whitelist", botão "Fazer whitelist" | | **Resposta** | Ao terminar o quiz (com a nota) ou ao enviar as respostas | Texto do bot | | **Entrevista** | Na DM de quem vai para a entrevista | Ver a seção **Entrevista** | | **Aprovada** | Na DM quando a whitelist é aprovada, com o link da liberação | "Parabéns, {membro}! Você foi aprovado na whitelist de **{servidor}**. Agora é só fazer a liberação com o seu ID do jogo." | | **Recusada** | Na DM quando a whitelist é recusada, com o motivo embaixo | "Sua whitelist em **{servidor}** não foi aprovada desta vez, {membro}." | | **Painel** (liberação) | O painel de liberação | "Passou na whitelist? Entre na cidade uma vez, pegue o seu ID e mande aqui. A liberação é na hora." | | **Liberado** | Para a pessoa assim que o ID é liberado | Ver a seção **Ao liberar** | | **Painel** (codiguinho) | O painel do codiguinho | "Ganhou um codiguinho da equipe? Use o botão abaixo para resgatar e pular a whitelist." | | **Aceito** | Quando o código vale, com o link da liberação | "Codiguinho aceito, {membro}! Você pulou a whitelist de **{servidor}**. Agora é só fazer a liberação com o seu ID do jogo." | Limites: título até 80 caracteres, texto até 1.500, botão até 40. Imagens opcionais em PNG, JPG, WebP ou GIF de até 1 MB, largas (2:1). Variáveis (digite `/` no campo para inserir): | Variável | O que vira | Onde funciona | | -------------- | ---------------------------------------------- | ----------------------------------- | | `{membro}` | Marca a pessoa | DMs, respostas e resultado no canal | | `{servidor}` | O nome do servidor do Discord | Todos os textos | | `{motivo}` | O motivo da recusa (ou "Motivo não informado") | Resultado no canal | | `{personagem}` | O nome do personagem do formulário | Formato do apelido | | `{id}` | O ID no jogo | Formato do apelido | | `{nome}` | O nome da pessoa no Discord | Formato do apelido | ### Embed | Campo | O que faz | Padrão | | ------------------------- | ------------------------------------------------------------------------------------ | ---------- | | **Cor** | A barra lateral dos painéis, das respostas e das DMs. As recusas continuam vermelhas | Cor do bot | | **Cabeçalho do servidor** | Nome e ícone do servidor no topo dos painéis | Ligado | | **Miniatura** | Opcional. Imagem quadrada à direita do painel | Nenhuma | | **Rodapé** | Opcional. Texto (até 100 caracteres) com um ícone do pacote do bot à esquerda | Vazio | ## Perguntas frequentes **A pessoa mandou o ID e o bot disse que ele não existe na cidade. E agora?** A cidade não encontrou esse ID. A pessoa precisa entrar no servidor uma vez, conferir o ID que aparece e tentar de novo. Em QBCore, Qbox e ESX, ela precisa tentar entrar com o Discord aberto no computador antes de liberar. **O bot não deu o cargo de acesso. Por quê?** O cargo do bot está abaixo do cargo que ele tenta dar. Em **Configurações do servidor → Cargos** no Discord, arraste o cargo do bot para cima dos cargos da whitelist. **Posso liberar alguém sem whitelist?** Sim. Use `/liberar` no Discord (equipe com os cargos em **Cargos que podem usar**) ou gere um codiguinho nos modos **Análise manual** e **Só entrevista**. **O que acontece se o servidor FiveM estiver desligado na hora da liberação?** A pessoa ganha o cargo no Discord normalmente, e a liberação fica **Na fila**. O ID é liberado na cidade assim que o servidor voltar. **Quanto tempo a pessoa espera para tentar de novo?** O tempo de **Tentar de novo** (padrão: 30 min). O bot mostra quando ela pode tentar. ## Próximos passos [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot)Conecte o bot e ajuste o perfil e os emojis. [Comandos](https://fivedash.fivex.gg/docs/pt/discord/commands)Todos os comandos, inclusive /liberar e /remover. [Instalar o recurso](https://fivedash.fivex.gg/docs/pt/getting-started/install-resource)Libere o ID direto no jogo. [Moderação](https://fivedash.fivex.gg/docs/pt/discord/moderation)/kick e /ban, que também podem tirar a whitelist.