Hikari no WhatsApp (HikariZap)
A edição WhatsApp (HikariZap) opera em processo independente utilizando @whiskeysockets/baileys (client.js, 6.7.24) por sessão Web pareada via QR Code no terminal.
Como falar com a Hikari no WhatsApp
Seção intitulada “Como falar com a Hikari no WhatsApp”O bot diferencia automaticamente mensagens privadas de conversas em grupo:
- Conversas privadas (DM): qualquer mensagem de texto, áudio PTT, imagem ou figurinha enviada direto para ela recebe resposta sem precisar de prefixo.
- Grupos: só responde quando acionada por:
- Menção direta (
@número) ou resposta (reply/quote) em uma mensagem dela. - Nome configurado em
BOT_NAME(padrão"Hikari"). - Prefixos
>ou/(ex.:>ajuda,/sticker) ou o atalho. <pergunta>para resposta em nota de voz. - Pedido explícito de figurinha acompanhando imagem, vídeo ou GIF.
- Menção direta (
Nos grupos, ela mantém uma memória deslizante das últimas 15 mensagens do chat (Store) em RAM sem acumular histórico longo em disco. Use >limpar ou >hdel quando quiser zerar esse contexto imediato.
Reações visuais e limites de mensagem
Seção intitulada “Reações visuais e limites de mensagem”- Enquanto executa qualquer uma das 12 ferramentas, aplica reação de emoji (
TOOL_REACTIONS) direto na sua mensagem e remove a reação assim que publica a resposta. - Entradas de texto têm teto de
8.000 caracterese respostas longas são limitadas a24.000 caracterespara respeitar o payload do Baileys. - Mídias respeitam
WHATSAPP_MAX_MEDIA_MB(1a64 MB, padrão16 MB).
Conexão Baileys, trava .lock e reconexão
Seção intitulada “Conexão Baileys, trava .lock e reconexão”O transporte em src/whatsapp/client.js protege a sessão contra quedas e processos duplicados:
- Pasta
.whatsapp-auth/e lockfile: as credenciais ficam salvas no diretório definido emWHATSAPP_AUTH_DIR, com uma trava de arquivo (.lock) que impede duas instâncias simultâneas corromperem a conta no WhatsApp. - Reconexão exponencial: em quedas temporárias de rede, tenta reconectar até
5vezes com esperas graduais de10a120 segundos. O contador só zera após2 minutoscontínuos de conexão estável. - Desconexão controlada: caso o aparelho desconecte a sessão ou haja conflito de dispositivo, o processo encerra com segurança em vez de forçar novo pareamento em loop.
Mapeamento PN <-> LID sem spoofing (identities.json)
Seção intitulada “Mapeamento PN <-> LID sem spoofing (identities.json)”O WhatsApp moderno alterna entre identificadores de telefone (PN, ex.: 5511999999999@s.whatsapp.net) e identificadores opacos de aparelho vinculado (LID, ex.: 123456789@lid):
- A HikariZap não varre agendas nem solicita listas de contatos: ela grava a associação
PN <-> LIDemsrc/data/zap/identities.jsonsomente ao receber eventos autênticos do socket. - Um
LIDdesconhecido pode conversar normalmente, mas nunca recebe privilégios administrativos (isOwner) nem comandos do dono (>pausar,>retomar,>fila) até seu número estar comprovadamente vinculado aWHATSAPP_OWNER_NUMBERS, sem confiar empushName.
Roteiros desta seção
Seção intitulada “Roteiros desta seção”- Comandos e atalhos (
>) com toda a tabela de comandos de conversa, mídia, jogos e administração. - Figurinhas e mídias para
512×512transparente, reversão>toimg, Deezer, torrents e câmbio. - Pool de IA, fila e segurança para
validate.js,ProviderPool,ai-health.json, anti-ban e sanitização de logs.
