Bot do Discord offline: token, intents e Lavalink

​

”LoginFailure: Improper token has been passed” / TokenInvalid

• discord.py: discord.errors.LoginFailure: Improper token has been passed.
• discord.js v14: Error [TokenInvalid]: An invalid token was provided.
• discord.js antigo: Error [TOKEN_INVALID]: An invalid token was provided.
• outras bibliotecas: um HTTP 401 Unauthorized no login.

• O token foi regenerado ou revogado no Discord Developer Portal. Gerar um novo token invalida instantaneamente o antigo em todos os lugares onde ele é usado.
• A string do token tem espaços ou aspas extras copiados por acidente.
• O código está lendo a variável de ambiente errada, ou a variável não está definida na Square Cloud.

1. Vá para o Developer Portal → sua aplicação → Bot → Reset Token.
2. Atualize o token nas variáveis de ambiente da aplicação (no dashboard, Configurações → Variáveis de Ambiente, ou com squarecloud app env set). Nunca faça commit do token em um arquivo que é enviado no zip.
3. Verifique se não há espaços ou aspas soltas ao redor do valor.
4. Atualize a biblioteca (discord.js@latest ou pip install -U discord.py).
5. Reinicie a aplicação, para que ela carregue o novo valor.

​

”Used disallowed intents” / Message Content Intent

1. Discord Developer Portal → sua aplicação → Bot → Privileged Gateway Intents → habilite Message Content Intent.
2. Declare-a no código também:

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

# discord.py
intents = discord.Intents.default()
intents.message_content = True
client = commands.Bot(command_prefix="!", intents=intents)

3. Reinicie a aplicação.

​

Conexão do Lavalink fechada com código 1006

1. Alinhe a versão do wrapper de cliente Lavalink do seu bot com a versão principal do servidor Lavalink (cliente v3 com servidor v3, cliente v4 com servidor v4).
2. Na Square Cloud, o próprio servidor Lavalink se vincula à porta 80, mas seu bot deve se conectar a ele através da borda na porta 443 com secure: true.
3. Reinicie tanto a aplicação do Lavalink quanto a aplicação do bot depois de corrigir a incompatibilidade de versão.

​

Bot fica offline depois de funcionar localmente

• Uma conexão instável no nível do gateway sem tratamento de reconexão.
• Versões de dependências conflitantes ou incompatíveis entre o que você testou localmente e o que está no seu arquivo de dependências.
• O bot foi parado por passar da RAM ou da CPU, ou por inundar a API do Discord. Nesse caso, os logs mostram uma linha [SQUARE-SHIELD] e você recebe um e-mail: veja a tabela de status.

1. Verifique primeiro os logs da aplicação no dashboard, eles mostram o motivo real da falha.
2. Adicione handlers de erro para que um erro transitório não derrube o processo: process.on("unhandledRejection", ...) e client.on("error", ...) no discord.js, tratamento equivalente no discord.py.
3. Adicione AUTORESTART=true ao seu squarecloud.app para que a Square Cloud reinicie o bot depois de uma falha. Essa opção vem desligada por padrão e só reinicia nos casos listados em AUTORESTART. Ela mantém o bot vivo diante de erros passageiros, mas nunca corrige um token inválido, um erro de sintaxe ou uma dependência ausente: esses ainda precisam de uma correção no código.
4. Fique atento aos limites de taxa da API do Discord (429): o limite global é de cerca de 50 requisições/segundo por token de bot, com buckets mais restritos por rota (criação/edição de canal permite aproximadamente 2 mudanças a cada 10 minutos por canal). Faça cache agressivamente, use uma fila assíncrona que respeita os headers X-RateLimit-Remaining/X-RateLimit-Reset-After, e use webhooks para envios em massa. Um bot que continua inundando o Discord é parado com ABUSE_REQUESTS.

​

Guias relacionados

• Tutorial de hospedagem de bot do Discord: configure e faça deploy de um bot do zero.
• Variáveis de ambiente: guarde o token fora do seu código.
• O app não inicia: erros de upload, módulos ausentes e outras falhas no boot.

​

Contate-nos