Pular para o conteúdo

Pesquise guias, comandos, ferramentas MCP e arquitetura

Hikari WhatsApp

Pool de IA, fila e segurança

Para operar com estabilidade em servidores enxutos usando múltiplas chaves gratuitas sem derrubar outros chats nem expor a conta do WhatsApp a bloqueios, a HikariZap separa validação inicial, balanceamento de modelos, enfileiramento e sanitização em quatro camadas.

Validação estrita na inicialização (src/config/validate.js)

Seção intitulada “Validação estrita na inicialização (src/config/validate.js)”

Antes de abrir o socket do Baileys ou aceitar mensagens, a inicialização confere os formatos do .env:

  • Rejeita telefones inválidos em WHATSAPP_OWNER_NUMBERS (exige de 8 a 15 dígitos com DDI/DDD e recusa placeholders genéricos como 5500000000000).
  • Garante faixas válidas para WHATSAPP_MAX_MEDIA_MB (1 a 64), parâmetros vocais (speed de 0.5 a 2.0, temperature de 0 a 2, caracteres de 1 a 5.000) e rotação de logs (1 a 90 dias e 1 a 50 MB).
  • Confere a presença de ffmpeg e yt-dlp sem derrubar funções principais caso um recurso opcional esteja ausente, interrompendo o processo apenas em erros críticos de configuração sem vazar valores secretos.

O ProviderPool intercala Groq, Gemini, HuggingFace, Pollinations (bloqueado sem chave salvo ALLOW_PUBLIC_POLLINATIONS=true) e LM Studio local respeitando AI_PROVIDER_ORDER:

  • Cascata sem repetição: quando usa Gemini, aceita múltiplas chaves separadas por vírgula (GEMINI_API_KEY=k1,k2) e segue a sequência configurável entre GEMINI_MODEL, GEMINI_MODEL_FALLBACK, GEMINI_MODEL_FALLBACK_2 e GEMINI_MODEL_FALLBACK_3 (pulando entradas duplicadas), caindo para HuggingFace (Qwen/Qwen2.5-72B-Instruct) e Pollinations se necessário.
  • Preferência recente e limites: prioriza por 1 minuto o último provedor vencedor, executa até 8 tentativas no total (máximo 2 por provedor), com timeout de 10s na tentativa inicial, 35s para conclusão e 90s de orçamento total de agente (com LLM_TIMEOUT_MS ajustável entre 5.000 e 120.000 ms, padrão 30.000 ms).
  • Rastreio em ai-health.json: erros 429 pausam apenas o candidato pelo tempo indicado em Retry-After; 5xx marcam instabilidade temporária; 401/402/403 sinalizam chave ou crédito; 404 isola o modelo ausente; 400 de suporte a ferramentas rebaixa apenas aquela chamada para modo texto mantendo o provedor disponível para conversa comum.

Fila serializada (Queue) e limitador anti-ban (createSendLimiter)

Seção intitulada “Fila serializada (Queue) e limitador anti-ban (createSendLimiter)”
  • Fila concorrente (src/whatsapp/queue.js): processa até 2 chats ao mesmo tempo, mantendo 1 tarefa ativa por chat, limite de 20 pendentes globais e 4 por chat, espera máxima de 60s e execução máxima de 180s, com aborto imediato pelo comando >cancelar (AbortController).
  • Cadência anti-ban: garante intervalo mínimo obrigatório de 2 segundos entre qualquer envio, teto de 20 mensagens por minuto global e máximo de 6 mensagens por minuto dentro do mesmo chat.
  • Sem gravação de chats comuns em log: o logger (src/utils/logger.js) não escreve conversas privadas ou áudios transcritos comuns nos arquivos de log em logs/, aplicando rotação automática (LOG_RETENTION_DAYS, LOG_MAX_FILE_MB).
  • Máscara automática [REDACTED]: antes de imprimir no console ou gravar em arquivo, tokens AIza..., hf_..., bearers, telefones e LIDs são substituídos por [REDACTED]. O QR Code aparece só no terminal interativo e nunca vai para arquivos ou rotas web.
  • Anti-SSRF (ipaddr.js) e dados externos: links informados por usuários passam por verificação de IP bloqueando endereços privados, loopback (127.0.0.1), link-local e faixas CGNAT, e conteúdos extraídos de sites ou imagens entram isolados como dados externos não confiáveis.
  • Cuidados operacionais: evite conectar um chip recém-criado antes de estabelecer histórico normal de uso manual e mantenha backup seguro de .whatsapp-auth/ caso migre de servidor.