Saltar para o conteúdo principal
O EchoAuth Bothosting executa seu bot do Discord em um contêiner próprio em 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 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 em control-hosting.echoauth.dev/register
  2. Resgate sua licença na página Store para adicionar créditos
  3. Crie um servidor — escolha um runtime, dê um nome e confirme
  4. Envie os arquivos do seu bot e defina as variáveis de inicialização
  5. Inicie o servidor e teste seu webhook
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, 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

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.
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

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

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

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

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

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. 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

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

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

Gerenciador de arquivos vazio mostrando o diretório /home/container sem arquivos

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.
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

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

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.
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

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

Gerenciador de arquivos mostrando index.js em /home/container

index.js enviado e pronto 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

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

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

Receba webhooks

Há duas formas de alcançar seu bot de fora:
Ambos retornam a mesma resposta do bot de exemplo acima:
…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

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

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

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

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 — os créditos adicionados cobrem automaticamente o próximo ciclo de cobrança mensal do seu servidor.

Solução de problemas

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.
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.
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.
Abra Support Ticket na barra lateral informando o nome do seu servidor e o que você já tentou.

Perguntas frequentes

Quantos o seu saldo de créditos permitir — cada Bot Container custa 1 crédito (1 mês) e é cobrado mensalmente do seu saldo.
Sim — defina Main File como um arquivo .ts e ele será executado via tsx em vez de node.
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.
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.