Discord
Bot
Crie o aplicativo no Discord, conecte o token, convide o bot para o servidor da cidade e ajuste nome, avatar, cor e emojis.
Crie o aplicativo no Discord, conecte o token, convide o bot para o servidor da cidade e ajuste nome, avatar, cor e emojis.
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.
| 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. |
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.
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”.
Na aba Bot do aplicativo, clique em Reset Token e copie o token.
Ainda na aba Bot, em Privileged Gateway Intents, ative Server Members Intent e Message Content Intent e salve as alterações no Discord.
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.
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. |
| 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.
O segundo passo é Adicione ao seu servidor.
Clique em Adicionar ao Discord. O Discord abre a tela de autorização com as permissões que o bot pede.
Escolha o servidor do Discord da cidade e autorize. Mantenha as permissões marcadas.
Volte para a aba do FiveDash. A lista atualiza sozinha enquanto mostra Aguardando o bot entrar em um 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?:
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.
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 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.
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).
| 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. |
| 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.”
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. |
Na Visão geral do Discord, o menu Mais opções do bot (só para quem tem Configurar em Bot) tem:
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.
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.