Voltar aos projetos

Consultora Pro

Em produção

Assistente corporativa via WhatsApp

Categoria: Automação & IAFunção: Desenvolvedor Full Stack & Especialista em Automação

Sobre o Projeto

Assistente virtual inteligente integrada ao WhatsApp para gestão empresarial (agendamentos, financeiro e CRM). O projeto evoluiu de uma arquitetura baseada em classificação de intenção e fluxos lineares (V1) para uma arquitetura avançada de Agentes de IA autônomos com uso de Tools dinâmicas (V2), reduzindo a complexidade de manutenção e aumentando a fluidez conversacional.

Stack Técnico & Infraestrutura

Orquestração

  • n8n (Self-hosted com Docker & Portainer em VPS)

Mensageria

  • WhatsApp via Evolution API

Banco de Dados

  • PostgreSQL (Dados de negócio)
  • Redis (Cache, Buffer e Memória conversacional)

IA & LLMs

  • OpenAI (GPT-4o mini, GPT-4o, Claude 3.5 Sonnet)
  • Mistral/Ministral (OCR de Imagens e PDFs)
  • LangChain integrado ao n8n

Linguagens de Apoio

  • JavaScript/Java para tratamento de dados

Tecnologias Utilizadas

n8nPostgreSQLRedisLangChainOpenAIEvolution APIMistral

Arquitetura Técnica

  • V1: Classificação de Intenção com fluxos lineares e nós Switch hardcoded
  • V2: Agente Orquestrador Autônomo com memória persistente das últimas 10-15 mensagens
  • Tools Dinâmicas: verificar_disponibilidade(), criar_agendamento(), registrar_despesa()
  • Validação humana antes de commits no banco (Salvar, Editar ou Deletar)

Funcionalidades Principais

Processamento multimodal (texto, áudio transcrito via Whisper, imagem e PDF via OCR)
Gestão financeira e CRM com categorização automática via IA
Agendamentos inteligentes com verificação de conflito de horários
Agente Supervisor com memória persistente (LangChain + Redis)
Sistema de Guardrails anti-alucinação pós-processamento

Desafios & Soluções

Problema

Usuário envia mensagens fragmentadas (Oi... Quero agendar... Amanhã)

Solução

Implementei Buffer de mensagens no Redis com delay de 10 segundos que agrupa todas as mensagens em um único contexto antes de acionar a IA.

Resultado

Economia de tokens e melhor interpretação do contexto.

Problema

Variações de números de telefone do WhatsApp (com/sem 9º dígito, código do país)

Solução

Criei algoritmo em JavaScript para normalizar as variações e garantir integridade da consulta no banco.

Problema

Loops de erro na execução de ferramentas da IA

Solução

O agente monitora suas próprias falhas. Após duas tentativas falhas, degrada graciosamente para atendimento humano.

Destaques Técnicos

Arquitetura Multi-Agente com Tools dinâmicas
Human-in-the-loop com transbordo inteligente para suporte humano
Buffer de mensagens no Redis para economia de tokens

Impacto no Negócio

A V2 reduziu drasticamente a complexidade de manutenção e aumentou a fluidez conversacional, permitindo que empresas gerenciem agendamentos, financeiro e CRM de forma autônoma via WhatsApp.

Precisa de uma solução similar?

Vamos conversar sobre como posso ajudar seu negócio com automação, integrações e sistemas personalizados.

Conversar no WhatsApp