Comandos

Os comandos são definidos em src/comandos/comandos.json. Podem ser enviados em qualquer chat (privado, grupo ou no chat consigo mesmo).

Sintaxe geral

/comando [-opção] [-opção valor] [argumentos]

• Opções usam um único hífen e aceitam o nome longo ou o curto: -audio = -a, -startSec 10 = -ss 10.
• Todo comando aceita -help / -h: /get -h mostra a ajuda só dele.
• /help lista os comandos que você pode usar (o dono e os admins veem todos); /help get ou /help /get mostram um específico.
• Aliases funcionam igual ao comando original (/download = /get). O /alias salva atalhos com argumentos ou textos com vários {/comando}; /help alias lista os atalhos disponíveis para você.
• Basta digitar o começo do comando: /wat ou /watc viram /watch. Se o começo servir para mais de um (/wa), o bot responde com os possíveis comandos (/walissu, /watch). O nome exato e os atalhos do /alias têm prioridade.

Destinos: contato, grupo, número ou e-mail

Os comandos com envio a destinos usam -to: o /cron, os alertas do /cotacao e do /crypto, o /defi -alerta, o /watch e o /backup -send. O /bot -status também aceita -to. Esses comandos aceitam vários -to: o aviso (ou a mensagem, ou o arquivo) sai em cada destino. O alvo do /mute, as pessoas do /bot +o/+v e do /whois usam a mesma busca. Sem -to, os avisos (e o arquivo do /backup) vão para o seu privado, e o /cron, para o chat atual.

Forma	Exemplo	Encontra
Nome	/Jorge Pereira/, "Jorge Pereira" ou Jorge	Busca contatos e grupos; nomes exatos têm prioridade, e contatos ganham em caso de empate. O seu próprio nome (o salvo na agenda ou o do seu perfil) é o seu privado
Grupo	/Grupo L200/, "Grupo L200" ou L200	O grupo, com prioridade para o nome exato
Menção	@Fulano (escolhido na lista do @ do WhatsApp)	A pessoa mencionada. Útil num grupo, para quem não está na sua agenda. Um @número digitado, sem ser menção, é recusado
Número	+5521999999999	O privado do número: DDI + DDD + número (o + é opcional; o bot confere se ele está no WhatsApp)
E-mail	email, voce@exemplo.com ou "a@x.com, b@y.com"	Nos alertas (/cotacao, /crypto e /defi), no /watch, no /bot -status e no /backup -send: email é o QRCODE_EMAIL_SMTP_TO; sai pelo SMTP do bot, sem a formatação do WhatsApp (E-mails)

O /debug usa -copy-to para copiar logs a um chat, sem aceitar e-mail. O /watch -in seleciona a origem das mensagens: contato, grupo ou canal @newsletter.

As mesmas formas, num comando só:

/cron 8h -r diario -to /Jorge Pereira/ -to @Fulano Da Silva -to /Grupo L200/ -to +5521999999999 Bom dia!
/cotacao -alerta USD > 5.30 -to email           → por e-mail (o QRCODE_EMAIL_SMTP_TO)
/crypto -alerta BTC < 90000 -to /Grupo L200/ -to email  → no grupo e por e-mail
/mute @Fulano Da Silva                          → o alvo do /mute, mencionando
/bot +o /Jorge Pereira/ +5511988887777         → o /bot +o (e o +v) aceita várias pessoas de uma vez

• Menção: num grupo, digite @ e escolha a pessoa na lista do WhatsApp. No texto da mensagem ela vira um id (@100000000000002), e o bot pega a pessoa pelo id que o WhatsApp manda junto. Serve para quem está no grupo mas não na sua agenda. Um @número digitado à mão, sem escolher na lista, é recusado: para um número, use o +5521999999999.
• O /cron e o /mute não aceitam e-mail: a mensagem do /cron sai no WhatsApp, e o /mute silencia uma pessoa ou um grupo. Os admins (/bot +o) e o /whois aceitam só pessoas (contato, menção ou número); os usuários (/bot +v), pessoas e grupos.
• O nome casa quando tem todas as palavras, em qualquer ordem, sem diferenciar maiúsculas nem acentos. No -to, nomes com espaço vão entre /.../ ou aspas (sem eles, só a primeira palavra conta); no /mute, o alvo é o resto do texto, com ou sem /.../.
• O nome inteiro igual ganha de um que só contém as palavras (e um contato ganha de um grupo).
• Se mais de um servir, o bot lista e espera você responder só com o nº, no mesmo chat, em até 2 minutos:

/mute /Jorge/
🔎 "Jorge" corresponde a 2 contatos:

1. 👤 Jorge Pereira · +5521999999999
2. 👤 Jorge Silva · +5511988888888

💡 Responda só com o nº (em até 2 minutos), ou repita o comando com mais palavras do nome.

1
🔇 Silenciado: 👤 Jorge Pereira — apagadas, editadas, status

Sem resposta em 2 minutos, nada é feito, e a própria lista vira o aviso (sem outra mensagem): ⌛ Nenhum nº escolhido para "Jorge" em 2 minutos: nada foi feito.

Permissões (onlyAdmin)

Comandos marcados como admin só executam quando enviados pela própria conta do bot (você, de qualquer aparelho) ou por um admin extra: as pessoas que você puser no setting bot.admins (/bot +o /Jorge Pereira/, @Fulano Da Silva ou +5521999999999; veja Admins extras). Se outra pessoa tentar, nada acontece no chat; com o debug ligado, você recebe um aviso no PHONE_NUMBER:

⚠️ Fulano tentou executar /show dentro de Família, mas sem permissão

Os comandos que não são admin (/get, /tempo, /sticker...) são de quem estiver no setting bot.users, que vem false: só você (e os admins extras) usa comandos. Com /bot +v /Maria Lucia/ /Grupo Familia/, essas pessoas (em qualquer chat) e esses grupos (qualquer um, dentro do grupo) também usam; o /bot +v de uma pessoa digitado num grupo vale só nesse grupo; com /set bot.users true, todos. O /bot +cmd/ -cmd limita os comandos de cada usuário. Veja Usuários. Para saber o seu nível (ou, sendo dono ou admin, o de alguém), use o /whois. Quem não é admin tem uma proteção contra flood: o mesmo comando, no máximo 3 vezes em 2 segundos.

As respostas do próprio bot também saem pela sua conta, mas nunca são tratadas como comando, mesmo que comecem com /. Sem isso, alguém poderia usar um comando que ecoa texto (ex.: /noffa /cache -a) para fazer o bot "digitar" um comando de admin.

Resumo

Comando	Aliases	Admin	Descrição
/alias		✅	Cadastra, lista e remove atalhos para comandos com argumentos ou textos com vários {/comando}
/backup	/bkp	✅	Backup diário local e envio por backup.to; lista, detalha, restaura e envia o banco
/block	/bloquear	✅	Bloqueia uma ou várias pessoas na sua conta do WhatsApp (respondendo uma mensagem, quem a escreveu); sem nada, lista os bloqueados; -mask ofusca telefones
/boletos			Sorteia 2 membros para "pagar um boleto"
/bot		✅	Status do bot (relatório de 24 h e os usuários); liga/desliga os comandos (-on/-off) e diz quem usa: admins (+o/-o) e usuários (+v/-v, em qualquer chat ou só num grupo, e os comandos de cada um com +cmd/-cmd); -reset volta ao padrão; -status (-s): relatório das últimas 24 h, e -s 06h manda todo dia; -info (-i): versões e sistema
/cache		✅	Árvore do cache com tamanhos, contagens de mensagens e limpeza
/cotacao	/cambio		Cotação de EUR e USDT (e USD, GBP) contra o real: atual, abertura, fechamento e variação; alertas de preço
/cron	/agenda, /lembrete	✅	Na hora marcada (30m, às 18h, sexta 9h...): envia uma mensagem (aqui ou com -to, em um ou vários chats) ou, como /lembrete, um ⏰ lembrete; pode repetir, editar e pausar, e rodar comandos no texto ({/crypto})
/crypto	/bitcoio, /creptomoeda		Cotação das criptos ativadas (padrão: BTC, ETH, SOL e HYPE) ou só das pedidas (BTC ETH); alertas de preço
/cve			Últimas CVEs publicadas (NVD); -highscore só as críticas
/debug	/d, /dbg	✅	Logs de debug com níveis, filtro e cópia para chats
/defi		✅	Posições de liquidez da Orca e do Project X: saldo, faixa, preço e taxas a coletar, lidos on-chain; -alerta avisa quando sai e volta para a faixa e quando as taxas passam de um valor. liquidswap: posições de LP na Aptos. morpho e aave: posição, empréstimos e risco no Morpho e no Aave V3
/enquete	/quiz	✅	Cria uma enquete nativa do WhatsApp no chat; -r mostra o resultado
/get	/download		Baixa vídeo/áudio de redes sociais ou da mídia respondida
/giphy	/gif		GIF do GIPHY por tag, URL ou ID, enviado em loop
/gpt	/ai	✅	Pergunta ao ChatGPT (OpenAI)
/help	/h		Menu de ajuda, só com os comandos que quem pediu pode usar
/joke	/piada, /humor		Piada aleatória em português
/kernel			Versões atuais do kernel Linux (kernel.org)
/listageral	/list	✅	Lista os membros do grupo
/meme			Template de meme aleatório (imgflip)
/monitor		✅	👀 Até 5 contatos, histórico limitado, filtro por contato e alertas de entrada online
/mute	/mudo	✅	Silencia os avisos de apagadas, editadas, status e reações (e os do /watch) de uma pessoa, um grupo ou uma comunidade; respondendo um aviso, de onde ele veio
/news			Manchetes de feeds RSS: -hack, -g1, -gazeta, -brasil
/noffa	/🌈, /🏳️‍🌈		Enfeita o texto com arco-íris
/ping			Verifica se o bot está vivo
/pixelart	/ansi, /px		Arte ANSI/ASCII aleatória (16colo.rs)
/search	/buscar	✅	Busca no histórico do WhatsApp Web, não só no cache: neste chat ou, no seu privado, em todos (-N para mais); -mask ofusca telefones
/set	/config	✅	Lista e altera as configurações (settings); -a/-rem acrescentam e tiram itens das listas (ex.: o bot.admins e o bot.users)
/show		✅	No privado, lista o cache; reexibe apagadas, edições (-e), status (-s) e reações removidas ou trocadas (-r); -q busca (texto ou regex) e -mask ofusca telefones
/stats		✅	Ranking deste chat ou de outro (/Grupo/): quem mais fala, apaga e edita, horários de pico; -me para as suas, -l lista os chats, -flush apaga
/sticker			Figurinha de imagem, vídeo ou link (o /get -st); com -txt, uma figurinha animada de texto
/tempo	/weather		Tempo agora e máx./mín. do dia (Open-Meteo); /tempo 16d mostra até 16 dias, contando hoje; sem cidade usa tempo.city
/tldr	/resumo	✅	Resume a conversa do chat pelo ChatGPT (2h, 300...)
/todos	/todes	✅	Menciona todos do grupo
/traduzir	/translate		Traduz o texto ou a mensagem respondida (Google Translate); -para en muda o idioma
/unblock		✅	Desbloqueia uma pessoa: pelo nome, pelo número, pelo nº da lista do /block ou respondendo uma mensagem
/unmute		✅	Desfaz o silêncio do /mute: pelo nome, pelo nº da lista, respondendo um aviso ou todos (-all)
/uptime			Tempo de execução e de conexão
/version			Versão do bot (mesmo banner do /uptime)
/walissu	/ualisu	✅	Walissu CVE BOT: marca 2 membros com uma CVE aleatória
/watch		✅	Regras de texto/regex, com origem opcional em -in; lista ocorrências, busca nelas com -q e avisa nos destinos de -to; -mask ofusca telefones
/whois	/who, /id		Quem é e o que pode no bot, neste chat: 🤖 dono, 👑 admin, 🗣️ usuário ou 🚫 sem permissão; o dono e os admins veem os outros