Como programar seu próprio bot do Discord com discord.py

Q: Meu bot está offline. O que devo verificar primeiro?

Confira se o token está definido corretamente na variável de ambiente DISCORD_TOKEN e se há alguma mensagem de erro no log do serviço.

Q: Por que meus Slash Commands não aparecem?

Depois de tree.sync(), os comandos registrados globalmente podem levar até uma hora para aparecer em todos os lugares no Discord. Para testar, sincronize os comandos diretamente com um único servidor; assim, eles ficam disponíveis imediatamente.

Aprenda passo a passo a criar seu próprio bot do Discord com Python e discord.py e fazer o deploy no ZapX.

10 de novembro de 20263 min de leitura0 visualizações0 útil

Introdução

Neste guia, você vai criar seu próprio bot do Discord do zero usando Python e a biblioteca discord.py. Você vai registrar a aplicação do bot no Discord Developer Portal, escrever uma estrutura funcional com um Slash Command personalizado e, em seguida, fazer o deploy do bot no ZapX Discord Bot Hosting. Ter conhecimentos básicos de Python é útil, mas não é obrigatório.

Preparação

Antes de começar a escrever o código, você precisa criar uma aplicação de bot no Discord:

Acesse o Discord Developer Portal e clique em New Application. Escolha um nome para seu bot.
No menu à esquerda, acesse a aba Bot. Nela, você encontra o Token do bot em Reset Token. Copie o token e guarde-o em um local seguro: ele dá acesso total ao bot e nunca deve ser compartilhado publicamente nem incluído no código.
Na mesma página, em Privileged Gateway Intents, ative a opção Message Content Intent caso seu bot precise reagir ao conteúdo das mensagens (por exemplo, a comandos de texto).
Acesse a aba OAuth2 → URL Generator. Selecione o escopo bot e também applications.commands (para Slash Commands). Em seguida, marque as permissões necessárias para seu bot e acesse o link gerado para convidá-lo ao seu servidor do Discord.

Escrevendo o bot em Python

Primeiro, instale o discord.py no seu ambiente de desenvolvimento:

bash

pip install -U discord.py

Crie um arquivo main.py e monte a estrutura básica do bot:

python

import os
import discord
from discord import app_commands

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

client = discord.Client(intents=intents)
tree = app_commands.CommandTree(client)


@client.event
async def on_ready():
    await tree.sync()
    print(f"Bot ist online als {client.user}")


@tree.command(name="hallo", description="Begrüßt dich mit einer kurzen Nachricht")
async def hallo(interaction: discord.Interaction):
    await interaction.response.send_message(f"Hallo {interaction.user.mention}!")


client.run(os.environ["DISCORD_TOKEN"])

O token não é inserido diretamente no código. Em vez disso, ele é lido da variável de ambiente DISCORD_TOKEN (os.environ["DISCORD_TOKEN"]). Assim, o token fica separado do código, o que também é necessário para a etapa de deploy mais adiante.

Se você também quiser que o bot reaja quando novos membros entrarem no servidor, por exemplo, enviando uma mensagem de boas-vindas, adicione outro manipulador de evento:

python

@client.event
async def on_member_join(member: discord.Member):
    channel = discord.utils.get(member.guild.text_channels, name="willkommen")
    if channel:
        await channel.send(f"Willkommen auf dem Server, {member.mention}!")

Fazendo o deploy do bot no ZapX Discord Bot Hosting

Se ainda não tiver feito isso, crie um novo serviço de bot do Discord no painel do cliente ZapX.
Na configuração, selecione Python 3.12 como runtime.
Envie seu arquivo main.py (e, se houver, um arquivo requirements.txt com pacotes adicionais) para o diretório do serviço usando o gerenciador de arquivos integrado ou o envio de arquivos.

Gerenciador de arquivos do ZapX Discord Bot

Na aba Configurações, insira o token do bot criado anteriormente em Configuração do bot → Discord Bot Token e salve as configurações. Dessa forma, o token permanece separado do código e você não precisa alterá-lo ao enviar os arquivos novamente. No código, esse valor continua disponível como a variável de ambiente DISCORD_TOKEN.

Configurações do ZapX Discord Bot com o campo do token

5. Inicie o serviço. Se tudo estiver funcionando corretamente, o log mostrará Bot ist online als ..., e o bot aparecerá como "Online" no seu servidor do Discord.

Solução de problemas

O bot permanece offline: confira se o token está definido corretamente na variável de ambiente DISCORD_TOKEN e se há alguma mensagem de erro no log do serviço.

Os Slash Commands não aparecem: depois de tree.sync(), os comandos registrados globalmente podem levar até uma hora para aparecer em todos os lugares no Discord. Para testar, sincronize os comandos diretamente com um único servidor; assim, eles ficam disponíveis imediatamente.

Erro "Missing Access" ou problemas semelhantes de permissão: o bot não tem as permissões necessárias no servidor. Confira as permissões de cargo do bot e se as permissões corretas foram selecionadas no OAuth2 URL Generator ao convidá-lo.

Conclusão

Agora você criou um bot do Discord funcional com discord.py, adicionou um Slash Command personalizado e fez o deploy no ZapX Discord Bot Hosting. A partir daqui, você pode expandir o bot como quiser, adicionando outros comandos, funções de moderação ou integrações.

FAQ

Perguntas frequentes

Você precisa criar uma aplicação de bot no Discord Developer Portal. Crie uma New Application, acesse a aba Bot para obter o token em 'Reset Token' e gere o link de convite no OAuth2 URL Generator, selecionando os escopos 'bot' e 'applications.commands'.

O token não deve ser inserido diretamente no código. Ele é lido pela variável de ambiente DISCORD_TOKEN ('os.environ["DISCORD_TOKEN"]'). No ZapX Discord Bot Hosting, informe-o na aba Configurações, em Configuração do bot -> Discord Bot Token.

Python 3.12.

Feedback

Este artigo foi útil?

Sua opinião nos ajuda a definir prioridades e a melhorar os conteúdos.

0 de 0 As avaliações consideraram este artigo útil.

Ajuda personalizada

As instruções não são suficientes?

A nossa equipe de suporte da ZAP conhece seu produto — descreva brevemente seu problema e ajudaremos pessoalmente.

Quais 🍪 cookies você aceita?

Como programar seu próprio bot do Discord com discord.py

Introdução

Preparação

Escrevendo o bot em Python

Fazendo o deploy do bot no ZapX Discord Bot Hosting

Solução de problemas

Conclusão

Perguntas frequentes

Bot do Discord

Preparação

Escrevendo o bot em Python

Fazendo o deploy do bot no ZapX Discord Bot Hosting

Solução de problemas

Conclusão

Servidor de jogos

Servidores e hospedagem

ZAPX

Recursos

ZAP-Hosting