Como integrar WhatsApp ao seu CRM usando Evolution API

Imagine o cenário: um lead manda mensagem no WhatsApp às 14h. O vendedor está em reunião. Às 17h, quando ele vai responder, o cliente já foi embora — ou pior, já fechou com a concorrência. Essa situação acontece todo dia em empresas de todos os tamanhos, e a causa é sempre a mesma: o WhatsApp está completamente desconectado do processo comercial.

A solução não é contratar mais vendedores. É conectar o WhatsApp ao CRM e automatizar o follow-up. E a combinação mais poderosa para fazer isso hoje é a Evolution API + n8n. Neste guia, vou te mostrar como funciona essa arquitetura e como implementar do zero.

O que é a Evolution API?

A Evolution API é uma solução open source que cria uma camada de API sobre o WhatsApp, permitindo que você envie e receba mensagens programaticamente — sem depender da API oficial da Meta.

Seus principais recursos:

• Múltiplas instâncias — gerencie vários números de WhatsApp a partir de um único servidor.
• Webhooks em tempo real — receba notificações instantâneas de cada mensagem recebida.
• Suporte a mídias — envie e receba imagens, áudios, documentos e vídeos via API.
• Integração com chatbots — conecte facilmente com n8n, Typebot, Chatwoot e outros.
• Self-hosted — roda via Docker no seu servidor, com controle total dos dados.

A Evolution API é a base de praticamente todos os projetos de automação de WhatsApp que implementamos na Allyce.Live. A comunidade é ativa, a documentação é boa e o projeto evolui rapidamente.

Por que integrar WhatsApp ao CRM?

A maioria das empresas brasileiras usa o WhatsApp como principal canal de vendas — mas trata cada conversa como um evento isolado. Isso cria uma série de problemas:

• Histórico pulverizado — cada vendedor tem seu histórico no celular pessoal, e quando ele sai da empresa, vai junto.
• Follow-up dependente de memória — o vendedor precisa lembrar de retornar, o que gera esquecimentos e leads perdidos.
• Sem visibilidade do pipeline — o gestor não sabe em que estágio cada lead está.
• Escalabilidade impossível — quando o volume de leads cresce, a qualidade do atendimento despenca.

Com a integração WhatsApp + CRM, cada mensagem entra automaticamente no pipeline, o histórico fica centralizado e as ações de follow-up acontecem sozinhas — independente de qualquer vendedor estar disponível.

Arquitetura da solução

A arquitetura que usamos nos projetos da Allyce envolve quatro componentes principais, cada um com uma responsabilidade clara:

O fluxo é simples: o cliente manda mensagem → a Evolution API captura e envia um webhook para o n8n → o n8n processa os dados (extrai nome, número, intenção) e decide o que fazer: criar um novo contato no CRM, atualizar o estágio do pipeline, acionar uma automação de resposta ou notificar um vendedor.

Passo a passo da implementação

Veja como estruturamos a implementação para nossos clientes:

1. Configurar a instância da Evolution API

Você pode rodar a Evolution API de duas formas:

• Docker (recomendado para produção) — instale em qualquer VPS (DigitalOcean, Contabo, AWS) com um simples docker-compose up.
• Serviço gerenciado — alguns provedores oferecem Evolution API já configurada, o que elimina a complexidade de infraestrutura.

Após instalar, você cria uma "instância" (que representa um número de WhatsApp), faz o scan do QR Code e pronto — o número está conectado à API.

2. Conectar o webhook ao n8n

Nas configurações da instância na Evolution API, você define uma URL de webhook — que será o endpoint do seu fluxo no n8n. A partir daí, cada mensagem recebida no WhatsApp dispara automaticamente uma chamada para o n8n com o payload completo: número do remetente, nome salvo, texto da mensagem, timestamp e tipo de mídia.

3. Criar o fluxo no n8n

O fluxo básico no n8n para integração com CRM tem estas etapas:

1. Webhook trigger — recebe o payload da Evolution API.
2. Extração de dados — um nó de "Set" ou código JavaScript extrai número, nome e mensagem do JSON recebido.
3. Busca no CRM — verifica se o contato já existe (evita duplicatas).
4. Criação ou atualização — se novo, cria o contato e a oportunidade; se já existe, atualiza o estágio e registra a interação.
5. Automação de resposta — envia uma mensagem automática de confirmação via Evolution API (opcional).
6. Notificação do vendedor — envia alerta via WhatsApp ou e-mail para o responsável pelo lead.

4. Testar com número real

Antes de colocar em produção, teste com um número de WhatsApp real. Mande mensagens de teste e verifique se os contatos estão sendo criados corretamente no CRM, se o histórico está sendo registrado e se as notificações estão chegando.

"Depois que integramos o WhatsApp ao nosso CRM, paramos de perder leads. O sistema qualifica, registra e já agenda o retorno do vendedor — tudo automaticamente."

Funcionalidades que você pode adicionar depois

A integração básica já gera muito valor, mas o verdadeiro potencial aparece quando você começa a adicionar camadas de inteligência:

• Qualificação automática por IA — um LLM analisa a primeira mensagem do lead e o classifica por perfil (persona, urgência, orçamento estimado).
• Catálogo de produtos inteligente — o cliente pergunta sobre um produto e o sistema responde com ficha técnica, preço e disponibilidade em estoque, consultando seu banco de dados em tempo real.
• Agendamento automático de reuniões — integração com Google Calendar: o lead escolhe o horário e a reunião já cai na agenda do vendedor certo.
• Alerta de lead quente — se o lead faz três contatos em menos de 24h, o sistema notifica o vendedor com prioridade máxima.
• Funil de nutrição — leads frios recebem conteúdo relevante de forma programada, sem esforço manual.

Atenção com os Termos de Uso do WhatsApp

É importante ser transparente sobre isso: a Evolution API não é a API oficial do WhatsApp (que é a Cloud API da Meta). Ela funciona simulando a conexão do WhatsApp Web, o que tecnicamente viola os Termos de Serviço do WhatsApp.

Na prática, o risco de banimento existe — especialmente se você usar o número para envio em massa de mensagens não solicitadas (spam). Para uso legítimo de suporte e vendas, onde os clientes iniciam as conversas, esse risco é muito menor.

Se você precisa de uma solução 100% oficial e está disposto a pagar o custo maior, a API oficial da Meta (via BSPs como Zenvia, Take Blip ou Twilio) é o caminho. Para a maioria das PMEs brasileiras, porém, a Evolution API é a escolha pragmática — com o risco gerenciado.