Skip to content

ADMIN_COMANDOS.md

Latest commit

 

History

History
386 lines (261 loc) · 6.56 KB

ADMIN_COMANDOS.md

File metadata and controls

386 lines (261 loc) · 6.56 KB
Raw

👮 Guia de Comandos de Administrador - Rudo Bot

📋 Visão Geral

Os comandos de administrador permitem gerenciar o grupo, inclusive:

  • Banir/expulsar usuários
  • Fechar/abrir o grupo
  • Promover/rebaixar admins
  • Silenciar usuários
  • Ver informações do grupo

🔑 Como Funciona

1. Permissões de Admin

Para usar comandos de admin, você deve estar configurado como admin no arquivo src/utils/permissions.js:

const ADMIN_IDS = [
    'seu_numero_aqui@s.whatsapp.net',
    '5599999999@s.whatsapp.net'
];

2. Obter Seu ID WhatsApp

Para descobrir seu ID:

  1. Envie uma mensagem no grupo
  2. Veja os logs: cat logs/$(date +%Y-%m-%d).log
  3. Procure por "Comando recebido" com seu número
  4. O sender é seu ID

Formato: 5511999999999@s.whatsapp.net

📚 Comandos Disponíveis

🚫 !ban - Banir Usuário

Remove permanentemente um usuário do grupo.

Uso:

Cite a mensagem do usuário
!ban

OU

!ban [número_do_usuário]

Exemplo:

[Cite mensagem do João]
!ban

Resultado:

✅ João foi banido do grupo

⚠️ Nota: O usuário não pode retornar sem ser adicionado manualmente.

👋 !kick - Expulsar Usuário

Remove um usuário do grupo, mas ele pode retornar.

Uso:

Cite a mensagem do usuário
!kick

OU

!kick [número_do_usuário]

Diferença:

  • !ban: Permanente (bloqueado)
  • !kick: Temporário (pode retornar)

🔒 !fechargrupo / !fechar - Fechar Grupo

Permite que apenas admins enviem mensagens no grupo.

Uso:

!fechargrupo

Resultado:

🔒 Grupo fechado! Apenas admins podem escrever agora.

O que muda:

  • ✅ Admins podem enviar mensagens
  • ❌ Membros comuns não podem enviar
  • ❌ Membros não podem mais editar grupo

🔓 !abrirgrupo / !abrir - Abrir Grupo

Permite que todos os membros enviem mensagens.

Uso:

!abrirgrupo

Resultado:

🔓 Grupo aberto! Todos podem escrever agora.

🔇 !mute - Silenciar Usuário

Remove os direitos de admin do usuário por 24 horas.

Uso:

Cite a mensagem do usuário
!mute

OU

!mute [número_do_usuário]

Resultado:

🔇 Usuário silenciado! Voltará como membro comum.

⭐ !promover / !promote - Promover a Admin

Transforma um membro comum em admin do grupo.

Uso:

Cite a mensagem do usuário
!promover

OU

!promover [número_do_usuário]

Resultado:

⭐ Usuário promovido a admin!

O que muda:

  • ✅ Pode remover mensagens
  • ✅ Pode remover membros
  • ✅ Pode alterar descrição
  • ✅ Pode alterar foto

📉 !rebaixar / !demote - Rebaixar Admin

Remove privilégios de admin de um administrador.

Uso:

Cite a mensagem do admin
!rebaixar

OU

!rebaixar [número_do_usuário]

Resultado:

📉 Admin rebaixado a membro comum!

📊 !groupinfo / !infogrupo - Info do Grupo

Mostra informações detalhadas do grupo.

Uso:

!groupinfo

Resultado:

📊 INFORMAÇÕES DO GRUPO

👥 Nome: Constelação Anime
📍 ID: 120363017411-1234567890@g.us
👤 Criador: 5599999999@s.whatsapp.net
📅 Criado em: 21/01/2026

📈 Estatísticas:
👨‍👩‍👧‍👦 Membros: 45
🔒 Status: Aberto

👮 Admins:
  • 5599999999@s.whatsapp.net
  • 5588888888@s.whatsapp.net

⚙️ Configuração

Adicionar Admin

Edite src/utils/permissions.js:

const ADMIN_IDS = [
    '5511987654321@s.whatsapp.net',  // Seu ID
    '5511999999999@s.whatsapp.net'   // Outro admin
];

Bloquear Usuário

Você pode bloquear usuários globalmente para não usar o bot:

// Em src/utils/permissions.js
const BLOCKED_USERS = ['5511999999999@s.whatsapp.net'];

Ou use a função:

permissions.blockUser('5511999999999@s.whatsapp.net');

📝 Exemplos Prático

Exemplo 1: Gerenciar Spam no Grupo

[Usuário X enviando spam]

→ Cite a mensagem
→ !fechargrupo

🔒 Grupo fechado! Apenas admins podem escrever.

[Depois de resolver]
→ !abrirgrupo

🔓 Grupo aberto! Todos podem escrever.

Exemplo 2: Promoção de Moderador

[Um membro se porta bem e merece ser moderador]

→ Cite a mensagem do membro
→ !promover

⭐ Usuário promovido a admin!

[Agora pode ajudar a gerenciar o grupo]

Exemplo 3: Banimento de Usuário Problemático

[Um usuário está violando as regras]

→ Cite a mensagem do usuário
→ !ban

🚫 Usuário banido do grupo!

[Não pode mais acessar o grupo]

🔍 Verificação de Permissões

Como verificar se você é admin:

cat logs/$(date +%Y-%m-%d).log | grep "Tentativa não autorizada"

Se vir mensagens de "Tentativa não autorizada", você não está configurado como admin.

⚠️ Cuidados Importantes

  1. Banco de Dados: Certifique-se de adicionar seu ID no arquivo antes de usar
  2. Grupo: Comandos de admin só funcionam em grupos
  3. Permissões do Bot: O bot precisa ser admin para executar ações
  4. Logs: Todas as ações são registradas em logs/

🐛 Troubleshooting

"Apenas admins podem usar este comando!"

Solução:

  1. Adicione seu ID em src/utils/permissions.js
  2. Procure por seu ID em logs/
  3. Reinicie o bot

"Este comando só funciona em grupos!"

Solução:

  • Use apenas em grupos, não em chats diretos

"Erro ao banir/expulsar usuário"

Solução:

  1. Verifique se o bot é admin no grupo
  2. Verifique se o usuário está no grupo
  3. Tente novamente

Usuário não sai do grupo

Solução:

  • Certifique-se de citar a mensagem corretamente
  • Ou use: !ban 5599999999

📊 Visibilidade de Logs

Todas as ações de admin são logadas:

# Ver todas as ações de admin
grep "banido\|expulso\|promovido\|rebaixado" logs/*.log

# Ver tentativas não autorizadas
grep "Tentativa não autorizada" logs/*.log

🎯 Resumo dos Comandos

Comando Função Uso
!ban Banir usuário !ban ou cite
!kick Expulsar usuário !kick ou cite
!fechargrupo Fechar (só admins) !fechargrupo
!abrirgrupo Abrir (todos) !abrirgrupo
!mute Silenciar !mute ou cite
!promover Promover admin !promover ou cite
!rebaixar Rebaixar !rebaixar ou cite
!groupinfo Info grupo !groupinfo

🔐 Segurança

  • Apenas admins podem executar esses comandos
  • Todas as ações são registradas
  • O bot valida permissões automaticamente
  • IDs são salvos com segurança

Desenvolvido com ❤️ para a comunidade Constelação Anime 🌟