Guias14 min de leitura
Bot de Discord para servidor FiveM: verificação e boas-vindas
Crie o bot de Discord da sua cidade FiveM no FiveDash, com o nome e a foto da cidade, e ligue a verificação com captcha e as boas-vindas com cargo automático.
Equipe fiveX
Para ter um bot de Discord para servidor FiveM com o nome e a foto da sua cidade, crie um aplicativo no Discord Developer Portal, cole o token no FiveDash e convide o bot para o servidor do Discord. Antes de ligá-lo, o painel confere as permissões e os intents; depois, você ativa a Verificação, com captcha, e as Boas-vindas, com cargo automático. O bot próprio faz parte do módulo Discord em todos os planos: Plus, Pro e Ultra.
Se você prefere acompanhar pela tela, o vídeo Bot próprio no Discord da sua cidade FiveM, FiveDash #2 mostra a configuração.
O que você precisa antes de começar
- O plano da organização precisa incluir o módulo Discord.
- Adicione um servidor FiveM ao painel. O bot ficará vinculado a ele.
- No FiveDash, tenha o nível Configurar na página Bot, em Configurações → Membros.
- No Discord, quem fizer o convite precisa da permissão Gerenciar servidor no servidor da cidade.
No painel, abra Discord na barra lateral. Até o bot ficar pronto, você verá Conecte o bot da sua cidade, dividido em três etapas: Crie e conecte o bot, Adicione ao seu servidor e Confira as permissões. O processo leva uns cinco minutos.
Passo 1: crie o bot de Discord para o servidor FiveM
- No FiveDash, selecione Abrir Developer Portal.
- No Discord Developer Portal, clique em New Application e use o nome da sua cidade. Por exemplo, "Cidade Exemplo".
- Abra a aba Bot do aplicativo, clique em Reset Token e copie o token.
- Na mesma aba, procure Privileged Gateway Intents. Ative Server Members Intent e Message Content Intent e salve as alterações no Discord.
Quais intents o bot utiliza
| Intent | Obrigatório | Função |
|---|---|---|
| Server Members Intent | Sim | Permite identificar quem está no servidor e acompanhar entradas, saídas, verificação, boas-vindas e cargos. A configuração não pode ser concluída sem ele. |
| Message Content Intent | Recomendado | Permite ler o conteúdo das mensagens. Ele é usado em logs, tickets, incluindo a atendente de IA, sugestões, ponto, divulgações de creators, respostas digitadas da whitelist e nas camadas de proteção contra links e spam. |
O bot não solicita o intent de presença. Os dois intents da tabela são privilegiados, segundo a classificação do Discord, e precisam ser ativados manualmente na aba Bot do aplicativo. Conforme a documentação do Discord, aplicativos com menos de 10.000 usuários podem usar esses intents apenas ativando as chaves. Quando o aplicativo ultrapassa 10.000 usuários únicos nos servidores em que está presente, o Discord exige uma revisão para manter o acesso. O dono do aplicativo recebe o aviso por DM ou e-mail.
Passo 2: salve o token no FiveDash
Volte ao FiveDash, cole o token no campo Token do bot e clique em Conectar bot. Primeiro aparecerá Verificando token… e, em seguida, Bot conectado. O painel aceita o valor mesmo se ele vier com aspas, espaços ou o prefixo Bot .
Caso surja algum erro, siga a orientação correspondente:
| Mensagem exibida | Como resolver |
|---|---|
| Isso não parece um token de bot. | Copie o token da aba Bot do Developer Portal. Não use o Client Secret nem o Application ID. |
| O Discord recusou esse token. | Gere outro token em Bot → Reset Token e cole o novo valor. |
| Esse token não é de um bot. | Utilize o token encontrado na aba Bot de um aplicativo. |
| Esse bot já está conectado a outro servidor do FiveDash. | Um bot só pode ficar vinculado a um servidor do FiveDash. Crie outro aplicativo para usar neste servidor. |
Passo 3: convide o bot para o Discord da cidade
- Clique em Adicionar ao Discord. Será aberta a tela de autorização do Discord com as permissões solicitadas pelo bot.
- Selecione o servidor do Discord da cidade e autorize o convite. Não desmarque as permissões.
- Retorne à aba do FiveDash. Enquanto a mensagem Aguardando o bot entrar em um servidor… estiver visível, a lista será atualizada automaticamente.
- Em Onde o bot entrou, escolha o servidor e clique em Usar este servidor. O painel exibirá Configurando o servidor… e fará o registro dos comandos.
Se o bot não aparecer, abra O bot não aparece? e verifique três pontos: você precisa ter Gerenciar servidor no Discord; se outra pessoa criou o aplicativo, Public Bot deve estar ativado na aba Bot; e Requires OAuth2 Code Grant precisa estar desativado, pois o convite não funciona com essa opção ligada.
O convite solicita Administrador para simplificar o processo, mas essa permissão não é obrigatória. A conferência será aprovada se o cargo do bot tiver as 15 permissões exigidas pelo painel, como Gerenciar cargos, Gerenciar mensagens, Expulsar membros e Banir membros. Consulte a lista completa na página do Bot nas docs.
Passo 4: revise as permissões e teste a conexão
Na etapa Confira as permissões, o FiveDash consulta o Discord e faz todas as conferências antes de ativar o bot:
| Conferência | Obrigatória | O que fazer se estiver pendente |
|---|---|---|
| Permissões no servidor | Sim | O painel mostra "Faltam: …" e a lista de permissões. Clique em Atualizar permissões para refazer a autorização. |
| Server Members Intent | Sim | Ative o intent em Bot → Privileged Gateway Intents e salve. O atalho Abrir aba Bot leva você até lá. |
| Message Content Intent | Não (Recomendado) | O item fica em Atenção. Ative-o na mesma tela do Server Members Intent. |
| Endpoint de interações | Sim, se o Discord recusar | O FiveDash faz a configuração automaticamente. Se o Discord não validar, aguarde alguns instantes e clique em Verificar de novo. |
| Comandos /status e /ip | Sim | O painel informa quantos comandos foram registrados. Se o registro falhar, clique em Adicionar de novo. |
Quando todos os itens obrigatórios estiverem marcados como Tudo certo, clique em Concluir. O painel confirmará que o bot está pronto, sugerirá digitar /status em qualquer canal para testá-lo e mostrará a opção Ir para o painel do bot. Na visão geral, ele aparecerá primeiro como Ligando e, depois de alguns minutos, como Online.
Para repetir essa conferência mais tarde, acesse Discord → Visão geral e clique em Verificar conexão. Permissões, intents, endpoint e comandos serão verificados novamente. O status atual do bot também aparece nessa página:
| Status | Comportamento |
|---|---|
| Online | O bot está conectado ao Gateway. Entradas, sugestões, proteção e salas de entrevista funcionam na hora. |
| Ligando | O bot ainda está entrando no Gateway. Isso leva alguns minutos, e a página se atualiza sozinha. |
| Offline | Os comandos continuam respondendo, mas entradas, sugestões, proteção e salas de entrevista ficam paradas até o bot retornar. |
| Token recusado | O Discord não aceitou o token. Os comandos deixam de responder até que um novo token seja salvo. |
Se o token salvo for recusado pelo Discord, como pode acontecer depois de um Reset Token no Developer Portal, gere outro token e utilize Salvar token novo.
Passo 5: ajuste nome, imagem, cor e emojis
Acesse Discord → Bot. Em Configurações do bot, a seção Prévia no Discord mostra o perfil e uma resposta do bot. As alterações só entram em vigor depois que você clica em Salvar, na barra inferior. Para desfazê-las, use Descartar.
| Campo | Função | Regras e valor padrão |
|---|---|---|
| Nome | Define o nome exibido pelo bot no Discord. | Deve ter de 2 a 32 caracteres e não pode conter a palavra "discord". O Discord permite duas trocas por hora. |
| Avatar | Define a foto do bot, usando um recorte quadrado. | Aceita PNG, JPG, WebP ou GIF de até 10 MB. GIFs são exibidos de forma estática. |
| Banner | Define a imagem exibida no topo do perfil. | O tamanho ideal é 680 × 240. |
| Sobre mim | Define a biografia do perfil. | Aceita até 400 caracteres e a formatação do Discord. |
| Cor principal | Define a faixa lateral dos embeds e o fundo do pacote Destaque. | O padrão é #5865F2, o azul do Discord. |
| Pacote de emojis | Define os ícones usados nas respostas do bot. | As opções são Padrão, Linhas e Destaque. |
O pacote Padrão utiliza os emojis do próprio Discord. Linhas reúne ícones finos e discretos, adequados a qualquer tema. Destaque coloca os ícones sobre a cor principal; ao mudar a Cor principal, o pacote é redesenhado. Os pacotes Linhas e Destaque são enviados como emojis do seu bot e podem ser usados em qualquer servidor.
Ao editar textos dos módulos, clique em Inserir emoji para abrir três abas: Pacote do bot, Emojis comuns e Do servidor. A última reúne os emojis próprios do seu Discord.
Verificação: configure captcha, cargos e idade mínima
A Verificação funciona como a portaria do Discord da cidade. O bot publica um painel com o botão Responder. Ao clicar, a pessoa recebe uma mensagem visível apenas para ela, com uma imagem de captcha e um menu contendo 5 códigos. O código expira em 3 minutos. Se a resposta estiver certa, ela recebe o Cargo de verificado. Se errar, verá Tentar de novo e o número de tentativas restantes.
- Acesse Discord → Verificação.
- Em Painel → Canal, escolha onde o bot publicará a mensagem com o botão.
- Em Cargos, selecione o Cargo de verificado. Se você utiliza um cargo de "não verificado", escolha-o em Remover cargo. Assim, ele será retirado de quem passar no captcha. Os dois cargos precisam ser diferentes.
- Na seção Proteção, ainda na mesma página, configure Tentativas, Bloqueio, Ao esgotar as tentativas e Idade mínima da conta.
- Ative a chave no topo, que mudará de Desativada para Ativa, e clique em Salvar na barra inferior.
- Clique em Publicar painel. A confirmação Painel publicado aparecerá, e o botão passará a se chamar Reenviar painel.
| Campo | Opções disponíveis | Padrão |
|---|---|---|
| Tentativas | 1, 2, 3, 4, 5 ou 10 erros seguidos antes do bloqueio | 3 tentativas |
| Bloqueio | 5 min, 10 min, 30 min, 1 h, 6 h ou 1 dia sem novas tentativas | 10 min |
| Ao esgotar as tentativas | Só bloquear ou Expulsar do servidor, caso em que a pessoa pode retornar com um novo convite | Só bloquear |
| Idade mínima da conta | Sem limite, 1, 3, 7, 14 ou 30 dias | Sem limite |
A Idade mínima da conta impede a entrada de contas do Discord criadas recentemente, comuns em ataques. Quem não atinge o tempo exigido vê "Sua conta é nova demais para entrar aqui", junto com o número de dias necessário. Para usar Expulsar do servidor, o bot precisa da permissão Expulsar membros. Se quiser registrar todas as ocorrências, escolha um Canal de registros. Nele, o bot informará cada verificação, bloqueio e conta barrada, incluindo a data de criação da conta.
Depois que o painel estiver publicado, salvar novas configurações o atualizará automaticamente. Se você mudar o canal, o bot publicará a mensagem no novo local e apagará a anterior.
Boas-vindas: configure mensagens, cargo inicial, saídas e teste
As Boas-vindas recebem cada pessoa que entra no Discord com uma mensagem no canal e um cargo imediato. Se você quiser, também podem enviar uma mensagem privada com botões. Para funcionar, o módulo precisa do Server Members Intent ativado no Developer Portal.
- Acesse Discord → Boas-vindas.
- Em Mensagem → Canal, escolha o Canal das boas-vindas.
- Em Cargo → Cargo ao entrar, selecione o cargo que será dado imediatamente a todas as pessoas que entrarem. Essa configuração é opcional.
- Em Despedida, ative Avisar quando alguém sair e escolha o Canal da despedida. Como alternativa, deixe Mesmo das boas-vindas. Essa configuração também é opcional.
- Na coluna da direita, clique em Mensagens (Textos e imagens) para editar a mensagem de boas-vindas, a despedida e a mensagem privada. Depois, clique em Aplicar.
- Coloque a chave do topo em Ativa e clique em Salvar na barra inferior.
- Clique em Enviar teste. O bot enviará boas-vindas para si mesmo no canal escolhido, usando o próprio nome e foto. O aviso Teste enviado confirmará o envio.
Nos textos, digite / para inserir uma variável:
| Variável | Resultado |
|---|---|
{membro} | Marca a pessoa que entrou |
{nome} | Mostra o nome de exibição do membro |
{servidor} | Mostra o nome do servidor do Discord |
{membros} | Mostra a quantidade atual de membros no servidor |
A Mensagem privada vem desativada e pode ter até 5 botões, cada um com um link ou uma resposta ao clique. Quem fecha a DM para servidores não recebe a mensagem. Contas de bot são ignoradas nos eventos de entrada e saída.
Outros recursos do bot de Discord do servidor FiveM
Os demais módulos do Discord usam o mesmo bot, com o mesmo nome e a mesma foto. Cada módulo é ativado na própria página, dentro de Discord na barra lateral:
| Módulo | Função | Planos |
|---|---|---|
| Whitelist | Oferece quiz, análise, entrevista ou liberação direta. Com o recurso fivedash no servidor, o ID também é liberado dentro do jogo | Plus, Pro e Ultra |
| Tickets | Atendimento em canais privados, com categorias, avaliação e transcrição | Plus, Pro e Ultra. Categorias por bot: 5 no Plus, 15 no Pro e 25 no Ultra |
| Formulários | Painéis com perguntas para candidatura à staff, denúncia ou parceria, com Aprovar e Recusar | Plus, Pro e Ultra. Formulários por bot: 3 no Plus, 10 no Pro e 25 no Ultra |
| Connect | Painel fixo com o status da cidade, os jogadores online e o connect, atualizado a cada minuto | Plus, Pro e Ultra |
| Sugestões | Transforma cada mensagem do canal em uma sugestão numerada, com votos e tópico de discussão | Plus, Pro e Ultra |
| Moderação | /ban, /kick e /mute com motivo, provas e registro de cada caso | Plus, Pro e Ultra |
| Ponto | Canal de ponto da equipe, com ranking e sequência | Plus, Pro e Ultra |
| Proteção | Anti-link, anti-spam, limites da staff e anti-raid | Pro e Ultra |
| Creators | Programa de streamers com níveis, cargos e contagem de divulgações | Pro e Ultra |
| Alinhamento | /alinhar chama um membro para conversar com a equipe, com prazo | Pro e Ultra |
As transcrições dos tickets ficam armazenadas por até 30 dias no Plus, 180 dias no Pro e 365 dias no Ultra. A atendente IA dos tickets só pode ser ativada se a FiveDash IA estiver no plano da organização.
O módulo Discord custa R$ 39,90 por mês no Plus e R$ 69,90 no Pro e no Ultra. O preço diminui quando você reúne outros módulos. Você pode testar tudo por 7 dias, sem cartão. Consulte os valores na página de preços.
Perguntas frequentes
O bot usa o nome do FiveDash?
Não. Como você cria o aplicativo no Discord, o bot pode usar o nome e a foto da sua cidade.
É obrigatório dar Administrador ao bot?
Não. O convite pede Administrador para facilitar, mas a conferência exige somente as 15 permissões da lista.
O Message Content Intent é obrigatório?
Ele não é necessário para concluir a configuração. Sem ele, porém, o Discord oculta o texto das mensagens. Logs, tickets, sugestões, ponto e a proteção contra links e spam dependem desse acesso.
Por que não consigo mudar o nome do bot?
O Discord limita a troca de nome a 2 vezes por hora. Se muitas contas já usarem o nome escolhido, o Discord o recusará, e o painel pedirá outro.
Posso vincular o mesmo bot a dois servidores do FiveDash?
Não. Cada bot fica vinculado a um único servidor do FiveDash. Para atender outro servidor, crie outro aplicativo.
Os comandos continuam funcionando quando o bot está Offline?
Sim. O que fica indisponível são os eventos ao vivo, como entradas, sugestões e proteção, até o bot voltar a ficar online.
O membro acertou o captcha, mas não recebeu o cargo. Qual pode ser o problema?
Provavelmente, o cargo do bot está abaixo do cargo de verificado. No Discord, suba o cargo do bot em Configurações do servidor → Cargos.
O teste das boas-vindas funcionou, mas os novos membros não recebem a mensagem. O que devo verificar?
Confira se a chave está em Ativa, se a página exibe algum aviso de que o serviço das entradas está fora do ar e se o Server Members Intent está ativado no Developer Portal.
Vídeo e documentação
- Vídeo: Bot próprio no Discord da sua cidade FiveM, FiveDash #2
- Docs: Bot, Verificação, Boas-vindas e Visão geral do Discord
- Para conectar o servidor FiveM ao painel: Como instalar o FiveDash no seu servidor FiveM
- Próximo módulo do bot: Como fazer whitelist no FiveM pelo Discord
Para conhecer todos os recursos do bot, acesse a página do módulo Discord.