📄 Documento de Execução — Card 40: [M6.5] Fluxo n8n: Atendimento IA (coleta + FAQ)

🎯 1. O que foi implementado

Workflow n8n "GENIOON — Atendimento IA" (15 nós, webhook POST /webhook/wa-inbound):

WA Inbound → Parse & Memory → Gravar GENIOON → KB → Build Prompt → Gemini Body
→ Gemini (HTTP, tools function calling) → Decide → [tool? → Call Automation]
→ Final Text → SendText WAHA → Log Outbound

• Memória por chatId via getWorkflowStaticData (histórico 20 msgs + enrollmentId/paymentId/leadId da conversa)
• System prompt montado a cada mensagem com FAQ real (BotFaq) + turmas com vagas (IDs) + cursos — nunca stale
• Gemini via HTTP Request (sem credentials do n8n): generativelanguage.googleapis.com com function_declarations das 6 tools; key via $env.GEMINI_API_KEY
• Fallback: sem key/erro → heurística mock (mesma do bot interno) — fluxo nunca morre
• Gravar GENIOON: repassa o payload WAHA pro nosso webhook (com secret) — histórico/painel preservado; bot interno dormente (N8N_WEBHOOK_URL)
• SendText via WAHA API (X-Api-Key) + gravação outbound no GENIOON (log-outbound)
• WAHA reconfigurado: WHATSAPP_HOOK_URL → https://n8n.wellka.com.br/webhook/wa-inbound (compose)
• Workflows versionados no repo (scripts/n8n-workflows/*.json + gerador python)

✅ Critérios de aceite validados

⚠️ Pendência externa

• GEMINI_API_KEY (Wellington — Google AI Studio) p/ respostas reais da IA
• QR do WhatsApp (escanear 1x no WAHA dashboard: ssh -L 3100:localhost:3100 oracle-free → http://localhost:3100 — sessão anik) p/ mensagens reais