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

ticket-bot

Um bot de tickets para Discord criado com discord.py.

---

Este projeto é um bot de tickets para Discord desenvolvido durante um vídeo no canal do YouTube da Square Cloud, demonstrando como construir um sistema completo de suporte via tickets usando discord.py.

O bot permite que usuários abram tickets em categorias como Suporte Geral, Parcerias, Denúncias e Outras, criando threads privadas automaticamente com a equipe de staff.

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

---

☁️ 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.
4. Convide o bot para o seu servidor: em OAuth2 > URL Generator, marque bot, dê as permissões Send Messages, Create Private Threads e Send Messages in Threads 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 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)
   • TICKET_CHANNEL_ID: o ID do canal onde as threads dos tickets serão criadas
   • STAFF_ROLE_ID: o ID do cargo da equipe que atende os tickets
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 ou cargo e escolha Copiar ID.

6️⃣ Teste o bot

Como administrador, envie T!setup no canal onde os membros vão abrir tickets: o bot publica o menu de categorias. Se o bot não responder, 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 as três variáveis.
3. Rode o bot: python main.py

Requer Python 3.12 ou mais recente.