Erros comuns ao hospedar um bot de Discord

​

Used disallowed intents (discord.js)

Error: Used disallowed intents

1. Abra o Discord Developer Portal, escolha o bot e vá em Bot.
2. Em Privileged Gateway Intents, ligue os intents que o código pede: Server Members Intent, Presence Intent ou Message Content Intent.
3. Salve e reinicie o bot.

​

TokenInvalid: An invalid token was provided (discord.js)

Error [TokenInvalid]: An invalid token was provided.

• Confira se a variável DISCORD_TOKEN está cadastrada no app, com esse nome exato. Na Hyze: Configurações → Variáveis de ambiente.
• Confira se o código lê o mesmo nome: client.login(process.env.DISCORD_TOKEN).
• Cole o token sem aspas e sem espaços no começo ou no fim.
• Se você gerou um token novo no portal, o antigo deixou de valer. Atualize a variável.
• Depois de mudar a variável, reinicie o app. Variáveis de ambiente são lidas quando o processo inicia.

​

PrivilegedIntentsRequired (discord.py)

discord.errors.PrivilegedIntentsRequired: Shard ID None is requesting privileged intents that have not been explicitly enabled in the developer portal.

​

LoginFailure: Improper token has been passed (discord.py)

discord.errors.LoginFailure: Improper token has been passed.

• Copie o token de novo em Bot → Reset Token no Developer Portal.
• Cadastre como DISCORD_TOKEN nas variáveis de ambiente do app, sem aspas.
• Leia com os.environ["DISCORD_TOKEN"]. Se faltar, o log mostra o nome da variável na hora.
• Reinicie o app depois de mudar a variável.

​

Missing Access e Missing Permissions

DiscordAPIError[50001]: Missing Access
DiscordAPIError[50013]: Missing Permissions

• Missing Access (50001): o bot não enxerga o canal ou o servidor. Acontece quando ele não tem a permissão Ver canal, quando tenta usar um canal de outro servidor ou quando registra comandos de barra num servidor em que foi convidado sem o escopo applications.commands.
• Missing Permissions (50013): o bot vê o canal, mas não tem a permissão da ação. Exemplos: enviar mensagem, apagar mensagem, dar cargo. Para dar ou tirar um cargo, o cargo do bot precisa estar acima dele na lista de cargos do servidor.

1. No portal, em OAuth2 → URL Generator, marque os escopos bot e applications.commands e as permissões que o bot usa.
2. Abra o link gerado e convide o bot de novo. Ele não sai do servidor, só recebe as permissões novas.
3. Confira as permissões do canal: uma regra do canal pode negar o que o cargo libera.
4. Para gerenciar cargos, arraste o cargo do bot para cima dos cargos que ele vai dar.

​

Cannot find module (dependência fora do package.json)

Error: Cannot find module 'discord.js'
Require stack:
- /app/index.js

• O package.json está dentro de uma pasta no ZIP. A instalação não acha o manifesto. Coloque os arquivos na raiz do ZIP.
• Maiúscula e minúscula no caminho. require("./Commands/ping") funciona no Windows e no macOS com a pasta commands, mas falha no Linux. Use o nome exato da pasta e do arquivo.
• No Python, a biblioteca não está no requirements.txt. Atenção ao nome: o pacote é discord.py, mas o import é import discord.

npm install discord.js   # instala e grava em "dependencies" no package.json

​

Bot fica online mas não responde a mensagens

Privileged message content intent is missing, commands may not work as expected.

1. No portal, em Bot → Privileged Gateway Intents, ligue Message Content Intent.
2. Peça o intent no código:

const { Client, GatewayIntentBits } = require("discord.js");

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,
  ],
});

import discord
from discord.ext import commands

intents = discord.Intents.default()
intents.message_content = True

bot = commands.Bot(command_prefix="!", intents=intents)

3. Faça um novo deploy.

​

Próximos passos