> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Template Bot do Discord (JavaScript) na Vertra Cloud: starter com o comando /ping

> Crie um bot do Discord em JavaScript na Vertra Cloud: obtenha o token, convide o bot, execute /ping e edite o código. Template de código, sem endereço web.

Um bot do Discord mínimo em JavaScript com discord.js 14.27.0 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 JavaScript, **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](https://docs.vertracloud.app/pt-br/templates/overview.md).

* 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/index.js`; dependências em `src/package.json`.

## O que o assistente pergunta

| Pergunta | O que faz |
| - | - |
| Bot token | Vira a variável criptografada `DISCORD_TOKEN`. |

## Primeiros passos

**1. Crie o bot e obtenha o token**

No [Discord Developer Portal](https://discord.com/developers/applications) 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/index.js`, adicione seus comandos e faça deploy de novo, ou reinicie se você editou no editor do app. Para adicionar bibliotecas, execute `npm install <package>` localmente e envie o `package.json` e o `package-lock.json` atualizados: 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](https://docs.vertracloud.app/pt-br/templates/use/updates-and-rollback.md#apps-desvinculados-e-templates-removidos).

## Referência

| Item | Valor |
| - | - |
| Variável | `DISCORD_TOKEN` (criptografada, vinda do assistente) |
| Comando de início | `node index.js` |
| Arquivo principal | `index.js` |
| Memória | 100 MB (mínimo), 256 MB (recomendado) |
| Web | Nenhuma |
| Deploy sem downtime | Desligado (um token é uma cópia) |

## 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.js é distribuído sob a [licença Apache-2.0](https://github.com/discordjs/discord.js/blob/main/LICENSE).

Veja também os [outros templates oficiais](https://docs.vertracloud.app/pt-br/templates/catalog.md) e o tutorial [Criar um template de bot do Discord](https://docs.vertracloud.app/pt-br/templates/tutorials/discord-bot-code.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.