SHOGUNWHATSAPP BOT GitHub
O gato preto do Shogun, com olhos vermelhos, sobre um círculo de tinta vermelha

BOT PARA WHATSAPP

SHOGUNModeração, mídia
e jogos para seu grupo.

Administre sua comunidade, crie figurinhas, baixe conteúdo e use os jogos do bot direto na conversa. Com comandos organizados e permissões para cada função.

Código aberto. Sua própria instância é gratuita.

Windows · Linux · macOS · Android com TermuxVer o repositório ↗

O que o Shogun faz.

As funções ficam separadas em menus. Você pode configurar o prefixo da sua instância e consultar os comandos disponíveis pelo WhatsApp.

01

Administração de grupos

Configure regras, boas-vindas, proteções contra links e rotinas de moderação. As ações de administração respeitam os cargos do grupo e as permissões do bot.

!menuadm
02

Downloads e figurinhas

Consulte as opções de download, crie figurinhas e use ferramentas de áudio e imagem. Algumas funções precisam de uma integração configurada na instância.

!menudown · !menufig
03

Jogos e interação

Brincadeiras, rankings, RPG, NEXO e Tavern disponíveis em menus próprios. O grupo escolhe quais atividades quer usar.

!menubn · !menurpg

Cada categoria,
seu próprio menu.

Os novos menus trazem uma arte para cada categoria e organizam o texto para facilitar a consulta dos comandos no celular.

Arte do menu de figurinhas do Shogun
Figurinhas !menufig
Arte do menu de downloads do Shogun
Downloads !menudown

Comandos por função.

Membros, administradores, subdonos e donos têm níveis de acesso diferentes. O bot usa essas permissões para exibir os menus e autorizar cada comando.

Prévia ilustrativa. Use !menu no WhatsApp para consultar a sua instância.

SHOGUNPRÉVIA DO MENU
O prefixo pode ser alterado na configuração.

Instale a sua instância.

Escolha a plataforma para abrir o tutorial. Você precisa de um dispositivo ou servidor ligado e de uma conta do WhatsApp para conectar o bot.

1

Prepare o ambiente.

Git, Node.js e FFmpeg. O tutorial da sua plataforma mostra os requisitos e como instalar cada um.

2

Configure sua instância.

Baixe e extraia o projeto. Execute npm start: as dependências são instaladas e a configuração pede nome do bot, número do dono, número do bot e chave BunnyFy opcional.

3

Conecte no WhatsApp.

Inicie o bot e siga a conexão exibida no terminal. Com o processo ligado, teste o menu no WhatsApp.

A instância é sua.

O Shogun não tem mensalidade obrigatória. Servidor, hospedagem assistida e serviços de API são escolhas à parte.

NODE.JS · GIT · FFMPEG

Primeiro, prepare as ferramentas.

Node.js executa o bot. Git baixa o projeto e algumas dependências. Escolha a plataforma acima para ver os comandos de instalação:

winget install --id OpenJS.NodeJS.LTS --exact --source winget
winget install --id Git.Git --exact --source winget

Feche e reabra o terminal após instalar. Confira node --version, npm.cmd --version e git --version.

Download oficial do Node.js ↗
FFmpeg: áudio, vídeo e figurinhas

A nova instalação prepara FFmpeg e FFprobe pelo npm start nas plataformas compatíveis. Se o download falhar, instale o pacote do sistema. No Termux, essa instalação é necessária:

winget install --id Gyan.FFmpeg --exact --source winget

Na instalação manual, confira ffmpeg -version e ffprobe -version. Os dois precisam mostrar suas versões. O guia completo explica as alternativas e o PATH.

No PowerShell, com os requisitos do guia instalados:

git clone https://github.com/dgreych/shogun.git
cd shogun
npm start
Abrir guia completo ↗

O primeiro início pede configuração e conexão. O tutorial explica cada etapa, sem pular os requisitos.

API PARA BOTS E PROJETOS

BUNNYFY

Integre os serviços de mídia.

Conversa e escolha de modelo estão disponíveis em todas as instâncias. Sem chave paga, a BunnyFy oferece 20 chamadas por dia para downloads, transcrição, geração de imagens e outros serviços. A contagem é feita na API e renova à meia-noite de Brasília. Para ampliar o uso, consulte uma assinatura.

Consultar acesso à API ↗
HOSPEDAGEM E CONFIGURAÇÃO

SHOGUN

Instalação assistida para sua comunidade.

Solicite uma proposta de hospedagem e configuração. Disponibilidade, suporte e valores são combinados no atendimento. Rodar a sua própria instância continua sendo gratuito.

Consultar hospedagem ↗

Perguntas frequentes.

Preciso pagar para usar o Shogun?

Rodar sua própria instância do Shogun é gratuito. Você fornece o dispositivo ou servidor e mantém o processo ligado. Hospedagem assistida e serviços externos de API são opcionais e podem ter custos próprios.

Funciona no celular?

Sim, no Android com Termux. Siga o guia específico, mantenha a sessão do terminal ativa e confira as orientações de bateria. No iPhone, use um servidor ou computador para hospedar o processo do bot.

Como conecto a conta do WhatsApp?

Depois da configuração, inicie o bot e siga o QR ou código de conexão apresentado no terminal. Os tutoriais mostram o vínculo pelo menu de aparelhos conectados do WhatsApp.

Onde encontro ajuda se algo falhar?

Comece pelo guia de solução de problemas. Ele explica requisitos, instalação, conexão e os erros mais comuns. Para hospedagem e API, use o contato abaixo.

Fale sobre
o seu projeto.

Para hospedagem, acesso à BunnyFy ou orientação sobre o Shogun, escolha o assunto e continue pelo WhatsApp.

+55 (22) 99702-8553 ↗

Você pode revisar a mensagem no WhatsApp antes de enviar.