# 🤖 AKIRA BOT V21.02.2025 - GUIA COMPLETO DE COMANDOS ## 📋 Índice 1. [Comandos Públicos](#comandos-públicos) 2. [Comandos de Perfil](#comandos-de-perfil) 3. [Comandos de Moderação](#comandos-de-moderação) 4. [Comandos de Mídia](#comandos-de-mídia) 5. [Sistema de Permissões](#sistema-de-permissões) 6. [Sistema de Rate Limiting](#sistema-de-rate-limiting) 7. [Logging e Segurança](#logging-e-segurança) --- ## Comandos Públicos ### #help | #menu | #comandos | #ajuda **Descrição:** Mostra menu completo com todos os comandos disponíveis **Uso:** `#help` **Permissão:** Pública (Todos) **Exemplos:** ``` #help #menu #comandos ``` ### #ping **Descrição:** Testa latência e status do bot **Uso:** `#ping` **Permissão:** Pública (Todos) **Retorna:** - Latência em ms - Uptime do bot - Status da conexão - URL da API ### #info | #botinfo | #about **Descrição:** Informações completas do bot **Uso:** `#info` **Permissão:** Pública (Todos) **Mostra:** - Nome e versão - Desenvolvedor e localização - Recursos implementados - Serviços de áudio - Informações de segurança - Comandos rápidos ### #donate | #doar | #apoiar | #doacao **Descrição:** Formas de apoiar o projeto **Uso:** `#donate` **Permissão:** Pública (Todos) **Mostra:** - Benefícios de apoiar - Formas de pagamento (PIX, Ko-fi, PayPal) - Valores sugeridos - Benefícios do apoiador - Impacto de cada doação --- ## Comandos de Perfil ### #perfil | #profile | #myperfil **Descrição:** Visualiza seu perfil pessoal e estatísticas **Uso:** `#perfil` **Permissão:** Pública (Todos) **Mostra:** - Informações pessoais (nome, idade) - Nível e XP atual - Progresso para próximo nível - Conquistas desbloqueadas - Dicas para subir de nível **Exemplo de Saída:** ``` 👤 SEU PERFIL 📝 INFORMAÇÕES PESSOAIS Nome: Isaac Quarenta Idade: 25 anos Registrado em: 24/01/2026 🎮 ESTATÍSTICAS DE JOGO Nível: 15 Experiência (XP): 4.250 Próximo nível: 5.000 Progresso: ██████░░░░ 85% 🏆 CONQUISTAS ✅ Bronze - Nível 5 ✅ Prata - Nível 10 ⬜ Ouro - Nível 25 ⬜ Platina - Nível 50 ⬜ Diamante - Nível 100 ``` ### #registrar Nome|Idade **Descrição:** Registra novo usuário no sistema **Uso:** `#registrar Isaac Quarenta|25` **Permissão:** Pública (Todos) **Validações:** - Nome obrigatório - Idade entre 1-120 anos - Formato: Nome|Idade - Não pode registrar duas vezes **Exemplo:** ``` #registrar João Silva|30 ``` **Retorna:** - ID serial único - Data de registro - Nível inicial (1) - XP inicial (0) ### #level | #nivel | #rank **Descrição:** Ver nível e progresso no grupo / Gerenciar sistema de leveling (Dono) **Uso:** - Ver nivel: `#level` - Ativar: `#level on` - Desativar: `#level off` - Status: `#level status` **Permissão:** - Ver nível: Pública - Gerenciar: Apenas Dono **Mostra:** - Nível atual no grupo - XP acumulado - Progresso até próximo nível - Barra visual de progresso --- ## Comandos de Moderação ### #add **Descrição:** Adiciona membro ao grupo **Uso:** `#add 244937035662` **Permissão:** Apenas Dono **Requer:** Bot deve ser admin **Log:** Registra ação no arquivo de admin_actions.log **Exemplo:** ``` #add 244937035662 ``` **Resposta:** ``` ✅ 244937035662 foi adicionado ao grupo com sucesso! ``` ### #remove | #kick | #ban @usuário **Descrição:** Remove/bane membro do grupo **Uso:** - Com @mention: `#remove @João` - Com reply: Responda mensagem + `#remove` **Permissão:** Apenas Dono **Requer:** Bot deve ser admin **Log:** Registra ação e quantidade de removidos **Exemplos:** ``` #remove @João #ban @Maria #kick @Pedro ``` ### #promote @usuário **Descrição:** Promove membro a admin **Uso:** - Com @mention: `#promote @João` - Com reply: Responda mensagem + `#promote` **Permissão:** Apenas Dono **Requer:** Bot deve ser admin **Log:** Registra promoção ### #demote @usuário **Descrição:** Remove admin do grupo **Uso:** - Com @mention: `#demote @João` - Com reply: Responda mensagem + `#demote` **Permissão:** Apenas Dono **Requer:** Bot deve ser admin **Log:** Registra rebaixamento ### #mute @usuário **Descrição:** Silencia usuário por tempo progressivo **Uso:** - Com @mention: `#mute @João` - Com reply: Responda mensagem + `#mute` **Permissão:** Apenas Dono **Duração:** 5 minutos (progressivo se reincidente) **Progressão:** - 1ª vez: 5 minutos - 2ª vez: 10 minutos - 3ª vez: 20 minutos - 4ª vez: 40 minutos - etc (exponencial) **Comportamento:** - Usuário não consegue enviar mensagens - Se tenta enviar: mensagem é deletada - Se persiste: é removido do grupo automaticamente **Log:** Registra cada mute com duração e contagem ### #desmute @usuário **Descrição:** Remove silenciamento do usuário **Uso:** - Com @mention: `#desmute @João` - Com reply: Responda mensagem + `#desmute` **Permissão:** Apenas Dono **Log:** Registra remoção de silenciamento ### #antilink on | off | status **Descrição:** Ativa/desativa remoção automática de links **Uso:** - Ativar: `#antilink on` - Desativar: `#antilink off` - Ver status: `#antilink status` **Permissão:** Apenas Dono **Comportamento:** - Detecta URLs (https://, www., bit.ly, t.me, wa.me, etc) - Deleta mensagem com link automaticamente - Remove usuário do grupo **Padrões detectados:** - `https://` | `http://` - `www.` - `bit.ly/` - `t.me/` - `wa.me/` - `chat.whatsapp.com/` **Log:** Registra cada ação de anti-link --- ## Comandos de Mídia ### #sticker | #s | #fig **Descrição:** Cria sticker de imagem **Uso:** - Enviar imagem com comando: `#sticker` - Reply em imagem: Responda + `#sticker` **Permissão:** Pública (Todos) **Aceita:** - PNG, JPG, JPEG - Stickers (copia) **Personalização:** - Nome automático: [Nome do Usuário]'s Pack - Autor: Nome do usuário ### #gif **Descrição:** Cria sticker animado de vídeo **Uso:** - Enviar vídeo com comando: `#gif` - Reply em vídeo: Responda + `#gif` **Permissão:** Pública (Todos) **Limitações:** - Máximo 30 segundos - Máximo 500KB - Formato: MP4, AVI, MOV **Exemplo:** ``` [Enviar vídeo de 10s] #gif → Sticker animado criado ``` ### #toimg | #img | #unstick **Descrição:** Converte sticker para imagem PNG **Uso:** Responda sticker + `#toimg` **Permissão:** Pública (Todos) **Retorna:** Imagem PNG ### #play **Descrição:** Baixa áudio do YouTube **Uso:** - Por nome: `#play Imagine John Lennon` - Por link: `#play https://youtu.be/...` **Permissão:** Pública (Todos) **Limitações:** - Máximo 25MB - Recomendado: até 10 minutos **Métodos:** - API externa confiável (primeiro) - ytdl-core (fallback) **Retorna:** Arquivo MP3 ### #tts **Descrição:** Converte texto para áudio (Text-to-Speech) **Uso:** `#tts pt Olá, como você está?` **Permissão:** Pública (Todos) **Limitações:** - Máximo 200 caracteres - Idiomas suportados: pt, en, es, fr, de, it, ja, ko, zh, ar, ru, hi, pt-BR, pt-PT, en-US, en-GB **Idiomas:** - `pt` = Português - `en` = English - `es` = Español - `fr` = Français - `de` = Deutsch - `ja` = 日本語 - `ko` = 한국어 - `zh` = 中文 **Exemplo:** ``` #tts pt Olá mundo! #tts en Hello world! #tts es ¡Hola mundo! ``` --- ## Sistema de Permissões ### Níveis de Acesso #### 🔓 Pública (Todos) - `#help`, `#menu`, `#ping`, `#info`, `#donate` - `#perfil`, `#registrar`, `#level` - `#sticker`, `#gif`, `#toimg`, `#play`, `#tts` - Áudio inteligente (STT/TTS automático) #### 🔐 Apenas Dono (Isaac Quarenta) - `#add` - Adicionar membros - `#remove`, `#kick`, `#ban` - Remover membros - `#promote`, `#demote` - Gerenciar admins - `#mute`, `#desmute` - Silenciar usuários - `#antilink on/off` - Controlar anti-link - `#level on/off` - Gerenciar leveling #### ⏳ Premium Features (1x a cada 90 dias para usuários) - Ferramentas de segurança avançadas - Acesso a recursos experimental - Resgates especiais **Owners têm:** Acesso ilimitado a tudo --- ## Sistema de Rate Limiting ### Proteção contra Spam #### Rate Limit Global - **Window:** 8 segundos - **Máximo:** 6 comandos por janela - **Aplicado a:** Todos os usuários - **Mensagem:** "⏰ Você está usando comandos muito rápido" ### Premium Feature Cooldown - **Intervalo:** 90 dias (3 meses) - **Aplicado a:** Usuários comuns - **Owners:** Sem limite - **Redireciona para:** #donate --- ## Logging e Segurança ### Arquivo de Log Administrativo **Localização:** `logs/admin_actions.log` **Formato:** ``` [TIMESTAMP] ACTION | User: NOME (NUMERO) | Target: ALVO | Details: DETALHES ``` **Exemplo:** ``` [2026-01-24T16:30:45.123Z] MUTE_USER | User: Isaac Quarenta (244937035662) | Target: 244978787009@s.whatsapp.net | Details: 5 minutos [2026-01-24T16:32:10.456Z] REMOVE_MEMBERS | User: Isaac Quarenta (244937035662) | Target: 2 membros | Details: grupo: 120362032@g.us [2026-01-24T16:35:22.789Z] ANTILINK_ON | User: Isaac Quarenta (244937035662) | Target: 120362032@g.us | Details: Anti-link ativado ``` ### Ações Registradas - `ADD_MEMBER` - Membro adicionado - `REMOVE_MEMBERS` - Membros removidos - `PROMOTE_MEMBERS` - Membros promovidos - `DEMOTE_MEMBERS` - Membros rebaixados - `MUTE_USER` - Usuário mutado - `UNMUTE_USER` - Mutação removida - `WARN_USER` - Aviso registrado - `LEVEL_ON` - Sistema de níveis ativado - `LEVEL_OFF` - Sistema de níveis desativado - `ANTILINK_ON` - Anti-link ativado - `ANTILINK_OFF` - Anti-link desativado ### Proteção contra Abuso #### Detecção de Links Padrões detectados: - Qualquer URL (http/https) - URLs encurtadas (bit.ly) - Telegram (t.me) - WhatsApp (wa.me, chat.whatsapp.com) - Customizável via regex #### Comportamento ao Violar 1. Mensagem com link é **deletada automaticamente** 2. Usuário é **removido do grupo** 3. Ação é **registrada em log** 4. Aviso é enviado no grupo --- ## Funcionalidades Especiais ### Áudio Inteligente (STT/TTS) - **STT:** Deepgram nova-2 (transcrição) - **TTS:** Google Text-to-Speech (síntese) - **Ativação em Grupos:** Mencione "Akira" ou responda áudio - **Em PV:** Sempre ativo - **Transcrição:** Interna (nunca mostrada) ### Sistema de Níveis - **XP Automático:** Ao conversar naturalmente - **Progressão:** Exponencial (1000, 2000, 4000...) - **Por Grupo:** Níveis diferentes em cada grupo - **Conquistas:** Bronze (5), Prata (10), Ouro (25), Platina (50), Diamante (100) ### Sistema de Registro - **Armazenamento:** `database/datauser/registered.json` - **ID Serial:** Único por usuário - **Data:** Automática - **Vinculação:** JID do WhatsApp --- ## Dicas de Uso ### Para Maximizar XP 1. Converse naturalmente com o bot 2. Responda áudios do bot 3. Envie áudios para bot transcrever 4. Participe ativamente do grupo ### Para Usar Comandos de Moderação 1. Certifique-se que o bot é admin 2. Use @mentions ou reply 3. Verifique as permissões 4. Consulte o log de ações ### Para Criar Stickers Criativos 1. Use imagens em alta qualidade 2. Fundo transparente (PNG) é ideal 3. Tamanho: 512x512 ou similar 4. Vídeos até 30s funcionam melhor --- ## Suporte e Contato **Desenvolvedor:** Isaac Quarenta **WhatsApp:** +244 937 035 662 **Email:** isaac.quarenta@akira.bot **Localização:** 🇦🇴 Luanda, Angola **Versão:** v21.02.2025 **Status:** Enterprise Grade **Uptime:** 24/7 **SLA:** 99.9% --- ## Changelog ### v21.02.2025 (Current) - ✅ CommandHandler completo reescrito - ✅ Menus profissionais em ASCII art - ✅ Sistema de permissões robusto - ✅ Rate limiting avançado - ✅ Logging de ações administrativas - ✅ Premium features com cooldown - ✅ 15+ comandos funcionais ### v21.01.2025 - ✅ Contexto de reply otimizado - ✅ Mensagem citada enviada completa - ✅ Correção API_URL --- ## Licença e Termos Este bot é fornecido como está. O uso implica aceitação dos termos de serviço. Todas as ações administrativas são registradas para fins de segurança e auditoria. **Desenvolvido com ❤️ por Isaac Quarenta**