Pular para o conteúdo

Do e-mail copiado à mão ao funil num sistema só: cinco decisões e o que cada uma custou

Uma empresa de comércio exterior, que conduz processos de mudança para os clientes, recebia os pedidos de orçamento por e-mail, enviados por três plataformas de geração de leads. Alguém lia cada mensagem e copiava os dados à mão. Este texto conta cinco decisões que tomei ao construir o sistema que substituiu esse trabalho, e o que cada uma deixou pior.

7 min de leitura

Uma empresa de comércio exterior, que conduz processos de mudança para os clientes, recebia os pedidos de orçamento por e-mail, enviados por três plataformas de geração de leads. Alguém lia cada mensagem e copiava os dados à mão. Este texto conta cinco decisões que tomei ao construir o sistema que substituiu esse trabalho, e o que cada uma deixou pior.

O problema

Primeiro, propostas, cotações e negócios eram controlados em planilha. Depois, a equipe tentou replicar esse controle num CRM de mercado que não servia ao processo dela. Em nenhum dos dois o cadastro do cliente se separava da oportunidade de venda: não havia como ver, a partir de um cliente, todos os processos de mudança que ele já tinha feito.

Segundo a equipe do cliente, fechar um contrato passava por 5 a 6 etapas, e o assunto de cada etapa precisava ser reunido à mão, a partir dos e-mails recebidos. Organizar isso antes de responder um cliente era a parte mais lenta do trabalho, e nunca foi medida.

O contexto

  • De 4 a 6 pessoas usam o sistema.
  • Cerca de 50 leads por dia útil chegam por e-mail, e esse volume já existia antes do sistema (ADR-018).
  • Nenhuma das três plataformas de leads oferecia integração direta (webhook).
  • A infraestrutura é um servidor e um pipeline de deploy; o custo de operação é o limite real do desenho.
  • O escopo foi construído por fases, uma área por vez.
  • A equipe de desenvolvimento é uma pessoa, eu, desde o início, com IA (Claude, da Anthropic) como apoio, dentro de uma governança que cobra por regra, revisão e teste o que a IA produz.

Decisão 1: captura pela caixa de e-mail, e não por integração

Sem webhook disponível (o aviso automático que uma plataforma manda para outro sistema), o sistema lê a caixa de e-mail por IMAP, o protocolo de leitura de e-mail, a cada dois minutos e transforma cada mensagem em lead. Descartei mexer no MX do domínio para receber os e-mails direto: risco desproporcional para resolver captura.

O que piorou: latência de minutos por construção, e uma credencial de e-mail que a aplicação precisa guardar, cifrar e rotacionar.

Decisão completa: ADR-018, IMAP com polling em vez de webhook

Decisão 2: expressão regular por plataforma, e não modelo de linguagem

Cada plataforma tem as suas regras de reconhecimento e extração, cadastradas na tela. Descartei o modelo de linguagem por determinismo, e não por custo: o mesmo e-mail precisa produzir sempre o mesmo cliente. Plataforma nova entra sem deploy.

O que piorou: quando o formato do e-mail muda, a captura quebra em silêncio, e não há alarme para isso. As regras viraram configuração de produção: um ajuste malfeito na tela derruba a captura sem revisão de código.

Decisão completa: ADR-019, parser por plataforma com expressão regular

Decisão 3: deduplicação por chave exata, e nunca por semelhança de nome

O mesmo contato chega mais de uma vez: a pessoa pede orçamento em duas plataformas, ou a mesma plataforma reenvia. Recusei comparar nomes parecidos, porque o erro dessa comparação é fundir dois clientes diferentes. O sistema usa três chaves exatas, e o e-mail repetido é vinculado ao cliente que já existe, em vez de ser descartado.

O que piorou: o mesmo contato com dois endereços de e-mail vira dois clientes, e nada acusa.

Decisão completa: ADR-020, deduplicação em três níveis

Decisão 4: monólito modular, e não microsserviços

Pessoas de funções diferentes (direção, gerência, supervisão e comercial) usam partes diferentes do sistema, e uma regra de uma área não pode corromper a outra. Por isso o sistema nasceu, em janeiro de 2026, separado por área do negócio, cada uma em projetos próprios: administrativo, notificação e financeiro. A parte comercial começou dentro do administrativo e virou área própria em abril; integração (março) e backup (abril) vieram depois. Em agosto de 2026, com o sistema em produção havia meses, a decisão foi manter tudo num processo só e passar a cobrar a fronteira por teste.

Microsserviços resolveriam a fronteira cobrando rede, mensageria e observabilidade distribuída de um produto que roda inteiro num servidor. As referências de projeto entre áreas, contadas em setembro de 2026, saíram de 18 para zero, sem nenhum processo novo, e um teste impede que voltem.

O que piorou: mais cerimônia (quatro projetos por área) e uma fronteira que só um teste protege, não o compilador. E criei quatro módulos reservados para as fases seguintes sem data marcada: dezesseis projetos vazios que custam manutenção todo mês para quem ainda não sabe quando vai usá-los.

A ADR-001, sobre o monólito modular por bounded context, entra no blog na ordem da trilha.

Decisão 5: um painel só para log, métrica e trace

Investigar um erro exigia trocar de ferramenta três vezes e cruzar os dados à mão, e dois serviços de monitoramento estavam publicados na internet sem autenticação. Hoje o Grafana é a única tela publicada, com Loki, Tempo e Prometheus por trás, sem acesso pela internet.

O que piorou: consultas salvas das ferramentas antigas se perderam, e abrir a tela nativa de um desses serviços passou a exigir túnel, o que atrapalha na investigação urgente.

Decisão completa: ADR-044, um painel único de observabilidade

O resultado

  • Medido: 5.305 leads capturados sem digitação de 13/04/2026, quando a captura entrou no ar, até setembro de 2026 (ADR-018).
  • Relatado pela equipe do cliente, sem medida de tempo: a partir do cadastro do cliente, aparecem todos os processos de mudança que ele já fez; o contrato e os documentos abrem com um clique; a proposta e o fechamento acontecem no sistema, sem revisar vários e-mails; outra pessoa da equipe consegue retomar um atendimento sem perguntar onde está cada coisa.

O que piorou para o cliente

O sistema exige uma pessoa dedicada a acompanhá-lo. Hoje isso não é problema, mas, sem ela, os dados deixariam de ser corretos e únicos. E o sistema ficou grande: o código está separado por área, mas as regras do negócio atravessam as áreas (a proposta depende do cadastro, o contrato depende da proposta), e cada alteração pede atenção a essa cadeia, o que encarece a manutenção.

O que eu faria diferente

  • Começaria pela governança de IA e pelas especificações logo depois do levantamento com o cliente, antes do primeiro código. A governança completa nasceu durante este sistema, e não antes dele.
  • Teria avaliado o IMAP IDLE, que avisa da mensagem nova quase na hora, sem mexer no MX. Ele não entrou na comparação por descuido, e não por critério (ADR-018).
  • Teria criado desde o início o alerta para quando a proporção de e-mails ignorados sair do normal, que é o que avisaria de uma captura quebrada (ADR-019).

O que isso significa para o negócio

Os leads que chegavam por e-mail deixaram de depender de alguém copiando à mão, sem custo recorrente de integração. O preço é ter uma pessoa cuidando dos dados e alguns minutos de espera por lead, porque a caixa é lida a cada 2 minutos (ADR-018).

Se você recebe dados de quem não oferece integração, a pergunta que vale levar é a da deduplicação: o que custa mais no seu caso, a duplicata que passa ou os dois clientes fundidos por engano?

Ler o case completo no site: Sistema de gestão para comércio exterior

Receba o resumo da semana

Um e-mail por semana com o que foi publicado. Sem spam, e você sai quando quiser.

Continue lendo

Receba o resumo da semana

Um e-mail por semana com o que foi publicado. Sem spam, e você sai quando quiser.

Blog do Felipe Marciano

Decisões de arquitetura, .NET e sistemas distribuídos, escritas por quem vive com as consequências delas.

© 2026 Felipe Marciano. Todos os direitos reservados. · v1.54.0