Automatizar tarefas não precisa ser complicado. Neste guia, você aprenderá a desenhar e publicar um fluxo simples: do objetivo ao gatilho, passando por ações, condições e testes. Vamos usar n8n e integrar com Kommo CRM, mostrando passos práticos, webhooks e hospedagem em VPS. Ao final, você terá um workflow funcional e replicável, com boas práticas de segurança e monitoramento.
Do objetivo ao gatilho certo
Olha só: automação boa começa no problema de negócio e termina em ação que gera dinheiro. Sem firula. A regra é simples — define o alvo, escolhe o gatilho e corta o resto. Vamos pra prática.
- Objetivo: responder novos leads em até 5 minutos no horário comercial, mover para Qualificação e garantir uma tarefa de follow-up automática.
- Gatilho: novo lead recebido (formulário, e-mail encaminhado ou WhatsApp) criando o lead no Kommo.
- Entradas: nome, telefone e/ou e-mail, origem/campanha, interesse, data/hora, responsável. Saídas: mensagem inicial enviada, tarefa criada, estágio atualizado, tag de origem, log de primeiro contato.
- Critérios de sucesso: 90% dos leads respondidos em < 5 min; 100% com tarefa criada; taxa de duplicidade < 5%; implantação em até 2 dias corridos; relatório diário com SLA.
Regra de bolso: se não melhora velocidade, prioridade ou previsibilidade, tá sobrando coisa no fluxo.
- Evento: novo lead criado no Kommo no estágio Novo.
- Normalizar dados: padronizar telefone (DDD+9), e-mail e nome.
- Deduplicação: se já existir por telefone/e-mail, mesclar e manter histórico.
- Validação: se faltar contato, marcar tag contato-incompleto e criar tarefa de pesquisa (10 min).
- Resposta inicial: enviar mensagem curta (WhatsApp/E-mail) com apresentação + pergunta fechada (“posso te chamar agora ou prefere amanhã cedo?”).
- Criar tarefa: follow-up em 15 min se sem resposta; atribuir responsável e prioridade alta.
- Mover estágio: de Novo para Qualificação.
- Registrar: origem, tags, campo “primeiro_contato_at” e SLA.
- Próxima ação: se qualificado, preparar Proposta; se ganho/perdido, mover para Fechado com motivo.
É isso: fluxo começa no evento de novo lead e termina com mensagem inicial enviada + tarefa criada. No próximo passo, a gente pluga isso num workflow leve (n8n) pra rodar sem drama.
Primeiro fluxo no n8n
Vamos pra prática, sem enrolação. Instalação: local (máquina com Docker) ou em uma VPS barata roda liso. O n8n sobe rápido e roda via navegador; no fim do artigo tem tutorial de instalação. Aqui, foco no fluxo mínimo viável.
- Gatilho: escolha Webhook (recomendado para leads) ou Cron (rotinas). No Webhook, use a URL de teste pra validar e depois a de produção. Objetivo: receber o lead em tempo real.
- Set: normalize campos. Padronize chaves como name, email, phone, source, timestamp. Isso evita bagunça lá na frente.
- IF: valide obrigatórios. Se faltar email e phone, desvia para uma saída “incompleto” (você pode só registrar e encerrar). Se OK, segue.
- HTTP Request: enriquecimento simples. Ex.: verificar e-mail em um serviço de validação ou buscar dados por CEP/CNPJ. Retorne apenas o que for útil (cidade, score, segmento).
- Wait: adicione 1–3s para respeitar cadência e rate limits. Em campanhas, isso salva sua reputação de envio.
- HTTP Request: resposta inicial ao lead (e-mail/WhatsApp via seu provedor). Mensagem curta, útil, com próximo passo claro.
- HTTP Request: registrar em planilha/banco (API do seu repositório). Guarde payload, status e horário.
Salvar, ativar e versionar: nomeie o fluxo claro (ex.: “Inbound — Captura e Resposta 1.0”), salve e ative. Use descrições nos nós e
tags como “prod”, “teste”, “lead”.
Monitore em Executions (logs), configure alertas de erro. Credenciais: crie em Credentials, nunca em texto livre; use variáveis de ambiente no servidor. Versão: exporte o fluxo e versiona no seu Git. É isso. Bora.
Conecte ao Kommo CRM
Olha só: integrar o fluxo do n8n ao Kommo é o que faz o lead virar venda, tá? Sem enrolação. Foque em autenticar direito, criar/atualizar registros e reagir a eventos em tempo real.
- OAuth (recomendado): crie o app no Kommo, obtenha Client ID/Secret e domínio. Guarde em Credentials do n8n (criptografado), acesso mínimo e rotação periódica.
- API Key (legado/contas antigas): use só se necessário. Armazene em Credentials/variáveis de ambiente/secret manager. Nunca em parâmetros de nós.
- Segurança: desabilite edição de credenciais por não-admin, evite logs com PII e não versiona segredos no repositório.
Criação e atualização no Kommo (resultado prático):
- Lead: defina pipeline e estágio inicial; se já existir (e-mail/telefone vinculado ao contato), atualize e evite duplicar.
- Contato: name; e-mail e telefone em campos padrão; normalize telefone (E.164) pra bater deduplicação.
- Tarefa: defina texto objetivo e prazo; relacione ao lead para cobrar follow-up.
- Mapeamento rápido: nome → lead.name/contato.name; e-mail → contato.email; telefone → contato.phone; origem → tag “Origem:X” ou campo custom “source”.
Webhooks em tempo real: configure no Kommo os eventos “novo lead” e “mudança de status” apontando para a URL pública do seu webhook do n8n. Valide segredo/assinatura e deduplique pelo event_id.
- Chegou lead (webhook do Kommo): pega payload.
- Busca contato por e-mail/telefone; atualiza ou cria.
- Cria/atualiza lead no pipeline, estágio inicial; vincula contato.
- Adiciona nota e tarefa D+1 (ou 2h se inbound quente), responsável definido.
- Envia mensagem de boas-vindas e registra o ID da mensagem no lead.
- Rate limits: trate 429 com backoff incremental (2s, 4s, 8s + jitter) e controle de concorrência.
- Retries idempotentes: use external_id/chaves de dedupe para não criar duplicados.
- Logs de auditoria: guarde request_id/event_id/lead_id e máscaras de PII. Vai facilitar o capítulo de testes e escala. Bora.
Testar, erros e escalar
Olha só: antes de abrir a torneira, valide o fluxo ponta a ponta com dados do seu funil real, porém anonimizados. Vamos pra prática, sem enrolação: prove que o fluxo responde, decide e registra direito, tá?
- Testes: amostras reais com PII trocada por tokens; volume inicial de 50–100 eventos.
- Casos de sucesso/erro: lead válido, lead duplicado, telefone inválido, CRM fora do ar.
- Caminhos IF: qualificação “apto/inapto”, horário comercial/fora, origem orgânico/pago.
- Teste de carga leve: 10–20 eventos/min por 10 min pra achar gargalo.
Error workflows precisam existir antes do incidente:
- Retries com espera incremental (ex.: 1m, 5m, 15m) e limite claro.
- Timeouts por etapa para evitar travas silenciosas.
- Alertas: e-mail/Slack em falhas repetidas, com ID do lead e etapa.
- Quarentena de registros problemáticos para reprocesso manual.
- Métricas: tempo de resposta E2E, taxa de falhas por etapa, volume por hora.
- Defina limiares e ação: ex.: falha >3% em 15 min = pausar entrada.
- Segurança: segredos fora do fluxo (vault/variáveis) e acesso mínimo por papel.
- Limpeza de PII: mascarar, expirar e remover de logs.
- Logs de auditoria sem dados sensíveis.
Capacidade diária: 650 ligações; 30% atendidas; 3 min cadenciadas ≈ 585 min/dia. Sem fila e Wait, você derruba a operação.
- Escalonar: filas para picos, debouncing de duplicados e Wait para cadência.
- Backpressure: limite de execuções ativas por worker.
- Upgrade de VPS quando CPU >70% por 15 min ou fila >5x throughput.
- Checklist: casos de teste cobrindo 80% dos cenários e métricas ativas.
- Alertas com responsáveis e playbook de incidentes.
- Segredos protegidos e PII higienizada.
- Fila, Wait e debouncing configurados.
- Próximos passos: template do fluxo, padrões de campos, SLAs e tags.
- Replicar em novos processos mudando regras IF e cadência. Bora.
Conclusão
Você viu como transformar um objetivo em um fluxo real: definir gatilho, configurar ações, ramificar com condições, testar, tratar erros e publicar. Com n8n e Kommo CRM, dá para começar pequeno e evoluir com segurança em uma VPS. Próximo passo: padronize templates, monitore métricas e itere melhorias contínuas para ganhar escala sem perder qualidade.