Qualificação comercial com N8N, evidências e controle humano
Build publicado
v2026.11.06.021653
Visão geral
Esta publicação prepara um piloto comercial pós-ingestão no qual o Elo preserva a conversa como fonte da verdade, o N8N conduz a qualificação com evidências e a agenda Microsoft 365 oferece horários reais para reuniões confirmadas pelo lead.
Impacto para a operação
A equipe pode homologar a descoberta comercial em modo sombra, revisar cada decisão e promover o fluxo com limites de conversa, handoff humano e agendamento auditável — sem arriscar a perda de mensagens recebidas nem criar reuniões sem consentimento.
O que chegou
Novidades
Novas capacidades para qualificação comercial assistida e governada.
- Piloto de qualificação comercial via N8N após a mensagem já ter sido persistida na Inbox, mantendo o Elo como fonte da verdade do atendimento.
- Configuração por departamento com modos Desligado, Sombra e Ativo, webhook exclusivo e orientação comercial personalizada.
- Jornada estruturada de descoberta, qualificação, oferta de reunião, aceite com data e horário, entrega para humano, suporte a cliente atual, falta de aderência e descadastro.
- Sessões comerciais persistentes com estado, revisão, fatos, campos pendentes, evidências vinculadas às mensagens e histórico de decisões.
- Central de Conhecimento Comercial privada por empresa, com produtos, fatos verificáveis, revisão editorial e publicação controlada pela administração do próprio tenant.
- Agenda Microsoft 365 vinculada ao departamento, com oferta de horários livres e criação de reunião online somente após aceite explícito e e-mail confirmado pelo lead.
O que evoluiu
Melhorias
Evoluções para operar o piloto sem bloquear a entrada nem perder contexto.
- Outbox durável entrega ao N8N somente o evento pós-ingestão, com resposta assíncrona, repetição controlada e idempotência por mensagem.
- O N8N consulta o contexto canônico no Elo, usa até as mensagens recentes necessárias e devolve decisões tipadas com evidências verificáveis.
- A qualificação comercial recupera somente produtos publicados e vinculados ao departamento, preservando a identidade da empresa atendida e encaminhando lacunas para validação humana.
- O modo Sombra registra análises e consumo de IA sem enviar mensagens, alterar Leads ou criar follow-ups; uma execução iniciada em Sombra nunca muda para Ativo durante o processamento.
- A automação encerra o ciclo e entrega para uma pessoa ao atingir oito ações, 72 horas de sessão ou três turnos sem avanço na qualificação.
- A administração de IA passa a reconhecer a qualificação comercial via N8N como funcionalidade própria, com política, modelo, preço, reserva e liquidação de créditos.
O que corrigimos
Correções
Proteções aplicadas antes da ativação do piloto.
- Callbacks do workflow comercial ficam restritos ao domínio e às rotas oficiais do Elo, impedindo que credenciais protegidas sejam anexadas a destinos informados pelo payload.
- O webhook do piloto aceita somente HTTPS, domínio e caminho oficiais do N8N, reduzindo o risco de redirecionamento ou resolução para destinos não autorizados.
- A validação de prontidão distingue integrações N8N dos modelos chamados diretamente pelo Elo, evitando bloqueios incorretos sem liberar consumo fora da política salva.
Como protegemos a operação
Segurança e confiabilidade
Controles que preservam isolamento, auditoria e reversibilidade.
- Todos os estados, ações e consultas são validados novamente por empresa, instância, conversa, mensagem, revisão e hash da configuração antes de qualquer efeito.
- O conhecimento comercial é isolado por empresa e departamento; ausência de vínculo ou conteúdo publicado interrompe a resposta automática em vez de consultar o catálogo de outro tenant.
- Consumo de IA usa reserva atômica e liquidação do uso real antes da ação comercial; resultados incertos são encaminhados para revisão segura.
- Ações são idempotentes por empresa e mensagem, e a outbox usa lock Redis para evitar processamento concorrente em múltiplas instâncias.
- O aceite de reunião só cria o evento Microsoft depois de validar consentimento, e-mail, slot assinado, disponibilidade atual e idempotência; a confirmação ao cliente ocorre apenas após a conclusão real do agendamento.
- Ações interrompidas são recuperadas como incertas e encaminhadas para revisão humana sem repetir automaticamente o convite Microsoft ou a mensagem no WhatsApp.
Qualidade da entrega
Validação antes e depois da publicação
1.525
testes aprovados
1.525 testes da API cobrem configuração, decisões, consumo, idempotência, agenda Microsoft, conhecimento comercial por tenant, recuperação segura e modo Sombra.
2
typechecks aprovados
API e Web foram validados sem erros de TypeScript antes da publicação.
67
migrations verificadas
O histórico completo do schema, incluindo a integração Microsoft 365 e o conhecimento comercial por tenant, foi conferido no ambiente de produção.
0
envios automáticos no modo Sombra
A homologação registra decisões e consumo sem enviar mensagens ao cliente, alterar Leads ou criar follow-ups.
