# Bot Crie o aplicativo no Discord, conecte o token, convide o bot para o servidor da cidade e ajuste nome, avatar, cor e emojis. Source: https://fivedash.fivex.gg/docs/pt/discord/bot O bot do FiveDash é **o bot da sua cidade**: você cria o aplicativo no Discord, com o nome e o avatar da cidade, e o FiveDash faz ele funcionar. Esta página mostra como criar o aplicativo, conectar o token, convidar o bot para o servidor do Discord e cuidar do perfil e da aparência das mensagens. É para quem configura o bot da organização. ## Antes de começar * O módulo **Discord** precisa estar no plano da organização. Veja [Planos e cobrança](https://fivedash.fivex.gg/docs/pt/getting-started/plans-and-billing). * Você precisa de um servidor FiveM adicionado no painel. O bot fica ligado a esse servidor. * Nível de acesso na página **Bot** (em **Configurações → Membros**): | Nível | O que permite | | -------------- | ------------------------------------------------------------------------------------------------------------ | | **Ver** | Perfil e aparência do bot (só leitura). A página mostra "Seu acesso permite só ver o bot." | | **Configurar** | Conectar, trocar token e mudar o perfil. Também é o nível que faz a configuração inicial e desconecta o bot. | * No Discord, quem convida o bot precisa da permissão **Gerenciar servidor** no servidor da cidade. ## Crie o aplicativo e conecte o token Abra **Discord** na barra lateral. Enquanto o bot não está pronto, a página mostra **Conecte o bot da sua cidade**. O primeiro passo é **Crie e conecte o bot**. ### Crie o aplicativo no Developer Portal Clique em **Abrir Developer Portal**. No Developer Portal do Discord, clique em **New Application** e dê o nome da sua cidade, por exemplo "Cidade Exemplo". ### Copie o token Na aba **Bot** do aplicativo, clique em **Reset Token** e copie o token. ### Ative os intents Ainda na aba **Bot**, em **Privileged Gateway Intents**, ative **Server Members Intent** e **Message Content Intent** e salve as alterações no Discord. ### Cole o token no painel De volta ao FiveDash, cole o token em **Token do bot** e clique em **Conectar bot**. O painel mostra **Verificando token…** e depois **Bot conectado**. > Guardamos o token com criptografia. Depois de salvo, ninguém consegue vê-lo, nem você. Se precisar de um novo, gere outro em **Bot → Reset Token** no Developer Portal. O painel aceita o token mesmo com aspas, espaços ou o prefixo `Bot ` na frente. Mensagens que podem aparecer: | Mensagem | O que fazer | | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | | Isso não parece um token de bot. | Copie o token na aba **Bot** do Developer Portal, não o Client Secret nem o Application ID. | | O Discord recusou esse token. | Gere um novo em **Bot → Reset Token** e cole de novo. | | Esse token não é de um bot. | Use o token da aba **Bot** de um aplicativo. | | Esse bot já está conectado a outro servidor do FiveDash. | Cada bot fica em um só servidor do FiveDash. Crie outro aplicativo para este servidor. | | Esse token é de outro bot. Desconecte o bot atual antes de trocar. | Depois da configuração concluída, só dá para trocar pelo token do mesmo bot. Para usar outro bot, desconecte o atual primeiro. | ### Intents que o bot usa | Intent | Obrigatório | Para que serve | | -------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Server Members Intent** | Sim | Ver quem está no servidor: entradas, saídas, verificação, boas-vindas e cargos. Sem ele, não dá para concluir a configuração. | | **Message Content Intent** | Recomendado | Ler o texto das mensagens: logs, tickets (inclusive o atendente de IA), sugestões, ponto, divulgações de creators, respostas digitadas da whitelist e as camadas de link e spam da proteção. | O bot não pede o intent de presença. ## Convide o bot para o servidor do Discord O segundo passo é **Adicione ao seu servidor**. ### Abra o convite Clique em **Adicionar ao Discord**. O Discord abre a tela de autorização com as permissões que o bot pede. ### Autorize no servidor da cidade Escolha o servidor do Discord da cidade e autorize. Mantenha as permissões marcadas. ### Volte para o painel Volte para a aba do FiveDash. A lista atualiza sozinha enquanto mostra **Aguardando o bot entrar em um servidor…**. ### Escolha o servidor Em **Onde o bot entrou**, selecione o servidor e clique em **Usar este servidor**. O painel mostra **Configurando o servidor…**, registra os comandos e passa para as verificações. Se o bot não aparece, abra **O bot não aparece?**: * Você precisa da permissão **Gerenciar servidor** no servidor do Discord. * Se outra pessoa criou o aplicativo, ative **Public Bot** na aba **Bot**. * **Requires OAuth2 Code Grant** precisa estar desativado. Com ele ativo, o convite não funciona. * Depois de autorizar, volte para esta aba. A lista atualiza sozinha. Para pôr o bot em outro servidor do Discord ainda durante a configuração, use **Adicionar a outro servidor** ou **Trocar**. Depois da configuração concluída, o painel pede para desconectar o bot antes de trocar de servidor. ### Permissões que o convite pede O convite pede **Administrador** e, junto, cada permissão abaixo. Assim, se alguém desmarcar Administrador na tela do Discord, o bot ainda recebe o resto. Os nomes são os da interface do Discord em português. | Permissão | Conferida no passo 3 | | --------------------------- | ------------------------ | | Ver canais | Sim | | Enviar mensagens | Sim | | Inserir links | Sim | | Anexar arquivos | Sim | | Ver histórico de mensagens | Sim | | Adicionar reações | Sim | | Usar emojis externos | Sim | | Gerenciar mensagens | Sim | | Gerenciar canais | Sim | | Gerenciar cargos | Sim | | Gerenciar apelidos | Sim | | Gerenciar webhooks | Sim | | Expulsar membros | Sim | | Banir membros | Sim | | Castigar membros | Sim | | Criar tópicos públicos | Na página de cada módulo | | Gerenciar tópicos | Na página de cada módulo | | Enviar mensagens em tópicos | Na página de cada módulo | | Ver registro de auditoria | Na página de cada módulo | | Gerenciar servidor | Na página de cada módulo | | Conectar | Na página de cada módulo | | Falar | Na página de cada módulo | Administrador não é obrigatório: a verificação passa se o cargo do bot tiver as 15 permissões marcadas como "Sim". > O bot só consegue dar ou tirar cargos que estão abaixo do cargo dele. Em **Configurações do servidor → Cargos** no Discord, arraste o cargo do bot para cima dos cargos que ele vai gerenciar (verificado, liberado, creators e outros). ## Confira as permissões e conclua O terceiro passo é **Confira as permissões**. O painel confere tudo direto no Discord antes de ligar o bot. | Verificação | Obrigatória | Quando está pendente | | -------------------------- | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | **Permissões no servidor** | Sim | Mostra "Faltam: …" com a lista. Clique em **Atualizar permissões** para autorizar de novo. | | **Server Members Intent** | Sim | Ative em **Bot → Privileged Gateway Intents** e salve. Use **Abrir aba Bot**. | | **Message Content Intent** | Não (**Recomendado**) | Fica em **Atenção**. Ative na mesma tela do Server Members Intent. | | **Endpoint de interações** | Sim, se o Discord recusar | O FiveDash configura sozinho o endereço que recebe os comandos. Se o Discord não validar, clique em **Verificar de novo** em instantes. | | **Comandos /status e /ip** | Sim | Mostra quantos comandos foram registrados. Se falhar, clique em **Adicionar de novo**. | Quando os itens obrigatórios estiverem em **Tudo certo**, clique em **Concluir**. O painel mostra "(nome do bot) está pronto!", sugere digitar `/status` em qualquer canal para testar e oferece **Ir para o painel do bot**. Logo depois, o bot aparece como **Ligando** na visão geral; em alguns minutos fica **Online**. ## Perfil e aparência Abra **Discord → Bot**. A página **Configurações do bot** mostra como o bot aparece no Discord e nas mensagens que envia, com uma **Prévia no Discord** do perfil e de uma resposta. As mudanças só valem depois de **Salvar** na barra que aparece embaixo (**Descartar** desfaz). ### Perfil | Campo | O que faz | Regras | | ------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | | **Nome** | Como o bot aparece no Discord. | De 2 a 32 caracteres. Sem `@`, `#`, `:` ou ` ``` `. Sem a palavra "discord". O Discord deixa trocar 2 vezes por hora. | | **Avatar** | A foto do bot. Abre um recorte quadrado. | PNG, JPG, WebP ou GIF, até 10 MB. GIFs ficam estáticos. **Trocar avatar** / **Remover avatar**. | | **Banner** | A imagem no topo do perfil. | Ideal em 680 × 240. **Trocar banner** / **Remover banner**. | | **Sobre mim** | A bio do perfil do bot. | Até 400 caracteres. Aceita a formatação do Discord: Ctrl+B para negrito, Ctrl+I para itálico. | ### Mensagens | Campo | O que faz | Padrão | | -------------------- | --------------------------------------------------------------------------------------------------------------------- | --------------------------- | | **Cor principal** | A faixa lateral dos embeds e o fundo do pacote **Destaque**. Escolha uma das cores prontas ou **Escolher outra cor**. | `#5865F2` (azul do Discord) | | **Pacote de emojis** | Os ícones das respostas do bot. | **Padrão** | Pacotes de emojis: | Pacote | Como fica | | ------------ | ---------------------------------------------------------------------------------- | | **Padrão** | Os emojis do próprio Discord. | | **Linhas** | Ícones finos, discretos em qualquer tema. | | **Destaque** | Ícones sobre a cor principal do bot. Mudar a **Cor principal** redesenha o pacote. | Os pacotes **Linhas** e **Destaque** são enviados como emojis do seu bot (emojis do aplicativo) e funcionam em qualquer servidor. Se o Discord pedir para esperar, o painel mostra "O Discord pediu para esperar antes de enviar mais emojis. Salve de novo em alguns segundos." ### Seletor de emojis Nos textos dos módulos (painéis, botões, mensagens), o botão **Inserir emoji** abre um seletor com três abas: | Aba | O que tem | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Pacote do bot** | Os ícones do pacote escolhido acima, por categoria (Status, Destaque, Pessoas, Segurança, Comunicação, Jogo, Lugares e clima, Loja e dinheiro, Objetos, Setas e ações). | | **Emojis comuns** | Os emojis padrão, com **Recentes**, categorias e **Tom de pele**. | | **Do servidor** | Os emojis próprios do seu servidor do Discord. Se não houver, adicione em **Configurações do servidor → Emoji** no Discord. | ## Trocar o token ou desconectar Na **Visão geral** do Discord, o menu **Mais opções do bot** (só para quem tem **Configurar** em **Bot**) tem: * **Trocar token**: cole um token novo do mesmo bot e clique em **Salvar token**. Para usar outro bot, desconecte este primeiro. * **Desconectar bot**: os comandos somem, o bot sai do seu servidor do Discord e o token é apagado do FiveDash. Para usá-lo de novo, conecte e convide ele outra vez. > Desconectar apaga do FiveDash as imagens que você enviou para os módulos do bot (painéis, mensagens, provas de moderação e outras). Use só se for trocar de bot de vez. Se o Discord recusar o token salvo (por exemplo, depois de um **Reset Token** no Developer Portal), a visão geral mostra **O Discord recusou o token deste bot** e a página **Bot** não salva mudanças. Gere um token em **Bot → Reset Token** e use **Salvar token novo**. ## Perguntas frequentes **Preciso dar Administrador ao bot?** Não. O convite pede Administrador para facilitar, mas a verificação só exige as 15 permissões da tabela. **Por que o nome do bot não muda?** O Discord só deixa trocar o nome 2 vezes por hora. Se muitas contas já usam o nome, o Discord recusa e o painel pede outro. **O Message Content Intent é obrigatório?** Não para concluir a configuração, mas sem ele o Discord esconde o texto das mensagens. Logs, tickets, sugestões, ponto e a proteção contra links e spam dependem dele. ## Próximos passos [Visão geral do Discord](https://fivedash.fivex.gg/docs/pt/discord/overview)Acompanhe o status do bot e os módulos. [Comandos](https://fivedash.fivex.gg/docs/pt/discord/commands)Todos os comandos de barra que o bot registra. [Verificação](https://fivedash.fivex.gg/docs/pt/discord/verification)Ligue o captcha para quem entra. [Equipe e permissões](https://fivedash.fivex.gg/docs/pt/dashboard/team-and-permissions)Dê o nível Configurar a quem cuida do bot.