O bot é seu. As regras também.
Administração, mídia e automações para grupos de WhatsApp, com uma instalação que você controla.
Código público · instância própria · whatsapp / node.js
Site oficial · Começar · Instalar no celular
Administração, mídia e automações para grupos de WhatsApp, com uma instalação que você controla.
| Frente | O que você encontra |
|---|---|
| Grupos | Regras, boas-vindas, menus e comandos administrativos com permissões. |
| Mídia | Figurinhas, utilitários e integração com processamento externo. |
| Autonomia | Você utiliza seu próprio número compatível e infraestrutura. |
npm startNote
A BunnyFy é opcional. Ela processa determinadas tarefas externas de mídia e IA; o bot continua tendo funções locais sem contratar a API. Quem já tem número compatível não precisa comprar outro. Este projeto é independente do WhatsApp.
Abrir a documentação técnica anterior · comandos, decisões, créditos e detalhes de implantação
O SHOGUN reúne ferramentas de grupo, figurinhas e comandos úteis no WhatsApp, com configuração local e menus que acompanham as permissões de cada pessoa.
Instalar e rodar sua própria instância é gratuito. Você escolhe o aparelho ou servidor. Internet, energia, hospedagem e integrações de terceiros podem ter custos próprios.
Conheça o site · Primeiros passos · Contato pelo WhatsApp
Escolha seu sistema. Os guias explicam os pré-requisitos, a configuração, o pareamento e como retomar a sessão.
| Sistema | Guia | Iniciar, dentro da pasta do projeto |
|---|---|---|
| Windows | PowerShell | npm start |
| Linux | Terminal | npm start |
| macOS | Terminal e Homebrew | npm start |
| Android | Termux | npm start |
O projeto requer Node.js 20.19 ou superior, npm 9 ou superior e Git. Para uma instalação nova, use Node.js 24 LTS.
FFmpeg e FFprobe: npm start prepara os executáveis compatíveis no Windows, Linux e macOS quando eles não estão instalados. No Android, execute pkg install -y ffmpeg no Termux. Cada guia também explica como instalar manualmente caso a preparação automática falhe.
npm startDepois de extrair o projeto, execute npm start dentro da pasta. As dependências são instaladas automaticamente. Informe somente nome do bot, número do dono, número do bot e chave BunnyFy opcional. Sem chave paga, conversa e modelos continuam disponíveis; os outros serviços têm 20 chamadas por dia, controladas na API. Não altere o endereço oficial da BunnyFy.
Escolha QR ou código de pareamento quando solicitado. No WhatsApp conectado, envie !menu (ou o prefixo que você configurou). Comece em uma conversa ou grupo de teste.
npm run setupabre a configuração local.Ctrl+Cencerra o processo;npm startretoma a instalação.- Primeiros passos explica conexão, permissões, backup e atualização.
- Solução de problemas ajuda a interpretar falhas comuns.
O menu apresenta comandos conforme as permissões reais. Comandos administrativos exigem os papéis correspondentes; o menu não concede privilégios. Só dê cargo de administrador ao bot quando entender as rotinas que pretende usar.
Sessão e configuração ficam na sua instalação. O bot se conecta ao WhatsApp, e integrações opcionais podem enviar dados aos respectivos fornecedores. Não publique arquivos de sessão, chaves, códigos de pareamento ou backups privados. O SHOGUN é independente e não é um produto oficial do WhatsApp; mudanças na plataforma podem afetar a conexão.
Você pode rodar por conta própria ou conversar sobre serviços opcionais. Disponibilidade, limites, suporte e preço são combinados no atendimento antes de qualquer contratação. Esses serviços não são requisito para acessar o código e instalar o bot.
Distribuído sob a licença ISC. Direção e manutenção: Maurício Almeida. Os créditos e avisos de autoria estão em NOTICE; preserve-os ao redistribuir o projeto.
O tema SHOGUN v3 aplica a mesma identidade aos menus, respostas e legendas. Os campos personalizados do tema anterior são preservados. Donos podem ajustar o desenho pelo comando menudesign (também disponível como design). Texto, menções, mídia e código mantêm seu conteúdo.
O bot usa ⏳ durante a execução, ✅ após o envio confirmado e
!instagram <URL> aceita publicações, Reels e carrosséis, com até 20 itens enviados em ordem. Reels usam MP4 com áudio e vídeo. !igstory https://www.instagram.com/stories/usuario/ usa a mesma integração; a disponibilidade depende dos stories ativos e da sessão configurada no servidor BunnyFy. As credenciais e cookies do Instagram ficam no servidor da API.
O tema, o cache de renderização, a validação de reações e o executor Instagram já têm implementação única em TypeScript estrito (src/presentation e src/downloads). Os compilados correspondentes acompanham o pacote. A migração de todos os domínios continua: 131 famílias/709 tokens são nativos; 395 famílias/894 tokens ainda usam compatibilidade. A portagem desses módulos compartilhados não aumenta artificialmente a contagem de comandos nativos.
A camada de apresentação completa (menus, cards e transporte) e a fila de mensagens também foram portadas para TypeScript. A fila recusa trabalho após o início do encerramento, libera comandos mesmo quando um serviço rejeita com um valor que não é Error e valida os limites de concorrência. O teto de quatro comandos por pessoa e por grupo é preservado, incluindo o fallback de participante da mensagem.
O cache de reenvio também usa uma implementação única em TypeScript e respeita o limite de bytes ao restaurar mensagens. O encerramento do otimizador cancela seus monitores e fecha os caches; o limiar configurado de pressão de memória é aplicado. Os contratos do núcleo e da apresentação são exercitados no CI em Windows e Linux, nas versões Node.js da matriz suportada.
O gerenciador de caches também foi portado para TypeScript. A expiração e a limpeza removem metadados de LRU/acesso, as contagens são isoladas por cache e escritas recusadas não deixam metadados órfãos. TTL zero é respeitado. A compressão conserva Buffer e tipos nativos aninhados; valores de classes próprias permanecem sem compressão para conservar seus métodos. Desativar novas compressões mantém entradas anteriores legíveis.