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.
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
- Governança e monitoramento de eventos para evitar inconsistências em microsserviçosGerenciar eventos em microsserviços requer governança e monitoramento detalhados para evitar inconsistências como perda e duplicação. Compartilho práticas de auditoria automatizada, dashboards e alertas baseados em minha experiência com sistemas event-driven.
- Event-driven interno: desacoplamento por eventos locais em monólitos moduladosEste texto aprofunda um ponto do post sobre migração gradual de monólitos para microsserviços via event-driven architecture, detalhando como adotar eventos locais dentro do próprio monólito pode ajudar no desacoplamento entre módulos, simplificando evolução e testes.
- Testes de integração com WebApplicationFactory e Testcontainers em ambientes event-drivenTestes de integração com WebApplicationFactory e Testcontainers são fundamentais para sistemas event-driven, garantindo que fluxos de eventos e integrações assíncronas funcionem corretamente, evitando falhas de comunicação e possibilitando rollback seguro nas atualizações.