Erros de Bot do Discord na Square Cloud: LoginFailure, Intents Não Permitidas, Lavalink 1006

​

”LoginFailure: Improper token has been passed” / TOKEN_INVALID

• 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.

1. Vá para o Developer Portal → sua aplicação → Bot → Reset Token.
2. Atualize o token nas Environment Variables desta aplicação no dashboard da Square Cloud. 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.

​

”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.
• Gatilhos de abuso da API do Discord (a conta recebe um email de notificação neste caso) por atingir limites de taxa de forma muito agressiva.

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. A Square Cloud reinicia automaticamente uma aplicação que travou (AUTORESTART no manifesto) quando o tempo de atividade anterior foi de mais de 60 segundos, o status de saída foi 1, e ela não reiniciou automaticamente nos últimos 60 minutos. Isso mantém o bot vivo através de erros transitórios, mas nunca corrige um erro de código subjacente, erro de sintaxe, ou 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.

​

Contate-nos