> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.squarecloud.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como criar um bot de Discord do zero

## O que é um bot e como ele funciona

Um bot de Discord é uma aplicação que se conecta à API do Discord e age como um usuário automatizado: responde a comandos, modera o servidor, toca música, envia avisos e muito mais. Para criar um, você precisa de duas coisas: registrar a aplicação no **Discord Developer Portal** e escrever o código que dá vida a ela.

## 1. Crie a aplicação no Discord Developer Portal

1. Acesse o Discord Developer Portal e faça login.
2. Clique em **New Application**, dê um nome e confirme.
3. No menu lateral, vá em **Bot**.
4. Clique em **Reset Token** para gerar o token do seu bot.

## 2. Pegue e proteja seu token

O **token** é a senha do seu bot — quem tiver o token controla o bot. Por isso:

* Nunca compartilhe nem suba o token para o GitHub.
* Guarde-o em uma variável de ambiente (ex.: `DISCORD_TOKEN`), nunca direto no código.
* Se vazar, gere um novo imediatamente em **Reset Token**.

## 3. Configure os Intents

Ainda na aba **Bot**, ative os **Privileged Gateway Intents** que seu bot precisar — especialmente o **Message Content Intent**, se ele for ler mensagens. Sem isso, o bot não recebe o conteúdo das mensagens (veja [Por que meu bot não lê mensagens? Entenda os Privileged Intents](https://help.squarecloud.app/pt-br/article/por-que-meu-bot-nao-le-mensagens-entenda-os-privileged-intents-kgu4e0/)).

## 4. Convide o bot para seu servidor

1. Vá em **OAuth2 > URL Generator**.
2. Em **Scopes**, marque `bot` (e `applications.commands` se for usar slash commands).
3. Em **Bot Permissions**, marque as permissões necessárias.
4. Copie a URL gerada, abra no navegador e escolha o servidor.

## 5. Escreva seu primeiro "Hello World"

Escolha uma biblioteca (discord.js para JavaScript ou discord.py para Python) e faça o bot responder a um comando simples. Não sabe qual usar? Veja [discord.js ou discord.py: qual escolher para começar](https://help.squarecloud.app/pt-br/article/discordjs-ou-discordpy-qual-escolher-para-comecar-17ilh7x/).

Exemplo mínimo em discord.js:
```
const { Client, GatewayIntentBits } = require('discord.js');
const client = new Client({ intents: [GatewayIntentBits.Guilds] });

client.once('ready', () => console.log('Bot online!'));
client.login(process.env.DISCORD_TOKEN);
```

## Próximo passo: deixar o bot online 24/7

No seu computador, o bot só fica online enquanto o código está rodando. Para que ele funcione o tempo todo, você precisa hospedá-lo. Veja o guia [Como hospedar um Bot de Discord](https://help.squarecloud.app/pt-br/article/como-hospedar-um-bot-de-discord-17gy9qh/) e coloque seu bot no ar 24/7 na Square Cloud.