Pular para o conteúdo principal
Um bot do Discord mínimo em Python com discord.py 2.7.1 e um comando /ping. Este é um template de código: o código é seu, aberto e editável, e a Vertra Cloud executa o que está em src/.

O que ele cria

Um app (código) no runtime de Python, sem endereço web: o bot só faz conexões de saída. Precisa de pelo menos 100 MB de memória (256 MB recomendados) e nenhuma vaga de imagem, então qualquer plano pode executá-lo. Veja O que são templates.
  • Ele faz login com o token do bot, registra o comando de barra /ping a cada inicialização e responde com a latência do gateway.
  • Usa apenas o intent Guilds, então não há nenhum intent privilegiado para ativar.
  • Sem token ou com um token errado, o processo encerra com código 1 e uma mensagem clara no log do app.
  • Código-fonte em src/main.py; dependências em src/requirements.txt.

O que o assistente pergunta

Primeiros passos

1

Crie o bot e obtenha o token

No Discord Developer Portal crie uma New Application, abra Bot e clique em Reset Token. Copie o valor: ele é mostrado uma única vez.
2

Cole no assistente

Cole o token quando o assistente pedir. Ele é guardado criptografado e nunca vai no código.
3

Convide o bot

Em OAuth2 > URL Generator, marque os escopos bot e applications.commands, abra a URL gerada e escolha o seu servidor.
4

Confira

Depois do deploy, o log do app mostra Logged in as <bot name>. No Discord, digite /ping: o bot responde Pong! com a latência. O comando global pode levar alguns minutos para aparecer na primeira vez.

Faça do seu jeito

Abra src/main.py, adicione seus comandos e faça deploy de novo, ou reinicie se você editou no editor do app. Para adicionar bibliotecas, liste-as em requirements.txt com uma versão fixada: a plataforma instala as dependências a cada deploy. Editar o código desvincula o app do template, que então deixa de receber novas versões. Veja Atualizar e fazer rollback.

Referência

Limites e problemas comuns

  • Duas cópias com o mesmo token responderiam duas vezes, então o deploy sem downtime está desligado.
  • O mínimo é 100 MB, e 256 MB (o recomendado) bastam para um bot simples. Um bot em muitos servidores ou com um cache grande precisa de mais; você pode aumentar a memória.
  • Os comandos globais do Discord demoram a propagar. Para testes, registre comandos de servidor no seu código.
  • Login failed no log. DISCORD_TOKEN não é o token do bot. Redefina-o no Portal, atualize a variável e reinicie.
  • /ping não aparece. Espere alguns minutos e confira se o convite tinha o escopo applications.commands.
  • O app não fica no ar. Sem um token válido o processo encerra com código 1. Corrija o token e reinicie.

Licença

O código do template é da Vertra Cloud, sob a licença MIT. discord.py é distribuído sob a licença MIT. Veja também os outros templates oficiais e o tutorial Criar um template de bot do Discord.
Última modificação em 28 de outubro de 2026