| # 🤖 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 <número> | |
| **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 <nome ou link> | |
| **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 <idioma> <texto> | |
| **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** | |