# Sugestões Transforme cada mensagem de um canal do Discord em uma sugestão numerada, com votos, tópico de discussão e decisão da equipe pelo painel. Source: https://fivedash.fivex.gg/docs/pt/discord/suggestions Toda cidade tem morador com ideia boa. Com **Sugestões**, cada mensagem que um membro manda no canal escolhido vira uma sugestão numerada (#001, #002…): o bot coloca as reações de voto, abre um tópico para a comunidade discutir e guarda tudo no painel. A equipe lê, aprova ou recusa pelo FiveDash, e o jogador recebe o resultado por DM. ## Antes de começar * **Plano:** o módulo **Discord** precisa estar no plano da organização. Sugestões funciona em todos os níveis (Plus, Pro e Ultra). * **Bot conectado:** o bot da cidade precisa estar configurado e dentro do servidor do Discord. Veja [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot). * **Message Content Intent:** sem ela, o Discord entrega as mensagens vazias e as sugestões chegam sem texto. Ative em **Developer Portal → Bot → Privileged Gateway Intents**. * **Permissões do bot no canal:** **Adicionar reações**, **Ver histórico de mensagens**, **Criar tópicos públicos**, **Enviar mensagens em tópicos**, **Gerenciar tópicos** e **Gerenciar mensagens**. Se faltar alguma, a página mostra um aviso com a lista. * **Nível de acesso** (em **Configurações → Membros**, área **Sugestões**): | Nível | O que libera | | -------------- | ---------------------------------------------------------------------------------------- | | **Ver** | Sugestões e discussões (lista, votos, tópico copiado e as configurações em modo leitura) | | **Gerenciar** | Aprovar e recusar (também **Marcar como lida**) | | **Configurar** | Canal, votos e mensagens; salvar configurações e **Limpar sugestões** | O menu fica em **Discord → Sugestões** (`///discord/sugestoes`). A página tem duas abas: **Sugestões** (a lista) e **Configurações**. ## Ligar as sugestões ### Abra a página Vá em **Discord → Sugestões** e clique na aba **Configurações**. ### Escolha o canal Em **Canal**, escolha o **Canal das sugestões**. Tudo que um membro mandar nesse canal vira uma sugestão numerada. ### Escolha os emojis de voto Em **Votos**, clique em **Gostei** e **Não gostei** para trocar os emojis. Você pode usar emojis comuns, do pacote do bot ou do próprio servidor. Os dois precisam ser diferentes. ### Ajuste a discussão Em **Discussão**, deixe ligado **Abrir um tópico em cada sugestão** e **Avisar o jogador por DM**, se quiser. ### Ligue o módulo e salve No topo da página, ligue a chave (ela mostra **Ativas**). Clique em **Salvar** na barra que aparece embaixo. > Use um canal só para sugestões. Qualquer mensagem com texto ou anexo nesse canal vira sugestão, inclusive de quem é da equipe. ## Como funciona no Discord 1. Um membro escreve no **Canal das sugestões** (texto, imagem ou vídeo; até 10 anexos são guardados). 2. O bot dá o próximo número e coloca as duas reações de voto na própria mensagem do membro. 3. Com **Abrir um tópico em cada sugestão** ligado, o bot abre um tópico com o nome `#001 · começo do texto` e posta a **Primeira mensagem do tópico** (se ela tiver texto ou imagem). 4. Os votos de todos contam, menos a reação do próprio bot. O painel relê os votos direto da mensagem quando você abre a sugestão. 5. Se o membro editar a mensagem, o texto no painel acompanha. Se a mensagem for apagada, a sugestão continua no painel, marcada como **Saiu do canal**. 6. O tópico arquiva sozinho depois de 7 dias sem mensagens (o maior prazo do Discord). ## Analisar e decidir ### Abra a lista Na aba **Sugestões**, use os cartões **Novas**, **Lidas**, **Aprovadas** e **Recusadas** para filtrar, a busca (**Buscar por texto, membro ou número**) e **Ordenar** (**Mais recentes** ou **Mais votadas**). ### Abra a sugestão Clique na linha. O painel lateral mostra o texto, os anexos, os **Votos** (com a porcentagem que aprova) e a **Discussão** copiada do tópico. Use **Atualizar do Discord** para reler votos e mensagens na hora, ou **Abrir no Discord**. ### Decida * **Marcar como lida**: muda o status para **Lida**, sem mandar nada para o jogador. * **Aprovar**: abre o campo **Mensagem para o jogador (opcional)**; confirme em **Aprovar sugestão**. * **Recusar**: abre o campo **Motivo da recusa** (obrigatório); confirme em **Recusar sugestão**. Ao aprovar ou recusar, o bot posta a decisão no tópico (com a mensagem ou o motivo), guarda uma cópia da discussão, tranca e arquiva o tópico e, se **Avisar o jogador por DM** estiver ligado, manda a DM de aprovada ou recusada. Uma sugestão decidida não pode ser decidida de novo. > Precisa do nível **Gerenciar** em **Sugestões**. Com só **Ver**, o painel mostra "Seu acesso não permite decidir sugestões." ### Status | Status | Quando | O jogador recebe algo? | | ------------ | -------------------------------- | --------------------------------------------- | | **Nova** | A sugestão acabou de chegar | Não | | **Lida** | Alguém usou **Marcar como lida** | Não | | **Aprovada** | Alguém aprovou | Aviso no tópico e DM (se ligada) | | **Recusada** | Alguém recusou, com motivo | Aviso no tópico e DM com o motivo (se ligada) | ### Colunas da lista | Coluna | O que mostra | | ------------ | ------------------------------------------------------------------- | | **Sugestão** | Número, autor, começo do texto e se tem imagem, vídeo ou anexo | | **Votos** | Gostei e não gostei, com a porcentagem que aprova | | **Status** | Nova, Lida, Aprovada ou Recusada, e quem decidiu (**Por** e o nome) | | **Enviada** | Quando chegou | A lista mostra 10, 20 ou 50 por página (**Por página**). ## Configurações ### Canal | Campo | O que faz | Padrão | | -------------------------------------------- | -------------------------------------------------------------- | ----------- | | Chave no topo (**Ativas** / **Desativadas**) | Liga ou desliga o módulo. Ligado, exige um canal | Desativadas | | **Canal das sugestões** | Onde cada mensagem vira uma sugestão numerada | Nenhum | | **Votos** → **Gostei** | Reação de voto a favor (emoji comum, do pacote ou do servidor) | ✅ | | **Votos** → **Não gostei** | Reação de voto contra; precisa ser diferente de **Gostei** | ❌ | ### Discussão | Campo | O que faz | Padrão | | ------------------------------------ | --------------------------------------------------------------------------- | ------ | | **Abrir um tópico em cada sugestão** | Abre um tópico embaixo de cada sugestão; a conversa aparece no painel | Ligado | | **Avisar o jogador por DM** | Ao aprovar ou recusar, o jogador recebe o resultado (e o motivo) no privado | Ligado | ### Limpeza | Campo | O que faz | Padrão | | ---------------------------------- | ------------------------------------------------------------------------------------------------------- | --------- | | **Limpar o canal automaticamente** | Tira do canal as sugestões antigas (mensagem e tópico). No painel elas continuam, com a discussão salva | Desligado | | **Sugestões com mais de** | Idade para limpar: 7 dias, 15 dias, 1 mês, 2 meses, 3 meses ou 6 meses | 1 mês | A limpeza roda em segundo plano e tira poucas sugestões por vez, das mais antigas para as mais novas. ## Personalização Na coluna da direita, em **Personalização**, há uma prévia no Discord (abas **No canal**, **Aprovada** e **Recusada**) e dois atalhos. Cada um tem **Restaurar padrão**. ### Mensagens Clique em **Mensagens** para abrir **Personalizar mensagens**. | Campo | O que faz | Padrão | | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | **Primeira mensagem do tópico** | O que o bot escreve ao abrir o tópico. Sem texto e sem imagem, o tópico abre sem mensagem do bot. Até 1000 caracteres | `{{info}} Use este tópico para conversar sobre a sugestão de {membro}. Quando a equipe decidir, o resultado aparece aqui.` | | **Imagem** (Tópico) | Imagem larga (2:1) embaixo da primeira mensagem | Nenhuma | | **DM quando a sugestão é aprovada** | DM de aprovada. `{motivo}` é a mensagem opcional da equipe. Até 1500 caracteres | `{{success}} Sua sugestão **#{numero}** em **{servidor}** foi aprovada! Obrigado por ajudar a cidade a ficar melhor.` | | **Imagem** (Aprovada) | Imagem larga (2:1) no fim da DM | Nenhuma | | **DM quando a sugestão é recusada** | DM de recusada. `{motivo}` é o motivo (sempre pedido). Até 1500 caracteres | `{{error}} Sua sugestão **#{numero}** em **{servidor}** foi recusada.` + nova linha + `**Motivo:** {motivo}` | | **Imagem** (Recusada) | Imagem larga (2:1) no fim da DM | Nenhuma | As imagens podem ser PNG, JPG, WebP ou GIF de até 1 MB. Com a DM ligada, as mensagens de aprovada e recusada não podem ficar vazias. #### Variáveis | Variável | O que vira | | ------------ | ---------------------------------- | | `{membro}` | Marca quem sugeriu (@Jogador) | | `{nome}` | O nome de quem sugeriu | | `{numero}` | O número da sugestão | | `{sugestao}` | O começo do texto da sugestão | | `{servidor}` | O nome do servidor do Discord | | `{motivo}` | O que a equipe escreveu ao decidir | ### Embed Clique em **Embed** para abrir **Personalizar embed**. | Campo | O que faz | Padrão | | ------------------ | ------------------------------------------------------- | -------------------- | | **Cor** (Tópico) | A barra lateral da primeira mensagem do bot no tópico | **Cor do bot** | | **Cor** (Aprovada) | A barra da DM de aprovada e do aviso que fecha o tópico | Verde (`#57F287`) | | **Cor** (Recusada) | A barra da DM de recusada e do aviso que fecha o tópico | Vermelho (`#ED4245`) | ## Limpar sugestões O botão **Limpar sugestões**, no topo da página, apaga todas as sugestões do painel, com as decisões e as discussões copiadas, e a numeração volta para o #001. As mensagens e os tópicos que já estão no Discord continuam lá, mas os votos neles deixam de contar. > **Limpar sugestões** não pode ser desfeito. Precisa do nível **Configurar**. ## Avisos na página | Aviso | O que fazer | | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | Falta a **Message Content Intent** | Ative em **Developer Portal → Bot → Privileged Gateway Intents** | | "O bot precisa de mais permissões para as sugestões" | Dê as permissões listadas ao cargo do bot em **Configurações do servidor → Cargos** no Discord | | "O serviço que lê o canal está fora do ar" | Aguarde: novas mensagens só viram sugestões quando ele voltar | ## Perguntas frequentes **A sugestão chegou sem texto. Por quê?** O bot está sem a **Message Content Intent**. Ative no Developer Portal; a página mostra o aviso enquanto ela faltar. **Apagar a mensagem no Discord apaga a sugestão?** Não. A sugestão fica no painel com o que já foi guardado e aparece como **Saiu do canal**. **Posso mudar a decisão depois?** Não. Uma sugestão **Aprovada** ou **Recusada** fica decidida. **Lida** ainda pode ser aprovada ou recusada. **O jogador não recebeu a DM.** Confira se **Avisar o jogador por DM** está ligado. Se o membro fecha as DMs do servidor, o Discord recusa a mensagem e não há o que fazer. ## Próximos passos [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot)Conecte o bot, ative as intents e escolha o pacote de emojis. [Formulários](https://fivedash.fivex.gg/docs/pt/discord/forms)Receba respostas estruturadas com aprovação da equipe. [Equipe e permissões](https://fivedash.fivex.gg/docs/pt/dashboard/team-and-permissions)Dê a cada pessoa o nível certo em Sugestões. [Comandos](https://fivedash.fivex.gg/docs/pt/discord/commands)Todos os comandos do bot da cidade.