🤖 AKIRA BOT V21.02.2025 - GUIA COMPLETO DE COMANDOS
📋 Índice
- Comandos Públicos
- Comandos de Perfil
- Comandos de Moderação
- Comandos de Mídia
- Sistema de Permissões
- Sistema de Rate Limiting
- 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
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êsen= Englishes= Españolfr= Françaisde= Deutschja= 日本語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 adicionadoREMOVE_MEMBERS- Membros removidosPROMOTE_MEMBERS- Membros promovidosDEMOTE_MEMBERS- Membros rebaixadosMUTE_USER- Usuário mutadoUNMUTE_USER- Mutação removidaWARN_USER- Aviso registradoLEVEL_ON- Sistema de níveis ativadoLEVEL_OFF- Sistema de níveis desativadoANTILINK_ON- Anti-link ativadoANTILINK_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
- Mensagem com link é deletada automaticamente
- Usuário é removido do grupo
- Ação é registrada em log
- 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
- Converse naturalmente com o bot
- Responda áudios do bot
- Envie áudios para bot transcrever
- Participe ativamente do grupo
Para Usar Comandos de Moderação
- Certifique-se que o bot é admin
- Use @mentions ou reply
- Verifique as permissões
- Consulte o log de ações
Para Criar Stickers Criativos
- Use imagens em alta qualidade
- Fundo transparente (PNG) é ideal
- Tamanho: 512x512 ou similar
- 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