Mapa da trilha
🧱 Stack de automação
n8n + Hetzner + Supabase
🔌 Integração ERPs BR
Bling · Omie · Conta Azul
🚀 Deploy em produção
Rampa progressiva
📊 Medição e resultado
30/60/90 dias contra baseline
🤝 Handover
Para acompanhamento mensal
🔁 Loop de manutenção
A operação contínua
Conteúdo detalhado
🧱 Stack de automação canônica
n8n self-hosted em Hetzner (~US$ 5/mês) · Supabase com pgvector · Anthropic API com caching · WhatsApp Cloud API.
n8n self-host em Hetzner Cloud (CPX21, US$ 5/mês). Inclui Docker, n8n, postgres pra n8n. Backup automático.
n8n Cloud limita workflows; self-host é ilimitado, sem lock-in. Hetzner é barato e estável na UE.
Docker Compose · domínio próprio · TLS Let's Encrypt · backup S3.
Supabase free tier inicial; depois plano Pro US$ 25/mês. PostgreSQL + pgvector pra RAG, auth pronta, real-time.
Substitui Pinecone, Auth0, próprio backend. Stack em 1 só serviço.
pgvector · RLS · tier gratuito → Pro · backup gerenciado.
Provisiona WhatsApp Business API direto pela Meta Cloud. Sem BSP intermediário (360dialog, Wati) na maior parte dos casos.
BSP cobra mensalidade + por mensagem. Cloud API direto: só paga conversação iniciada pelo negócio. Mais barato.
Meta Business Manager · número verificado · template messages · janela 24h.
Conta na Anthropic direta. Models: Sonnet 4.6 (raciocínio), Haiku 4.5 (volume). Prompt caching reduz custo 90% em prompts grandes.
Atravessa intermediários (OpenRouter etc) que adicionam custo. Mais barato e mais previsível.
API key da Anthropic · prompt caching · monitor de custo · pre-paid.
Hetzner US$ 5 · Supabase US$ 25 · Anthropic ~R$ 100-300 (conforme volume) · WABA ~R$ 50-150. Total: R$ 200-500/mês por cliente.
Custo operacional pode rodar para você (revendido no preço) ou para cliente (cliente paga direto cada serviço). Decida no contrato.
Pass-through vs revenda · margem clara · cap de uso.
SSH key only (sem senha) · firewall só portas 80/443 · backup automático diário em S3 · secrets em vault (não em workflow).
Servidor invadido = vazamento de dado de cliente = LGPD + reputação destruída.
SSH key · firewall · backup diário · secrets gerenciado · revisão mensal.
🔌 Integração com ERPs brasileiros
Bling, Omie, Conta Azul, Tiny via REST. NF-e, PIX, webhook. O que diferencia implementador BR.
API REST do Bling v3. Endpoints: produtos, pedidos de venda, clientes, NF-e. Token OAuth 2.0.
Bling é o ERP mais comum em PME brasileira. Quem domina Bling pega 50% dos clientes.
OAuth 2.0 · rate limit · sandbox · webhook nativo.
Omie e Conta Azul são alternativas comuns em PMEs maiores. APIs próprias, autenticação por chave de aplicação.
Cliente que já usa Omie/Conta Azul não vai migrar — você que se adapta.
Chave de aplicação · endpoints diferentes · padrão JSON.
Bling, Omie, Conta Azul emitem NF-e via API. Você passa dados do pedido, ERP gera + envia à SEFAZ + retorna chave.
Pedido WhatsApp → NF-e em 2 min é o ROI mais visível. Caso SocialHub: 4h → 2 min.
NCM correto · CFOP · validação CNPJ · download XML+PDF.
Gera cobrança PIX no agente, envia QR code via WhatsApp, recebe webhook de pagamento, confirma automaticamente.
PIX é o canal que muda jogo. Cliente paga em 30s, pedido é confirmado automaticamente.
Asaas/MP API · QR code dinâmico · webhook de confirmação · reconciliação.
Cada webhook tem ID único. Você guarda IDs processados pra evitar duplicação (idempotência). Caso contrário: pedido criado 2x.
Bug clássico: provider reenvia webhook por timeout → pedido duplicado → cliente recebe 2x.
Tabela de idempotência · TTL · retry com backoff.
Try/catch em cada chamada de API. Retry com backoff exponencial em erro 5xx. Alerta no Telegram/email se > 3 falhas seguidas.
Bling cai 1x/mês por 5-15 min. Sem tratamento, agente trava ou inventa resposta.
Retry com backoff · circuit breaker · alerta · fallback humano.
🚀 Deploy em produção
Rampa progressiva: shadow mode → 10% tráfego → 50% → 100%. HITL nível mais conservador no início. Job shadowing presencial.
Agente gera resposta mas só pra champion ler. Champion compara com o que ele teria respondido. Ajusta antes de cliente ver.
Última checagem antes do tráfego real. Pega erros que bateria automatizada não viu.
3-5 dias · 50-100 mensagens reais · champion presente · ajuste final.
Semana 1: agente responde 10% (roteamento por cliente). Semana 2: 50%. Semana 3: 100%. Cada estágio com revisão de métricas.
100% no dia 1 = se algo der errado, 100% do cliente sofre. Rampa contém estragos.
Feature flag · roteamento por % · rollback rápido.
Semanas 1-2: HITL N2 (sugestão — humano aprova cada resposta). Conforme estabiliza, sobe pra N3 (execução com gate) e depois N4 (autônomo com auditoria).
Conservador na largada protege cliente real e te dá tempo de aprender com tráfego de verdade.
N2 → N3 → N4 progressivo · gate explícito · critério de promoção.
Implementador passa 2-3 dias presencialmente na empresa cliente nos primeiros dias do go-live. Resolve dúvida na hora, vê adoção real, capta ajuste fino.
Dia 1 sem você presente = 80% chance de adoção quebrar. Sua presença ancora confiança.
Presencial · 2-3 dias · revisão real-time · feedback do operador.
Dashboard com: volume de mensagens · taxa de override · taxa de escalação · tempo de resposta · custo por conversa · top RTs aplicadas.
Sem dashboard, você descobre problema 2 semanas depois. Com dashboard, vê tendência em 24h.
Metabase ou Grafana · alertas no Telegram · revisão diária semana 1.
Feature flag pra desligar agente em 1 clique. Mensagens voltam ao roteamento humano. Plano comunicado ao cliente antes de subir.
Sem rollback fácil, problema grande quebra confiança. Com rollback, você prova competência.
Kill switch · plano escrito · número de emergência · runbook.
📊 Medição e resultado
Métrica contra baseline em 30, 60, 90 dias. Apresentação trimestral com slides claros. O que sustenta a manutenção mensal.
Mede as mesmas 4 dimensões do baseline (tempo, volume, erro, custo) em 30, 60, 90 dias. Compara contra o assinado em D.
É o slide 1 da apresentação trimestral. Sem isso, "ah, parece que melhorou" não vende manutenção.
4 dimensões · janela 30/60/90 · comparação visual · ponto-base assinado.
Cálculo em reais: (custo antes - custo depois) × meses = economia acumulada. Compara com investimento total. Payback realizado em meses.
É o que o dono mostra pro contador e pro sócio. Justifica a renovação da manutenção.
Cálculo conservador · margem de segurança · gráfico simples.
Reunião presencial de 30 min com dono e sócios. 5 slides: (1) baseline assinado · (2) atual · (3) economia · (4) próximos 90d · (5) renovação.
É o ritual que separa consultor sério de freelancer. Cliente espera, sócios respeitam.
5 slides · presencial · trimestral fixo · ata de reunião.
Se KPI ficou abaixo da meta: apresenta o gap, explica causa, propõe plano de recuperação. Não esconde, não maquia.
Maquiar quebra confiança quando descobrirem. Honestidade preserva e gera respeito.
Transparência total · causa-raiz · plano de recuperação · cronograma.
Além das 4 do baseline, mede: NPS do cliente final, taxa de adoção pelo operador, taxa de override, satisfação interna.
Métricas secundárias mostram saúde além do número-chefe. Detectam problema 30 dias antes do KPI cair.
NPS via WhatsApp · adoção · override · pulsos mensais.
Sucesso no 1º processo abre porta pro 2º: outro DPIA, outra fase D, outro projeto. Cliente continua escalando.
É a expansão dentro do cliente. CAC zero. Ticket alto. Continua usando a stack já montada.
Expansão interna · novo DPIA · novo contrato · economia de CAC.
🤝 Handover para acompanhamento
Encerrar projeto inicial (90 dias) e migrar para contrato de manutenção mensal. Mudança de modo de trabalho.
Aos 90 dias: apresentação trimestral + assinatura de contrato de manutenção. Encerra o "projeto" e abre o "ciclo recorrente".
Marco claro evita confusão de escopo. Cliente entende o que muda — frequência, formato, valor.
Data marcada · cerimônia leve · novo contrato.
Tier básico/intermediário/avançado conforme T6 e Aplicação. Escopo: visitas, ajustes, micro-vídeos, métrica mensal, SLA, cláusula anti-lock-in.
Contrato é prova de seriedade. Sem ele, fica "vou ajudando" — destrói margem.
12 meses renovável · tier explícito · entregáveis listados.
Visita (1-4×/mês conforme tier) · revisão de métricas · ajustes de prompt/RAG · novas regras tácitas · micro-vídeos novos · relatório mensal.
Rotina previsível = cliente sabe o que espera, você sabe o que entrega. Vira ativo recorrente.
Calendário fixo · checklist mensal · entregáveis previsíveis.
Grupo no WhatsApp com você, dono, champion. Dúvidas, bugs, sugestões. Resposta em ≤4h em dia útil. SLA documentado.
Sem canal, cliente liga 23h ou esquece. Com grupo dedicado, tudo fica organizado e versionado.
Grupo WhatsApp · SLA 4h · regras de uso · responsável.
A cada 12 meses, apresentação detalhada com resultado anual + plano do próximo ano. Discute ajuste de tier, valor, escopo.
Sem ritual de renovação, contrato vira "esquecido" e renova no automático sem oportunidade de upsell ou ajuste.
Ano de números · próximo ano · ajuste de tier · novo DPIA.
Cláusula obrigatória no contrato: cliente recebe acesso a tudo (prompt, n8n, base RAG) e pode contratar outro implementador sem multa.
Princípio anti-dependência. Sem lock-in = relação por mérito. É o que diferencia consultor ético.
Cláusula explícita · pacote de saída · transição em 30 dias.
🔁 Loop de manutenção (acompanhamento)
A operação contínua paralela ao DPIA. Não é fase — é o estado estacionário do cliente bem-atendido.
(1) Aumento de override · (2) Queda de volume · (3) Aumento de escalação · (4) Queda de NPS. Qualquer um por 2 semanas seguidas = alerta.
Detectar cedo permite ajustar antes do cliente cancelar. Detectar tarde = perdeu o cliente.
4 indicadores · revisão semanal · ação imediata em alerta.
Sinal de queda → agenda visita extraordinária em <7 dias. Vai presencialmente, escuta operador, identifica causa, ajusta no local.
Visita extra blinda contra cancelamento e mostra compromisso. Custo: 1 dia. Benefício: cliente recorrente preservado.
Visita <7d · sem cobrança extra · ajuste mesmo dia · relatório.
A cada visita mensal, captura 1-3 RTs novas (regras tácitas que surgiram), atualiza FAQ no RAG, adiciona few-shot.
Pacote estático envelhece. Atualizado mantém qualidade alta e cliente percebe trabalho contínuo.
Versionamento · changelog · regressão na bateria.
Início no N2 (sugestão). Em 30-60 dias com métrica boa, sobe pra N3 (execução com gate). Em 90+ dias, N4 (autônomo com auditoria) em cenários estáveis.
HITL alto demais = trabalho humano não muda. HITL baixo demais = risco. Promoção gradual otimiza ROI.
Critério de promoção · auditoria contínua · revisão por cenário.
Claude 5 lança? Você troca em 1-2 dias. Sonnet 4.6 vira Sonnet 5.0 com 1 mudança de string. Stack componível protege contra churn de modelo.
Quem amarra a um modelo paga caro quando troca. Stack componível é o ativo do implementador.
Abstração via n8n · troca de model_id · bateria de regressão · zero downtime.
Cultura interna onde champion treina novos operadores, sugere melhorias, fala bem do agente publicamente. Você é parceiro, não fornecedor.
Cultura sólida = cliente vira referência viva. Indicação espontânea. CAC zero.
Champion empoderado · case interno · indicação espontânea.