Pular para o conteúdo

Pesquise guias, comandos, ferramentas MCP e arquitetura

Hikari WhatsApp

Configuração e governança no WhatsApp

A HikariZap centraliza toda configuração em um único arquivo .env na raiz (sem arquivos JSON secundários para segredos) validado antes mesmo de conectar o socket Baileys.

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 iniciar qualquer requisição externa ou abrir a sessão do WhatsApp, o validador verifica:

  • WHATSAPP_OWNER_NUMBERS: exige de 8 a 15 dígitos com DDI e DDD; recusa placeholders genéricos como 5500000000000 na autorização de proprietário.
  • Faixas numéricas: garante WHATSAPP_MAX_MEDIA_MB entre 1 e 64 MB, VOICE_SPEED (0.5–2.0), VOICE_TEMPERATURE (0–2.0), VOICE_MAX_CHARS (1–5.000), retenção de logs (1–90 dias) e tamanho de rotação (1–50 MB).
  • Executáveis: verifica ffmpeg e yt-dlp sem derrubar recursos principais se opcionais estiverem ausentes; em erros críticos de configuração, interrompe o boot apontando a variável incorreta sem vazar valores secretos.

Em WHATSAPP_OWNER_NUMBERS, informe um ou mais telefones completos separados por vírgula:

WHATSAPP_OWNER_NUMBERS=5511999999999,5521988888888

Como o WhatsApp usa identificadores de telefone (PN, @s.whatsapp.net) e identificadores opacos de aparelho vinculado (LID, @lid), a associação em src/data/zap/identities.json só aceita eventos autênticos do socket. Um LID sem vínculo comprovado ao número autorizado nunca executa >pausar, >retomar ou >fila.

  • Aceita múltiplas chaves separadas por vírgula em GEMINI_API_KEY.
  • Segue a cadeia configurável sem repetir modelos duplicados: servidor local (LOCAL_LLM_ENABLED=true) → GEMINI_MODEL (gemini-3.1-flash-lite) → GEMINI_MODEL_FALLBACK → GEMINI_MODEL_FALLBACK_2 → GEMINI_MODEL_FALLBACK_3 → Hugging Face (HF_MODEL) → Pollinations (quando autorizado).
  • O comportamento em ProviderPool e ai-health.json é detalhado em Pool de IA, fila e segurança.

Provedores de câmbio e estrutura de configuração

Seção intitulada “Provedores de câmbio e estrutura de configuração”
  • Câmbio (>moeda): escolhe entre awesomeapi (padrão, com suporte opcional a AWESOMEAPI_KEY) e frankfurter (Banco Central Europeu), consultando sempre em tempo real e exibindo fonte e horário na resposta.
  • Diagnóstico prévio: rode npm run config:check antes de iniciar o bot para validar todo o .env sem abrir conexão.