📌 Note: This README is written in Portuguese because this project was created as part of a YouTube tutorial in Portuguese.

welcome-bot

Um bot de boas-vindas para Discord criado com discord.py.

---

Este projeto é um bot de boas-vindas para Discord desenvolvido durante um vídeo no canal do YouTube da Square Cloud, demonstrando como construir um sistema completo de recepção de novos membros usando discord.py.

Sempre que um novo membro entra no servidor, o bot envia no canal configurado uma mensagem que menciona o membro, junto com uma imagem de boas-vindas com o avatar, o nome e o número do membro.

O vídeo que originou este projeto está disponível no YouTube: https://youtu.be/nSVscBbuZpo

---

☁️ Como hospedar na Square Cloud

Nunca usou a Square Cloud? Siga os passos abaixo, na ordem: você vai criar uma conta, escolher um plano, criar o bot no Discord e enviar o projeto.

1️⃣ Crie sua conta na Square Cloud

Cadastre-se na página de cadastro da Square Cloud com o seu e-mail.

2️⃣ Escolha um plano

A hospedagem na Square Cloud precisa de um plano ativo, e o envio do passo 5 pede um, então escolha agora.

Este bot usa só 256 MB de RAM: o plano Hobby é suficiente e ainda sobra espaço para outros bots. Compare todos os planos e preços na página de planos.

3️⃣ Crie o bot no Discord

1. No Discord Developer Portal, clique em New Application e dê um nome ao bot.
2. Na aba Bot, clique em Reset Token e copie o token. Guarde-o em segredo: ele controla o seu bot.
3. Na mesma aba, em Privileged Gateway Intents, ative Presence Intent, Server Members Intent e Message Content Intent. Sem a Server Members Intent, o bot não fica sabendo quando alguém entra.
4. Convide o bot para o seu servidor: em OAuth2 > URL Generator, marque bot, dê as permissões Send Messages e Attach Files e abra o link gerado.

4️⃣ Prepare o projeto

1. No topo desta página, clique em Code > Download ZIP e extraia o arquivo.
2. Abra a pasta extraída, selecione todos os arquivos dentro dela (inclusive a pasta fonts) e compacte-os em um novo .zip. Compacte os arquivos, não a pasta: o squarecloud.app precisa ficar na raiz do zip.

5️⃣ Envie para a Square Cloud

1. Acesse a página de upload da Square Cloud.
2. Selecione a opção de zip e envie o arquivo que você criou.
3. Abra Configuração avançada e adicione as variáveis de ambiente:
   • TOKEN: o token do bot (passo 3)
   • RECEPCAO_ID: o ID do canal onde o bot vai dar as boas-vindas
4. Clique em Deploy.

💡 Como copiar um ID no Discord: ative o Modo de desenvolvedor em Configurações > Avançado, clique com o botão direito no canal e escolha Copiar ID.

6️⃣ Teste o bot

Peça para alguém entrar no servidor, ou entre com outra conta: a mensagem de boas-vindas aparece no canal de RECEPCAO_ID. Se nada aparecer, abra a aplicação no dashboard da Square Cloud e confira os logs.

📖 Mais detalhes no guia de bots do Discord da documentação da Square Cloud.

---

💻 Rodando no seu computador

1. Instale as dependências: pip install -r requirements.txt
2. Copie o .env-example para .env e preencha TOKEN e RECEPCAO_ID.
3. Rode o bot: python main.py

Requer Python 3.10 ou mais recente. A imagem usa a fonte Liberation Sans da pasta fonts, distribuída sob a licença SIL Open Font License.