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

# Guia de configuração de hospedagem de bot do Discord

> Registre-se, resgate uma licença e coloque um bot do Discord em Node.js ou Python para rodar e receber webhooks no EchoAuth Bothosting.

O EchoAuth Bothosting executa seu bot do Discord em um contêiner próprio em [bothosting-eu01.echoauth.dev](https://bothosting-eu01.echoauth.dev), com um painel de cobrança para sua conta e seus créditos e um painel de controle baseado no [Pterodactyl](https://pterodactyl.io) para o servidor em si (console, arquivos e configurações de inicialização).

Este guia percorre o fluxo completo: criar uma conta, resgatar uma licença, criar um servidor, enviar seu bot e receber webhooks.

## Início rápido

1. [Crie sua conta](#crie-sua-conta) em [control-hosting.echoauth.dev/register](https://control-hosting.echoauth.dev/register)
2. [Resgate sua licença](#resgate-sua-licenca) na página Store para adicionar créditos
3. [Crie um servidor](#crie-um-servidor) — escolha um runtime, dê um nome e confirme
4. [Envie os arquivos do seu bot](#envie-os-arquivos-do-seu-bot) e defina as variáveis de inicialização
5. [Inicie o servidor e teste seu webhook](#inicie-o-servidor)

> [!NOTE]
>
> **Antes de começar, tenha estes itens em mãos:**
>
> * Um código de licença (do e-mail de checkout depois de comprar tempo de hospedagem)
> * O código do seu bot — um `index.js` em Node.js ou um `app.py` em Python, além de um `requirements.txt` do Python se você tiver dependências

## Crie sua conta

Acesse [control-hosting.echoauth.dev/register](https://control-hosting.echoauth.dev/register), crie uma conta e faça login. Você chega ao Dashboard, que mostra o número de servidores e o saldo de créditos.

![Painel do EchoAuth Bothosting após o login, mostrando 0 servidores e 0,00 créditos](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/01-dashboard.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=44a55bf2156a5be753248292b30a0ffa)

O painel logo após o login: 0 servidores, 0 créditos.

## Resgate sua licença

Abra **Store** na barra lateral, clique em **Redeem code** e informe seu código de licença.

> [!TIP]
>
> 1 crédito = 1 mês de execução para um contêiner de bot, e não há limite de quantos contêineres você pode executar — cada um só precisa de créditos suficientes para cobrir seu custo mensal.

![Página Store com as opções de licença de 1, 6 e 12 meses e um botão Redeem code](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/02-store.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=d22be1809910deac312b6cc81cc0708f)

A página Store, com o botão Redeem code e o preço de 1 crédito = 1 mês.

![Janela Redeem voucher code com um código de licença preenchido](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/03-redeem-filled.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=5e5333a498707f29e30f975978eef72b)

Um código de licença informado na janela Redeem voucher code.

Depois de resgatado, o crédito é adicionado ao seu saldo imediatamente e registrado nos Activity Logs do seu painel.

![Janela de resgate mostrando uma mensagem de sucesso de que 1,00 crédito foi adicionado](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/04-redeem-success.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=a79d87f20c1c7ebed2268dbdcbecd925)

Um resgate bem-sucedido adiciona o crédito ao seu saldo na hora.

## Crie um servidor

Vá em **Servers** e clique em **Create Server**. Dê um nome e escolha uma **Language**: **Node.js** ou **Python**. A localização e o plano de recursos (o produto **Bot Container**: 0,3 vCPU, 256 MB de RAM, 512 MB de disco, 1 backup, 1 porta, 1 crédito/mês) são preenchidos automaticamente.

![Formulário de criação de servidor com um nome preenchido, Node.js selecionado como linguagem e os detalhes do plano Bot Container listados abaixo](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/05-create-server.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=d2eca2740ee95cbaf0c73a1282542ab0)

O formulário de criação de servidor com Node.js selecionado, mostrando o plano de recursos Bot Container e o preço.

Clique em **Create server**. O valor é debitado do seu saldo de créditos imediatamente e o servidor aparece como **Active** na página Servers.

![Cartão do servidor mostrando status Active, especificação Node.js, plano de recursos Bot Container e preço de 1,00 crédito por mês](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/06-server-active.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=8efdd67bc293af11210788908d4f7f12)

O novo servidor, ativo e cobrado a 1,00 crédito por mês.

## Conheça o painel de controle

Clique no ícone de chave inglesa em um cartão de servidor para abri-lo no painel de controle em [controlpanel.echoauth.dev](https://controlpanel.echoauth.dev). O painel tem as abas **Console**, **Files**, **Databases**, **Schedules**, **Users**, **Backups**, **Network**, **Startup**, **Settings** e **Activity**.

![Painel do Pterodactyl listando o servidor recém-criado](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/07-panel-dashboard.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=338631775f65f91731e5077d1d39bd43)

A lista de servidores do painel de controle depois de abri-lo pelo painel.

Um servidor novo começa offline, com o gerenciador de arquivos vazio, esperando pelo seu código.

![Aba Console mostrando o servidor marcado como offline, com os botões Start, Restart e Stop](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/08-console-offline.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=065bea5d4fd06fd09ed92566554b0b8f)

Aba Console em um servidor que ainda não foi iniciado.

![Gerenciador de arquivos vazio mostrando o diretório /home/container sem arquivos](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/09-files-empty.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=1bb3ee4e94d3e98217f508c56db8fa4d)

O gerenciador de arquivos em um servidor recém-criado.

## Envie os arquivos do seu bot

Abra primeiro a aba **Startup** para ver o que seu runtime espera.

> [tab] Node.js
>
> O comando de inicialização executa `${MAIN_FILE}` a partir de `/home/container`. A variável **Main File** vem como **`index.js`** por padrão — se o arquivo principal tiver outro nome, atualize essa variável para corresponder (pode ser `.js` ou `.ts`).
>
> ![Aba Startup mostrando o comando de inicialização do Node.js e um menu suspenso de imagem Docker definido como Nodejs 26](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/10-startup-command.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=44f941a8fa4f4797b6d95348d78b4af3)
>
> Comando de inicialização do Node.js e seletor de imagem Docker.
>
> ![Variável de inicialização Main File com valor padrão index.js](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/11-main-file.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=373d4355cf41af1cf989e5cc5e1f1d8b)
>
> A variável Main File, com o padrão index.js.
>
> Não há uma chave separada de HTTP/HTTPS no runtime Node.js — seu código decide em qual dos dois ele escuta.

> [tab] Python
>
> O comando de inicialização sempre executa **`app.py`** a partir de `/home/container` — dê ao seu arquivo principal exatamente esse nome (a variável "App Py File" é apenas descritiva; ela não é substituída no comando real).
>
> ![Variável de inicialização App Py File com valor padrão app.py](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/19-python-main-file.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=0a2a66543153c5bf520179357ef7d1a5)
>
> A variável App Py File do Python, que deve continuar sendo app.py.
>
> O runtime Python também tem uma chave **Use HTTPS**: `0` = HTTP (o padrão) e `1` = HTTPS, caso em que ele procura `cert.pem` e `key.pem` no diretório do servidor e recorre a um certificado autoassinado se não existirem.
>
> ![Variável de inicialização Use HTTPS com a chave desligada, descrita como 0 = HTTP padrão, 1 = HTTPS](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/20-python-use-https.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=eb21f9df848c94c86d160a8158528de1)
>
> A variável Use HTTPS, disponível apenas no runtime Python.
>
> > [!WARNING]
> >
> > O proxy público de webhook HTTPS (abaixo) espera que seu bot escute em HTTP simples. Deixe **Use HTTPS** em `0`, a menos que você mesmo faça a terminação de TLS e se conecte diretamente à sua porta.
>
> Liste em **`requirements.txt`** os pacotes de que seu bot precisa — eles são instalados automaticamente na inicialização.

Abra **Files**, clique em **New File** (ou em **Upload** para enviar um arquivo do seu computador) e adicione seu código.

![Editor de novo arquivo com código de exemplo de servidor de webhook colado](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/12-new-file-editor.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=202c32cf6ecd7d4021aa46cd952ba328)

Escrevendo o código do bot diretamente no editor de arquivos do painel.

> [tab] Node.js
>
> ![Gerenciador de arquivos mostrando index.js em /home/container](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/13-files-index-js.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=ed83b61d895d03949133422c43be0ce0)
>
> index.js enviado e pronto para executar.

> [tab] Python
>
> ![Gerenciador de arquivos mostrando app.py e requirements.txt em /home/container](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/21-python-files.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=8fb281d9be6156356abed7fcb9b1c0c6)
>
> app.py e requirements.txt enviados e prontos para executar.

## Inicie o servidor

Vá em **Console** e clique em **Start**. O painel baixa a imagem Docker, executa o comando de inicialização e transmite a saída ao vivo.

![Console mostrando o script de inicialização em execução e depois Bot webhook server listening on port 25500](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/14-console-running.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=f118d50404f795183ec1dd8b0b1ef499)

Saída do console logo depois que um servidor Node.js inicia, com o bot registrando que está escutando.

## Encontre o endereço e a porta do seu servidor

Abra a aba **Network**. O endereço público do seu servidor é `<hostname>:<port>` — por exemplo `bothosting-eu01.echoauth.dev:25500`. As portas permitidas ficam no intervalo `25500`–`25650`.

![Aba Network com o hostname bothosting-eu01.echoauth.dev e a porta 25500](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/15-network-tab.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=72e0554fadab4528c1cbd9a90b694380)

Aba Network mostrando o hostname do servidor e a porta atribuída.

## Receba webhooks

Há duas formas de alcançar seu bot de fora:

| Formato | URL | Observações |
| - | - | - |
| HTTP direto | `http://bothosting-eu01.echoauth.dev:<port>/<path>` | Acessa diretamente a porta do seu contêiner. |
| Proxy HTTPS | `https://bothosting-eu01.echoauth.dev/hook/<port>/<path>` | O TLS é terminado para você — exige que seu bot esteja em modo HTTP (`Use HTTPS = 0`). |

```bash Direct HTTP theme={null}
curl -X POST http://bothosting-eu01.echoauth.dev:25500/webhook \
  -H "Content-Type: application/json" \
  -d '{"event": "ping"}'
```

```bash HTTPS proxy theme={null}
curl -X POST https://bothosting-eu01.echoauth.dev/hook/25500/webhook \
  -H "Content-Type: application/json" \
  -d '{"event": "ping"}'
```

Ambos retornam a mesma resposta do bot de exemplo acima:

```json theme={null}
{"status": "ok", "received": true}
```

...e ambas as chamadas aparecem ao vivo no console, junto com as estatísticas de CPU, memória e tempo de atividade do servidor.

![Console mostrando duas linhas de log Webhook received, além dos blocos de estatísticas Address, Uptime, CPU Load e Memory](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/16-webhook-logs.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=9da134cabf2ca3125e723ba7374ebc3b)

Duas entregas de webhook registradas ao vivo no console, com as estatísticas de recursos abaixo.

A mesma coisa funcionando de ponta a ponta no runtime Python:

![Log do console Python mostrando o servidor iniciando e depois duas linhas Webhook received de dois IPs de origem diferentes](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/22-python-webhook-logs.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=59e609ce210b24b4f1811e9e4300c632)

Um bot Python registrando um webhook recebido tanto pela porta direta quanto pelo proxy HTTPS.

## Gerencie seu servidor

Use **Restart** e **Stop** na aba Console para controlar o processo em execução.

### Backups

Seu plano Bot Container inclui 1 vaga de backup. Abra **Backups** e clique em **Create Backup** para fazer um instantâneo dos seus arquivos.

![Aba Backups mostrando que não há backups armazenados, com um botão Create Backup](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/17-backups-empty.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=9770bee3f420389ffac1676a6999477e)

Ainda sem backups — a aba Backups em um servidor novo.

![Lista de backups mostrando um backup criado há alguns segundos, 1 de 1 backups usados](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/18-backup-created.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=7ccf5835b8ca402d763fac7997c4ffbe)

O primeiro backup, criado e pronto.

### Renove sua licença

Compre ou resgate outro código de licença da mesma forma que em [Resgate sua licença](#resgate-sua-licenca) — os créditos adicionados cobrem automaticamente o próximo ciclo de cobrança mensal do seu servidor.

## Solução de problemas

> [accordion] O servidor não inicia
>
> Verifique a aba **Startup**: no Node.js, a variável **Main File** precisa corresponder exatamente ao nome do arquivo enviado; no Python, seu arquivo principal precisa se chamar `app.py`. Um arquivo ausente ou com nome errado é a causa mais comum.

> [accordion] Porta inacessível
>
> Use exatamente o hostname e a porta mostrados na aba **Network**, não uma porta escolhida por você — somente a porta alocada (intervalo `25500`–`25650`) é roteada para o seu contêiner.

> [accordion] O webhook não chega
>
> Confirme se você está usando o formato certo para o modo do seu bot: o proxy HTTPS (`/hook/<port>/<path>`) só funciona quando seu bot escuta em HTTP simples (`Use HTTPS = 0` no Python). Verifique também se o caminho corresponde ao que seu código espera — um erro de digitação ali retorna um 404 do seu próprio servidor, não do EchoAuth.

> [accordion] Ainda com dificuldades?
>
> Abra **Support Ticket** na barra lateral informando o nome do seu servidor e o que você já tentou.

## Perguntas frequentes

> [accordion] Quantos servidores posso executar?
>
> Quantos o seu saldo de créditos permitir — cada Bot Container custa 1 crédito (1 mês) e é cobrado mensalmente do seu saldo.

> [accordion] Posso usar TypeScript no runtime Node.js?
>
> Sim — defina **Main File** como um arquivo `.ts` e ele será executado via `tsx` em vez de `node`.

> [accordion] Preciso de um requirements.txt no Python se não tenho dependências?
>
> Não — ele é opcional. Se existir, seus pacotes são instalados a cada inicialização; se seu bot usa apenas a biblioteca padrão, você pode omiti-lo.

> [accordion] O que acontece se minha licença acabar?
>
> Resgate um novo código de licença na página Store antes que seus créditos cheguem a zero — os créditos adicionados são aplicados automaticamente ao seu próximo ciclo de cobrança.


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