Bem-vindo ao repositório oficial do nazuna Bot! Este projeto é um bot avançado e multifuncional para WhatsApp, desenvolvido com a robustez do Node.js e a flexibilidade da biblioteca WaLib. Criado para otimizar sua comunicação e gestão de grupos, o nazuna Bot oferece uma vasta gama de comandos, desde funcionalidades administrativas essenciais até opções de entretenimento interativas. É a solução perfeita tanto para desenvolvedores iniciantes que buscam uma ferramenta fácil de usar quanto para usuários avançados que desejam uma plataforma altamente personalizável.
⚠️ Aviso Importante: O nazuna Bot é um projeto de código aberto, desenvolvido com paixão e dedicação. No entanto, ele é protegido por direitos autorais. Isso significa que, embora você tenha total liberdade para editar e distribuir o bot para uso pessoal ou em sua comunidade, a venda do nazuna Bot ou de suas versões modificadas é estritamente proibida, pois o projeto é oferecido gratuitamente. Além disso, a remoção total dos créditos do autor é vedada. Violações destas condições podem resultar em ações legais.
O nazuna Bot foi projetado para ser mais do que um simples assistente; ele é um parceiro digital que simplifica suas interações no WhatsApp. Veja o que o torna tão especial:
- Configuração Simplificada e Intuitiva: Conecte-se ao WhatsApp em questão de minutos, utilizando um prático QR code ou um código de pareamento, eliminando complexidades iniciais.
- Funcionalidade Abrangente e Versátil: Gerencie grupos com eficiência, utilize ferramentas utilitárias para diversas tarefas e divirta-se com uma biblioteca crescente de comandos de entretenimento, tudo em um só lugar.
- Compatibilidade Multiplataforma Inigualável: Rode o nazuna Bot em praticamente qualquer ambiente: Windows, Linux, macOS, dispositivos Android (através do Termux) e até mesmo em servidores dedicados como Pterodactyl, garantindo flexibilidade total.
- Atualizações Constantes e Melhorias Contínuas: Nossa equipe está sempre trabalhando para trazer novas funcionalidades, otimizações de desempenho e correções de bugs, garantindo que seu bot esteja sempre na vanguarda.
- Segurança Reforçada e Estabilidade Comprovada: Desenvolvido com base no modo multi-dispositivos do WhatsApp, o nazuna Bot oferece uma operação fluida, segura e confiável, minimizando interrupções e protegendo seus dados.
💡 Explore o Potencial: Após a configuração inicial, basta digitar
/menuno WhatsApp para desvendar um universo de comandos e funcionalidades que o nazuna Bot oferece!
Acompanhe o progresso e a vitalidade do nazuna Bot através de métricas em tempo real, que refletem o engajamento da comunidade e o desenvolvimento contínuo do projeto:
📈 Visitas Totais ao Repositório:
Este contador registra o número total de visualizações que o repositório do nazuna Bot recebeu, refletindo o interesse geral no projeto.
Mantenha-se sempre atualizado com as últimas notícias, receba dicas exclusivas e acesse suporte direto da comunidade do nazuna Bot. Junte-se a nós!
Clique para entrar no nosso grupo oficial do WhatsApp e faça parte da nossa crescente comunidade!
Navegue facilmente por todas as seções deste README para encontrar as informações que você precisa:
- 🚀 Primeiros Passos: Guia Rápido
- 📋 Pré-requisitos Essenciais
- 📥 Instalação do nazuna Bot
- 🚀 Rodando o Bot pela Primeira Vez
- 🔌 Conectando o Bot ao WhatsApp
- 🔄 Atualizando o nazuna Bot
- 💻 Tutoriais de Instalação por Plataforma
- ❓ Resolvendo Problemas Comuns (FAQ)
- 💖 Apoie o Projeto: Faça a Diferença
- 📜 Licença de Uso e Direitos Autorais
- 👤 Sobre o Criador: Hiudy
- ❔ FAQ Avançado e Dúvidas Frequentes
Se você é novo no mundo dos bots de WhatsApp e nunca instalou o nazuna Bot antes, é altamente recomendável que você siga o tutorial específico para a sua plataforma (Windows, Linux, Termux ou Pterodactyl), detalhado na seção Tutoriais de Instalação por Plataforma. Esses guias foram elaborados para cobrir cada etapa, minimizando possíveis erros.
Para aqueles que já têm alguma familiaridade ou já possuem os pré-requisitos instalados, siga estes passos para uma configuração rápida:
- Prepare o Ambiente: Certifique-se de ter o Node.js (versão 18 ou superior) e o Git instalados em seu sistema. Consulte a seção Pré-requisitos Essenciais para mais detalhes.
- Baixe o Bot: Clone o repositório oficial do nazuna Bot do GitHub para o seu ambiente de trabalho.
- Conecte ao WhatsApp: Utilize um número de telefone secundário e exclusivo para o bot. Esta é uma medida de segurança crucial para proteger sua conta principal de possíveis bloqueios ou banimentos pelo WhatsApp.
- Explore os Comandos: Após a conexão bem-sucedida, envie
/menupara o bot no WhatsApp para descobrir todas as funcionalidades e comandos disponíveis.
💡 Dica para Iniciantes: Não se sinta sobrecarregado se os termos parecerem complexos. Cada seção deste documento foi cuidadosamente elaborada para fornecer instruções claras e passo a passo, tornando o processo acessível a todos.
Para garantir que o nazuna Bot funcione perfeitamente em seu sistema, você precisará dos seguintes componentes. Certifique-se de que todos estejam instalados e configurados corretamente antes de prosseguir com a instalação do bot:
| Item Essencial | Descrição Detalhada e Links para Download |
|---|---|
| Node.js | Versão 18 ou superior. O Node.js é o ambiente de execução JavaScript necessário para rodar o bot. Baixe a versão LTS (Long Term Support) mais recente diretamente do site oficial: nodejs.org. |
| Git | Uma ferramenta de controle de versão essencial para clonar o repositório do nazuna Bot do GitHub. Faça o download e instale-o a partir do site oficial: git-scm.com. |
| Um número de telefone dedicado e secundário para o bot. É crucial NÃO utilizar seu número principal, pois o uso de bots pode, em casos raros, levar a banimentos temporários ou permanentes da conta pelo WhatsApp. | |
| Internet Estável | Uma conexão à internet contínua e estável é fundamental para a configuração inicial, conexão com o WhatsApp e o funcionamento ininterrupto do bot. |
| Dispositivo Compatível | Você pode rodar o nazuna Bot em uma variedade de plataformas: um computador (Windows, Linux, macOS), um dispositivo Android (com o aplicativo Termux instalado) ou um servidor dedicado (como os que utilizam Pterodactyl). |
| Recursos Mínimos de Hardware | Para um funcionamento básico, o bot requer 256MB de RAM e 256MB de armazenamento disponível. Para um desempenho otimizado e mais fluidez, recomendamos 512MB de RAM e 512MB de espaço em disco. |
⚠️ Alerta de Segurança: Reafirmamos a importância de utilizar um número de telefone secundário para o nazuna Bot. Esta prática protege sua conta pessoal do WhatsApp de quaisquer riscos associados ao uso de automação.
Siga este guia passo a passo para instalar o nazuna Bot em seu sistema. Certifique-se de ter todos os Pré-requisitos Essenciais instalados antes de começar.
-
Clonar o Repositório do GitHub
Abra o terminal de sua preferência (Prompt de Comando no Windows, PowerShell, Terminal no Linux/macOS ou Termux no Android) e execute os seguintes comandos. Estes comandos baixarão todo o código-fonte do nazuna Bot para o seu computador e o levarão para o diretório do projeto:git clone https://github.com/hiudyy/nazuna.git cd nazuna- Explicação:
git clone https://github.com/hiudyy/nazuna.git: Este comando baixa uma cópia completa do repositório do nazuna Bot do GitHub para o seu diretório atual. Uma nova pasta chamadanazunaserá criada.cd nazuna: Este comando muda o diretório de trabalho atual para a pastanazuna, onde o bot está localizado. Todas as operações subsequentes devem ser executadas dentro desta pasta.
- Explicação:
-
Instalar Dependências do Projeto
O nazuna Bot utiliza diversas bibliotecas e pacotes Node.js para funcionar. Para instalá-los, execute os comandos abaixo, um por vez. O processo pode levar alguns minutos, dependendo da sua conexão com a internet:npm run config npm run config:install
- Explicação:
npm run config: Executa um script de configuração inicial que prepara o ambiente do bot.npm run config:install: Este comando lê o arquivopackage.jsondo projeto e instala todas as dependências listadas. É crucial para o funcionamento correto do bot.
- Solução de Problemas Comuns:
npm: command not found: Este erro geralmente indica que o Node.js (e, consequentemente, o npm) não foi instalado corretamente ou não está no PATH do seu sistema. Verifique a instalação do Node.js executandonode -venpm -v. Se não retornarem versões, reinstale o Node.js.- Erros de Permissão: Em alguns sistemas, especialmente Linux ou Termux, você pode encontrar erros de permissão. Certifique-se de que você tem permissões de escrita no diretório onde o bot foi clonado. No Termux, verifique se
termux-setup-storagefoi executado e a permissão concedida. - Outros Erros de Instalação: Se os comandos
npm run configounpm run config:installfalharem, tente executarnpm installdiretamente. Este comando reinstala todas as dependências do zero e pode resolver problemas de pacotes corrompidos.
- Explicação:
Após a instalação bem-sucedida de todas as dependências, você está pronto para iniciar o nazuna Bot. Execute o seguinte comando no terminal, dentro do diretório do projeto nazuna:
npm startEste comando iniciará o processo do bot e o guiará através da conexão com o WhatsApp, que será detalhada na próxima seção.
💡 Primeira Execução e Autenticação: Na primeira vez que você rodar o bot, ele solicitará uma autenticação com o WhatsApp. Isso pode ser feito via QR code ou código de pareamento. Uma vez autenticado, a sessão será salva, e o bot se reconectará automaticamente em execuções futuras, a menos que a sessão seja explicitamente desconectada ou corrompida.
O nazuna Bot aproveita o modo multi-dispositivos do WhatsApp, o que significa que, após a configuração inicial, seu celular não precisa permanecer conectado à internet para que o bot funcione. Escolha o método de conexão que melhor se adapta às suas necessidades:
Este é o método mais comum e direto para conectar seu bot:
- Passo 1: Gerar o QR Code: Ao executar
npm start, o terminal exibirá um QR code (um quadrado com padrões pretos e brancos). - Passo 2: Escanear com o Celular: No seu smartphone, abra o aplicativo WhatsApp e siga estes passos:
- Vá em Configurações (ou Ajustes no iOS).
- Selecione Aparelhos Conectados.
- Toque em Conectar um Aparelho.
- Utilize a câmera do seu celular para escanear o QR code que aparece no terminal.
- Conexão Bem-Sucedida: Após o escaneamento, o bot será conectado ao seu WhatsApp e estará pronto para operar.
Este método é útil se você não consegue escanear o QR code diretamente (por exemplo, se estiver rodando o bot em um servidor remoto sem interface gráfica):
- Passo 1: Iniciar o Processo: Ao executar
npm start, o bot solicitará que você digite o número de telefone do bot (incluindo o código do país, ex:+5511999999999). - Passo 2: Obter o Código: Após digitar o número, o terminal fornecerá um código de pareamento alfanumérico (ex:
1234-5678). - Passo 3: Inserir o Código no WhatsApp: No seu smartphone, abra o aplicativo WhatsApp e siga estes passos:
- Vá em Configurações (ou Ajustes no iOS).
- Selecione Aparelhos Conectados.
- Toque em Conectar com Número de Telefone.
- Insira o código de pareamento fornecido pelo terminal.
- Conexão Bem-Sucedida: O bot será conectado ao seu WhatsApp e começará a funcionar.
⚠️ Observações Cruciais para uma Conexão Segura e Estável:
- Número Secundário: Reforçamos a importância de usar um número de telefone secundário e exclusivo para o bot. Isso minimiza o risco de banimento da sua conta principal do WhatsApp, que pode ocorrer devido às políticas de uso de automação.
- QR Code Expirado: Se o QR code exibido no terminal expirar antes que você consiga escanear o código, simplesmente execute
npm startnovamente para gerar um novo QR code.- Sessão Salva Automaticamente: A sessão de conexão do bot é salva automaticamente em um arquivo. Isso garante que, em futuras execuções, o bot se reconecte ao WhatsApp sem a necessidade de um novo QR code ou código de pareamento, a menos que a sessão seja corrompida ou você a desconecte manualmente.
Manter seu nazuna Bot atualizado é essencial para garantir acesso às últimas funcionalidades, melhorias de desempenho e correções de segurança. O processo de atualização é simples e seguro:
Para atualizar o bot para a versão mais recente disponível no repositório oficial, navegue até o diretório do projeto nazuna no seu terminal e execute o seguinte comando:
npm run updateEste comando irá baixar as últimas alterações do repositório e atualizar as dependências, tudo isso sem afetar suas configurações personalizadas ou o histórico de conversas do bot.
✅ Atualização Segura e Sem Perdas: O processo de atualização foi projetado para ser não-destrutivo. Suas configurações (como o arquivo
config.json) e os dados de sessão do bot não serão apagados, garantindo uma transição suave para a nova versão.
O nazuna Bot é incrivelmente versátil e pode ser executado em diversas plataformas. Escolha o tutorial que corresponde ao seu ambiente para um guia de instalação detalhado e otimizado:
Este guia detalha a instalação do nazuna Bot em sistemas operacionais Windows, desde a preparação do ambiente até a execução e manutenção do bot.
-
Pré-requisitos para Windows
Antes de começar, certifique-se de ter os seguintes softwares instalados:- Node.js: Baixe e instale a versão LTS (Long Term Support) recomendada em nodejs.org. Durante a instalação, certifique-se de que a opção
Adicionar ao PATHesteja marcada, ou adicione manualmente. - Git para Windows: Faça o download e instale o Git a partir de git-scm.com/downloads. Este pacote inclui o Git Bash, um terminal que pode ser útil.
- Verificação: Abra o Prompt de Comando (CMD) ou PowerShell e execute os seguintes comandos para verificar se o Node.js e o Git foram instalados corretamente:
Você deverá ver as versões instaladas de cada um.
node -v git --version
- Node.js: Baixe e instale a versão LTS (Long Term Support) recomendada em nodejs.org. Durante a instalação, certifique-se de que a opção
-
Clonar o Repositório e Instalar Dependências
Abra o Prompt de Comando ou PowerShell e execute os comandos abaixo. Eles irão clonar o repositório do nazuna Bot e instalar todas as dependências necessárias:git clone https://github.com/hiudyy/nazuna.git cd nazuna npm run config npm run config:install- Solução de Problemas: Se você encontrar erros durante a instalação das dependências, tente executar
npm installdiretamente. Certifique-se também de que sua conexão com a internet está estável.
- Solução de Problemas: Se você encontrar erros durante a instalação das dependências, tente executar
-
Rodar o Bot no Windows
Para iniciar o nazuna Bot, execute o seguinte comando no terminal:npm start
Siga as instruções na tela para conectar o bot ao seu WhatsApp via QR code ou código de pareamento.
-
Manter o Bot Online (Opcional)
Para que o nazuna Bot funcione 24 horas por dia, 7 dias por semana, sem a necessidade de manter o terminal aberto, você pode configurá-lo como um serviço do Windows usando o NSSM (Non-Sucking Service Manager).- Instalação do NSSM: Baixe o NSSM, extraia o executável e adicione-o ao PATH do sistema ou copie-o para uma pasta acessível.
- Configuração do Serviço: Abra o Prompt de Comando ou PowerShell como administrador e execute:
Substitua
nssm install nazuna "C:\caminho\para\node.exe" "C:\caminho\para\nazuna\app.js"
C:\caminho\para\node.exeeC:\caminho\para\nazuna\app.jspelos caminhos corretos em seu sistema. - Alternativa Simples: Se você não quiser usar o NSSM, pode simplesmente deixar a janela do Prompt de Comando ou PowerShell aberta. No entanto, fechar a janela encerrará o processo do bot.
💡 Dica para Windows: Se o bot parar de funcionar inesperadamente, verifique sua conexão com a internet, certifique-se de que o processo não foi encerrado e, se necessário, reinicie-o com
npm start.
Este guia abrange a instalação do nazuna Bot em distribuições Linux baseadas em Debian/Ubuntu, mas os princípios podem ser aplicados a outras distribuições com pequenas adaptações.
-
Pré-requisitos para Linux
Abra o terminal e atualize os pacotes do sistema. Em seguida, instale o Node.js e o Git:sudo apt update && sudo apt upgrade -y sudo apt install -y nodejs git- Verificação: Verifique se o Node.js e o Git foram instalados corretamente:
node -v git --version
- Verificação: Verifique se o Node.js e o Git foram instalados corretamente:
-
Clonar o Repositório e Instalar Dependências
No terminal, execute os seguintes comandos para clonar o repositório do nazuna Bot e instalar suas dependências:git clone https://github.com/hiudyy/nazuna.git cd nazuna npm run config npm run config:install -
Rodar o Bot no Linux
Para iniciar o nazuna Bot, execute:npm start
Siga as instruções na tela para conectar o bot ao seu WhatsApp.
-
Rodar em Segundo Plano com PM2 (Recomendado)
Para garantir que o nazuna Bot continue funcionando mesmo após você fechar o terminal, recomendamos o uso dopm2, um gerenciador de processos para Node.js.- Instalação do PM2: Instale o
pm2globalmente com o seguinte comando:npm install -g pm2
- Iniciando o Bot com PM2: Inicie o nazuna Bot como um processo gerenciado pelo
pm2:pm2 start npm --name "nazuna" -- start - Salvando o Processo: Para que o
pm2reinicie o bot automaticamente após uma reinicialização do sistema, execute:pm2 save
- Monitoramento: Você pode monitorar os logs do bot em tempo real com
pm2 logs nazunae verificar o status compm2 status.
- Instalação do PM2: Instale o
💡 Dica para Linux: Se o bot desconectar ou parar de funcionar, você pode reiniciá-lo facilmente com o comando
pm2 restart nazuna. Para parar o bot, usepm2 stop nazuna.
Este tutorial abrangente detalha a instalação do nazuna Bot no Termux, desde o download do aplicativo até a execução do bot, com foco em evitar e solucionar erros comuns.
-
Instalar o Termux (Fonte Confiável)
- Crucial: Baixe e instale o Termux exclusivamente através do F-Droid. A versão disponível na Google Play Store está desatualizada e pode causar problemas de compatibilidade e instalação.
-
Configuração Inicial e Permissões do Termux
Após abrir o Termux pela primeira vez, é vital atualizar os pacotes e conceder as permissões de armazenamento. Este passo é crucial para evitar erros de "Permissão negada" e garantir que o bot possa salvar seus arquivos de sessão.pkg update && pkg upgrade -y termux-setup-storage- Explicação Detalhada:
pkg update && pkg upgrade -y: Este comando duplo primeiro atualiza a lista de pacotes disponíveis e, em seguida, atualiza todos os pacotes já instalados para suas versões mais recentes. O-yaceita automaticamente todas as perguntas de confirmação, agilizando o processo.termux-setup-storage: Este comando solicita a permissão do Android para que o Termux possa acessar o armazenamento interno do seu dispositivo. Você deve conceder esta permissão quando a caixa de diálogo aparecer. Sem ela, o bot não conseguirá criar ou acessar a pasta de sessão, resultando em erros fatais.
- Explicação Detalhada:
-
Instalar Pré-requisitos Essenciais (Node.js e Git)
Agora, instale as ferramentas fundamentais para o funcionamento do bot. O Node.js é o ambiente de execução do JavaScript, e o Git é usado para clonar o repositório do bot do GitHub.pkg install nodejs git -y
- Explicação:
pkg install nodejs git -y: Instala as versões mais recentes do Node.js e do Git disponíveis nos repositórios do Termux. O-yaceita automaticamente as confirmações.
- Verificação de Instalação: Para confirmar que o Node.js e o Git foram instalados corretamente, execute os seguintes comandos:
Você deverá ver as versões instaladas de cada um, confirmando que o ambiente está pronto.
node -v git --version
- Explicação:
-
Clonar o Repositório do Bot para o Armazenamento Compartilhado
Navegue até a pasta de armazenamento interno (onde o Termux tem permissão de escrita) e clone o repositório do nazuna Bot. Isso garante que os arquivos do bot sejam acessíveis e não sejam perdidos.cd ~/storage/shared git clone https://github.com/hiudyy/nazuna.git cd nazuna
- Explicação:
cd ~/storage/shared: Muda o diretório atual para a pastashareddentro do armazenamento do Termux, que geralmente mapeia para o armazenamento interno do seu dispositivo Android. É o local ideal para clonar projetos, evitando problemas de permissão.git clone https://github.com/hiudyy/nazuna.git: Baixa todo o código-fonte do nazuna Bot para uma nova pasta chamadanazuna.cd nazuna: Entra na pasta recém-criada do bot, onde todos os comandos subsequentes devem ser executados.
- Explicação:
-
Instalar as Dependências do Bot
O nazuna Bot depende de várias bibliotecas Node.js para funcionar. O comandonpm run config:installirá instalá-las de forma otimizada.npm run config npm run config:install
- Explicação:
npm run config: Executa um script de configuração inicial que prepara o ambiente do bot.npm run config:install: Instala todas as dependências listadas no arquivopackage.jsondo bot, garantindo que todas as funcionalidades operem corretamente.
- Solução de Problemas: Se você encontrar erros durante esta etapa, como
npm: command not foundou problemas de permissão, certifique-se de que o Node.js foi instalado corretamente (passo 3) e que você concedeu as permissões de armazenamento (passo 2). Tente tambémnpm installdiretamente.
- Explicação:
-
Rodar o Bot no Termux
Com todas as dependências instaladas, você está pronto para iniciar o nazuna Bot.npm start
- Explicação: Este comando inicia o bot. Ele irá guiá-lo através do processo de conexão com o WhatsApp (via QR code ou código de pareamento).
- Manter o Bot Online: Para que o bot continue funcionando, o aplicativo Termux precisa permanecer aberto e o celular ligado. Considere usar aplicativos de "manter tela ligada" ou "manter acordado" para evitar que o sistema Android suspenda o Termux em segundo plano. Além disso, desative as otimizações de bateria para o Termux nas configurações do seu Android.
-
Atualizando o Bot no Termux
Para atualizar o bot para a versão mais recente, navegue até a pasta do bot e execute:cd ~/storage/shared/nazuna npm run update
- Solução de Problemas Pós-Atualização: Se o bot parar de funcionar após uma atualização ou por qualquer outro motivo, tente reiniciar o processo. Certifique-se de estar na pasta
nazunae executenpm startnovamente.
- Solução de Problemas Pós-Atualização: Se o bot parar de funcionar após uma atualização ou por qualquer outro motivo, tente reiniciar o processo. Certifique-se de estar na pasta
💡 Dica Crucial para Termux: Se você encontrar o erro "Permissão negada" em qualquer etapa, é quase certo que as permissões de armazenamento não foram concedidas corretamente. Execute
termux-setup-storagenovamente e certifique-se de aceitar a permissão na caixa de diálogo do sistema.
Este guia detalha como configurar o nazuna Bot em um servidor Pterodactyl, oferecendo duas opções: o Egg oficial do nazuna, que automatiza a maior parte do processo, e um Egg Node.js comum, para maior controle manual.
Esta é a maneira mais fácil e rápida de colocar o nazuna Bot para rodar em um servidor Pterodactyl.
-
Baixar e Importar o Egg
- Download: Obtenha o arquivo JSON do Egg oficial do nazuna em: https://gitlab.com/hiudyy/nazuna-funcs/nazuna-egg.json.
- Importação: No painel de administração do Pterodactyl, navegue até Nests > Eggs e clique em Import Egg. Selecione o arquivo JSON baixado para importar o Egg do nazuna.
-
Criar o Servidor com o Egg do nazuna
- Crie um novo servidor e, na seleção de Egg, escolha o Egg do nazuna que você acabou de importar.
- Na seção Startup, configure as variáveis de ambiente conforme solicitado:
- Nome do Dono: Seu nome ou apelido (ex:
João). - Número do Bot: O número de telefone do bot, com o código do país (ex:
+5511999999999). - Prefixo do Bot: O símbolo que será usado para acionar os comandos (ex:
/). - Nome do Bot: O nome que o bot terá no WhatsApp (ex:
nazuna). - Atualização Automática: Selecione
Simpara que o bot se atualize automaticamente a cada reinicialização, ouNãopara atualizações manuais.
- Nome do Dono: Seu nome ou apelido (ex:
- Recursos: Aloque no mínimo 256MB de RAM e 256MB de disco. Para um desempenho ideal, recomendamos 512MB de RAM e 512MB de disco.
-
Iniciar o Servidor e Conectar ao WhatsApp
- Clique em Start no painel do Pterodactyl.
- O Egg irá clonar automaticamente o repositório (
https://github.com/hiudyy/nazuna.git) e instalar todas as dependências. - Utilize o console do Pterodactyl ou o VNC (se disponível) para visualizar o QR code ou obter o código de pareamento e conectar o bot ao WhatsApp.
-
Manutenção e Atualizações
- O Pterodactyl manterá o bot rodando 24/7.
- Se você desativou a atualização automática, pode atualizar o bot manualmente executando o seguinte comando no console do Pterodactyl:
npm run update
Esta opção oferece mais controle sobre a configuração, mas requer mais passos manuais.
-
Criar o Servidor com um Egg Node.js
- Crie um novo servidor utilizando um Egg Node.js padrão.
- Na seção Startup, defina o Comando de Inicialização como:
npm start. - Recursos: Aloque no mínimo 256MB de RAM e 256MB de disco. Recomendamos 512MB de RAM e 512MB de disco para um melhor desempenho.
-
Clonar o Repositório Manualmente
- Acesse o console do Pterodactyl e execute os seguintes comandos para clonar o repositório do nazuna Bot:
git clone https://github.com/hiudyy/nazuna.git cd nazuna
- Acesse o console do Pterodactyl e execute os seguintes comandos para clonar o repositório do nazuna Bot:
-
Instalar as Dependências
- No console, execute os comandos para instalar as dependências do bot:
npm run config npm run config:install
- No console, execute os comandos para instalar as dependências do bot:
-
Iniciar o Bot e Conectar ao WhatsApp
- Inicie o servidor no painel do Pterodactyl.
- Utilize o console para visualizar o QR code ou obter o código de pareamento e conectar o bot ao WhatsApp.
-
Atualizações Manuais
- Para atualizar o bot, você precisará executar manualmente o comando de atualização no console:
npm run update
- Para atualizar o bot, você precisará executar manualmente o comando de atualização no console:
💡 Dica para Pterodactyl: O Egg oficial do nazuna simplifica enormemente a instalação e a manutenção, automatizando a maioria dos processos. É a escolha recomendada para a maioria dos usuários.
Encontrou algum problema durante a instalação ou uso do nazuna Bot? Aqui estão as soluções para os problemas mais frequentes. Se sua dúvida não for respondida aqui, não hesite em nos contatar no Grupo do WhatsApp.
| Problema Comum | Solução Detalhada e Passo a Passo |
|---|---|
| “Comando não encontrado” (git, node, npm) | Este erro indica que o Git ou o Node.js não estão instalados corretamente ou não estão no PATH do sistema. Verifique a instalação com node -v e git --version. Se não retornarem versões, reinstale-os. No Termux, use pkg install git nodejs. |
| QR Code não funciona ou expira rapidamente | Causas Comuns: Conexão de internet lenta, terminal muito pequeno para exibir o QR code corretamente, ou demora para escanear. Soluções: 1) Aumente o tamanho da janela do terminal. 2) Verifique sua conexão com a internet. 3) Gere um novo QR code reiniciando o bot com npm start. 4) Tente o método de conexão com código de pareamento. |
| Bot desconecta frequentemente | Causas Comuns: Conexão de internet instável, recursos insuficientes (RAM/CPU), ou problemas com a sessão salva. Soluções: 1) Verifique sua conexão com a internet. 2) Monitore o uso de recursos do sistema. 3) Reinicie o bot com npm start. 4) Como último recurso, apague a pasta sessions (isso exigirá uma nova autenticação) e reinicie o bot. |
| Erro durante a instalação de dependências (npm install) | Causas Comuns: Conexão de internet instável, pacotes corrompidos no cache do npm, ou problemas de permissão. Soluções: 1) Verifique sua conexão com a internet. 2) Limpe o cache do npm com npm cache clean --force e tente novamente. 3) Certifique-se de que você tem permissões de escrita no diretório do projeto. 4) Verifique se você está usando a versão correta do Node.js (18+). |
| Termux para de funcionar em segundo plano | Causa: O sistema Android é agressivo ao fechar aplicativos em segundo plano para economizar bateria. Soluções: 1) Desative a otimização de bateria para o aplicativo Termux nas configurações do seu Android. 2) Use um aplicativo de "manter tela ligada" ou "manter acordado". 3) Reinicie o bot com cd /sdcard/nazuna && npm start. |
😊 Ainda com Problemas? Nossa comunidade está pronta para ajudar! Junte-se ao nosso Grupo do WhatsApp para obter suporte direto do criador e de outros usuários experientes.
O desenvolvimento e a manutenção do nazuna Bot são um trabalho de amor, mas também exigem tempo, esforço e recursos. Seu apoio é fundamental para garantir a continuidade e a evolução do projeto, permitindo a adição de novas funcionalidades, melhorias de desempenho e suporte contínuo à comunidade.
Se você aprecia o nazuna Bot e deseja contribuir para seu futuro, considere fazer uma doação. Cada contribuição, por menor que seja, faz uma grande diferença e é imensamente apreciada.
- 🇧🇷 Doações no Brasil (via Pix)
Chave Pix (CNPJ):60.374.533/0001-65
Qualquer valor é bem-vindo e nos ajuda a manter o projeto vivo e próspero!
❤️ Nossa Gratidão! Agradecemos imensamente a todos que apoiam o nazuna Bot. Sua generosidade é o que nos motiva a continuar inovando e aprimorando esta ferramenta para toda a comunidade!
Para aqueles que desejam rodar o nazuna Bot 24/7 em um ambiente estável e com bom custo-benefício, recomendamos a Latam Data Center.
- Site: latamdatacenter.com.br
- Por que recomendamos?: Oferecem planos de hospedagem acessíveis, com boa estabilidade e suporte em português, ideais para projetos como o nazuna Bot.
© 2025 Hiudy. Todos os direitos reservados.
O nazuna Bot é um projeto de código aberto, mas é protegido por copyright. Isso significa que, embora você tenha total liberdade para editar e distribuir o bot para uso pessoal ou em sua comunidade, a venda do nazuna Bot ou de suas versões modificadas é estritamente proibida, pois o projeto é oferecido gratuitamente. Além disso, a remoção total dos créditos do autor é vedada. Violações destas condições podem resultar em ações legais.
Feito com ❤️ e muitas xícaras de café por Hiudy, um desenvolvedor apaixonado por criar ferramentas que tornam a tecnologia mais divertida, acessível e poderosa. Ele está constantemente inovando e dedicando seu tempo ao nazuna Bot para aprimorar a experiência de toda a comunidade.
Estatísticas do Hiudy no GitHub:
Bio:
Hiudy é um entusiasta de tecnologia que se dedica a criar soluções práticas, inovadoras e com um toque de diversão. Além do nazuna Bot, ele contribui ativamente para diversos projetos open-source e valoriza a interação e o feedback da comunidade. Conecte-se com ele nas redes sociais para acompanhar seus próximos projetos e aventuras no mundo da programação!
- 📍 GitHub: hiudyy
- 💬 Discord: hiudyyy
- 📷 Instagram: hiudyyy_
- 📱 WhatsApp: wa.me/hiudy
🌟 Gostou do Projeto? Demonstre seu apoio dando uma estrela no GitHub e compartilhando o nazuna Bot com seus amigos e comunidades!
| Pergunta Frequente | Resposta Detalhada |
|---|---|
| Posso usar meu número de telefone principal com o bot? | Não é recomendado. O uso de automação no WhatsApp pode violar os termos de serviço da plataforma, e há um risco real de banimento da sua conta. Para sua segurança, utilize sempre um número de telefone secundário e dedicado exclusivamente ao bot. |
| O bot funciona se meu celular estiver offline? | Sim! Graças ao modo multi-dispositivos do WhatsApp, após a configuração inicial, o bot funciona de forma independente e não requer que seu celular esteja conectado à internet. |
| Como posso personalizar os comandos e as respostas do bot? | A personalização é um dos pontos fortes do nazuna Bot! Você pode editar o arquivo config.json após a instalação para alterar o prefixo, as mensagens de boas-vindas e outras configurações. Para personalizações mais avançadas, você pode editar diretamente os arquivos de comando na pasta do projeto. |
| O que fazer se meu servidor Pterodactyl travar ou o bot parar de responder? | Primeiro, verifique os logs do bot no console do Pterodactyl para identificar possíveis erros. Em seguida, tente reiniciar o servidor. Se o problema persistir, verifique se há recursos suficientes (RAM/CPU) alocados para o bot e considere atualizar o bot para a versão mais recente. |
💡 Tem Mais Dúvidas? Nossa comunidade e o criador estão sempre dispostos a ajudar! Pergunte no Grupo do WhatsApp e teremos prazer em auxiliá-lo!