Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Ollyky/saksa

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 

Repository files navigation

🤖 nazuna Bot: Seu Assistente Completo para WhatsApp

nazuna Bot Banner

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.


✨ Por que o nazuna Bot se Destaca?

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 /menu no WhatsApp para desvendar um universo de comandos e funcionalidades que o nazuna Bot oferece!


📊 Estatísticas Detalhadas do Projeto

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:

Ícone Badge Descrição Detalhada
🕒 Última Atualização Última Atualização: Indica a data do último commit realizado no repositório, mostrando a atividade recente de desenvolvimento.
Estrelas Favoritos (Estrelas): Representa o número de estrelas concedidas ao projeto no GitHub, um indicador direto da popularidade e do apreço da comunidade.
🍴 Forks Forks: Contagem de cópias do projeto (forks) criadas por outros desenvolvedores, evidenciando o interesse em colaborar ou adaptar o bot.
🐞 Issues Issues: Número de problemas reportados, sugestões de melhoria ou dúvidas levantadas pela comunidade, essenciais para o aprimoramento do bot.
📝 Commits Commits: Frequência de atualizações no código-fonte, refletindo a intensidade do trabalho de desenvolvimento e manutenção.
💾 Tamanho do Repo Tamanho do Repositório: O espaço total ocupado pelo projeto no GitHub, incluindo todos os arquivos e histórico de versões.
👥 Contribuidores Contribuidores: Lista de todas as pessoas que contribuíram ativamente com código ou documentação para o projeto.
📥 Downloads Downloads: O número total de vezes que o projeto foi baixado, indicando sua adoção e uso.
🌐 Linguagens Linguagens: As principais linguagens de programação utilizadas no desenvolvimento do nazuna Bot, com destaque para a mais predominante.
🔄 PRs Pull Requests: Propostas de melhorias ou novas funcionalidades enviadas por colaboradores, aguardando revisão e integração.
⏱️ Tempo de Resposta Tempo de Resposta (Issues): Média de tempo que leva para uma issue ser resolvida e fechada, demonstrando a agilidade da equipe.
📜 Licença Licença: Informa que o projeto é protegido por copyright, com as condições de uso e distribuição detalhadas na seção de Licença.
Status Status: Indica que o projeto está ativo e em constante desenvolvimento, com suporte e atualizações regulares.

📈 Visitas Totais ao Repositório:
Contador de Visitas
Este contador registra o número total de visualizações que o repositório do nazuna Bot recebeu, refletindo o interesse geral no projeto.


📢 Conecte-se à Comunidade Oficial

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!

Grupo WhatsApp
Clique para entrar no nosso grupo oficial do WhatsApp e faça parte da nossa crescente comunidade!


📜 Índice Detalhado

Navegue facilmente por todas as seções deste README para encontrar as informações que você precisa:

  1. 🚀 Primeiros Passos: Guia Rápido
  2. 📋 Pré-requisitos Essenciais
  3. 📥 Instalação do nazuna Bot
  4. 🚀 Rodando o Bot pela Primeira Vez
  5. 🔌 Conectando o Bot ao WhatsApp
  6. 🔄 Atualizando o nazuna Bot
  7. 💻 Tutoriais de Instalação por Plataforma
  8. ❓ Resolvendo Problemas Comuns (FAQ)
  9. 💖 Apoie o Projeto: Faça a Diferença
  10. 📜 Licença de Uso e Direitos Autorais
  11. 👤 Sobre o Criador: Hiudy
  12. ❔ FAQ Avançado e Dúvidas Frequentes

🚀 Primeiros Passos: Guia Rápido

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:

  1. 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.
  2. Baixe o Bot: Clone o repositório oficial do nazuna Bot do GitHub para o seu ambiente de trabalho.
  3. 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.
  4. Explore os Comandos: Após a conexão bem-sucedida, envie /menu para 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.


📋 Pré-requisitos Essenciais

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


📥 Instalação do nazuna Bot

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.

  1. 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 chamada nazuna será criada.
      • cd nazuna: Este comando muda o diretório de trabalho atual para a pasta nazuna, onde o bot está localizado. Todas as operações subsequentes devem ser executadas dentro desta pasta.
  2. 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 arquivo package.json do 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 executando node -v e npm -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-storage foi executado e a permissão concedida.
      • Outros Erros de Instalação: Se os comandos npm run config ou npm run config:install falharem, tente executar npm install diretamente. Este comando reinstala todas as dependências do zero e pode resolver problemas de pacotes corrompidos.

🚀 Rodando o Bot pela Primeira Vez

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 start

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


🔌 Conectando o Bot ao WhatsApp

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:

1. Conexão via QR Code (Recomendado para a maioria dos usuários)

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:
    1. Vá em Configurações (ou Ajustes no iOS).
    2. Selecione Aparelhos Conectados.
    3. Toque em Conectar um Aparelho.
    4. 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.

2. Conexão via Código de Pareamento (Ideal para dispositivos sem câmera ou acesso remoto)

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:
    1. Vá em Configurações (ou Ajustes no iOS).
    2. Selecione Aparelhos Conectados.
    3. Toque em Conectar com Número de Telefone.
    4. 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 start novamente 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.

🔄 Atualizando o nazuna Bot

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 update

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


💻 Tutoriais de Instalação por Plataforma

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:

🖥️ Windows: Guia Completo

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.

  1. 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 PATH esteja 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:
      node -v
      git --version
      Você deverá ver as versões instaladas de cada um.
  2. 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 install diretamente. Certifique-se também de que sua conexão com a internet está estável.
  3. 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.

  4. 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:
      nssm install nazuna "C:\caminho\para\node.exe" "C:\caminho\para\nazuna\app.js"
      Substitua C:\caminho\para\node.exe e C:\caminho\para\nazuna\app.js pelos 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.

🐧 Linux: Instalação e Configuração

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.

  1. 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
  2. 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
  3. 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.

  4. 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 do pm2, um gerenciador de processos para Node.js.

    • Instalação do PM2: Instale o pm2 globalmente 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 pm2 reinicie 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 nazuna e verificar o status com pm2 status.

💡 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, use pm2 stop nazuna.

📱 Termux (Android): Passo a Passo Detalhado

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.

  1. 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.
  2. 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 -y aceita 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.
  3. 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 -y aceita 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:
      node -v
      git --version
      Você deverá ver as versões instaladas de cada um, confirmando que o ambiente está pronto.
  4. 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 pasta shared dentro 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 chamada nazuna.
      • cd nazuna: Entra na pasta recém-criada do bot, onde todos os comandos subsequentes devem ser executados.
  5. Instalar as Dependências do Bot
    O nazuna Bot depende de várias bibliotecas Node.js para funcionar. O comando npm run config:install irá 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 arquivo package.json do bot, garantindo que todas as funcionalidades operem corretamente.
    • Solução de Problemas: Se você encontrar erros durante esta etapa, como npm: command not found ou 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ém npm install diretamente.
  6. 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.
  7. 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 nazuna e execute npm start novamente.

💡 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-storage novamente e certifique-se de aceitar a permissão na caixa de diálogo do sistema.

☁️ Pterodactyl: Configuração em Servidores

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.

Opção 1: Utilizando o Egg Oficial do nazuna (Recomendado)

Esta é a maneira mais fácil e rápida de colocar o nazuna Bot para rodar em um servidor Pterodactyl.

  1. 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.
  2. 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 Sim para que o bot se atualize automaticamente a cada reinicialização, ou Não para atualizações manuais.
    • Recursos: Aloque no mínimo 256MB de RAM e 256MB de disco. Para um desempenho ideal, recomendamos 512MB de RAM e 512MB de disco.
  3. 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.
  4. 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

Opção 2: Utilizando um Egg Node.js Comum

Esta opção oferece mais controle sobre a configuração, mas requer mais passos manuais.

  1. 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.
  2. 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
  3. Instalar as Dependências

    • No console, execute os comandos para instalar as dependências do bot:
      npm run config
      npm run config:install
  4. 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.
  5. Atualizações Manuais

    • Para atualizar o bot, você precisará executar manualmente o comando de atualização no console:
      npm run update

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


❓ Resolvendo Problemas Comuns (FAQ)

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.


💖 Apoie o Projeto: Faça a Diferença

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!


🌐 Recomendação de Hospedagem

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.

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.

📜 Licença de Uso e Direitos Autorais

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


👤 Sobre o Criador: Hiudy

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:

Ícone Badge Descrição
👥 Seguidores Seguidores: O número de pessoas que acompanham o trabalho do Hiudy no GitHub.
📝 Contribuições Contribuições: A atividade anual de commits do Hiudy em todos os seus projetos.
💬 Discord Discord: Conecte-se diretamente com o Hiudy no Discord para trocar ideias e obter suporte.
📷 Instagram Instagram: Siga o Hiudy no Instagram para ficar por dentro das últimas novidades e bastidores dos projetos.

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!

🌟 Gostou do Projeto? Demonstre seu apoio dando uma estrela no GitHub e compartilhando o nazuna Bot com seus amigos e comunidades!


❔ FAQ Avançado e Dúvidas Frequentes

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!

About

A 100% editable, decrypted and free whatsapp bot.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%