Pular para o conteúdo

Pesquise guias, comandos, ferramentas MCP e arquitetura

Hikari WhatsApp

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.

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.

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.

  • 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 caracteres e respostas longas são limitadas a 24.000 caracteres para respeitar o payload do Baileys.
  • Mídias respeitam WHATSAPP_MAX_MEDIA_MB (1 a 64 MB, padrão 16 MB).

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 em WHATSAPP_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é 5 vezes com esperas graduais de 10 a 120 segundos. O contador só zera após 2 minutos contí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 <-> LID em src/data/zap/identities.json somente ao receber eventos autênticos do socket.
  • Um LID desconhecido pode conversar normalmente, mas nunca recebe privilégios administrativos (isOwner) nem comandos do dono (>pausar, >retomar, >fila) até seu número estar comprovadamente vinculado a WHATSAPP_OWNER_NUMBERS, sem confiar em pushName.