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 de8a15dígitos com DDI e DDD; recusa placeholders genéricos como5500000000000na autorização de proprietário.- Faixas numéricas: garante
WHATSAPP_MAX_MEDIA_MBentre1e64 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
ffmpegeyt-dlpsem 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.
Governança Multi-Owner (PN / LID)
Seção intitulada “Governança Multi-Owner (PN / LID)”Em WHATSAPP_OWNER_NUMBERS, informe um ou mais telefones completos separados por vírgula:
WHATSAPP_OWNER_NUMBERS=5511999999999,5521988888888Como 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.
Cadeia de modelos e rotação de chaves
Seção intitulada “Cadeia de modelos e rotação de chaves”- 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
ProviderPooleai-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 entreawesomeapi(padrão, com suporte opcional aAWESOMEAPI_KEY) efrankfurter(Banco Central Europeu), consultando sempre em tempo real e exibindo fonte e horário na resposta. - Diagnóstico prévio: rode
npm run config:checkantes de iniciar o bot para validar todo o.envsem abrir conexão.
