Evolution API + Kommo: Integração Completa

O Que É a Evolution API e Por Que Usá-la

A Evolution API é uma solução open-source que permite conectar o WhatsApp a sistemas externos — como CRMs, chatbots e plataformas de automação — sem depender de provedores pagos. Ela atua como uma ponte entre o WhatsApp Web e suas ferramentas de negócio, possibilitando enviar e receber mensagens, mídias, criar grupos e muito mais via API REST.

Para quem usa o Kommo CRM, a Evolution API representa uma alternativa de baixo custo para integrar o WhatsApp, especialmente útil para negócios que estão começando ou que precisam de flexibilidade na configuração.

Na Metrik, como Top 5% Kommo Brasil, já realizamos centenas de integrações desse tipo. Neste tutorial, vamos compartilhar o passo a passo completo para você configurar tudo corretamente.

Pré-Requisitos para a Integração

Antes de começar, você precisa ter:

• Conta ativa no Kommo CRM: Plano com acesso a integrações (básico já serve).
• Servidor VPS: A Evolution API precisa rodar em um servidor. Recomendamos um VPS com pelo menos 1 vCPU, 2GB RAM e Ubuntu 22.04. Provedores como DigitalOcean, Contabo ou Hetzner oferecem opções acessíveis.
• Domínio ou subdomínio: Para acessar a API via HTTPS (ex: api.seusite.com).
• Número de WhatsApp dedicado: Um número que não seja usado pessoalmente, preferencialmente registrado no WhatsApp Business.
• Conhecimentos básicos de terminal: Ou disposição para seguir comandos passo a passo.

Instalação da Evolution API

Passo 1: Preparar o Servidor

Conecte-se ao seu VPS via SSH e atualize o sistema:

Atualize os pacotes: Execute a atualização do sistema operacional para garantir que tudo está na versão mais recente. Em seguida, instale o Docker e o Docker Compose, que são necessários para rodar a Evolution API em containers isolados.

Passo 2: Configurar Docker Compose

Crie um diretório para o projeto e configure o arquivo docker-compose.yml. A configuração principal inclui:

• Imagem da Evolution API (versão mais recente)
• Variáveis de ambiente (chave de API, URL do servidor, configurações de webhook)
• Banco de dados PostgreSQL para persistência de dados
• Redis para cache e filas
• Volumes para manter dados entre restarts

Passo 3: Configurar HTTPS com Nginx

Instale o Nginx como proxy reverso e configure o SSL com Let's Encrypt. Isso garante que a comunicação entre seu sistema e a API seja criptografada, um requisito essencial para segurança.

Passo 4: Iniciar a API

Com tudo configurado, inicie os containers. A API estará disponível em https://api.seudominio.com. Você pode verificar o status acessando o endpoint de health check.

Conectando o WhatsApp à Evolution API

Criar uma Instância

O primeiro passo é criar uma instância na Evolution API. Cada instância representa um número de WhatsApp. Via requisição POST ao endpoint de criação de instância, informe:

• Nome da instância (identificação interna)
• URL do webhook (para onde a API enviará eventos)
• Eventos a monitorar (mensagens recebidas, status de mensagens, mudanças de conexão)

Escanear QR Code

Após criar a instância, faça uma requisição GET ao endpoint de conexão para obter o QR Code. Escaneie este código com o WhatsApp do número que deseja conectar. Em poucos segundos, a conexão será estabelecida.

Verificar Conexão

Confirme que a instância está conectada verificando o status via API. O retorno deve indicar "open" como estado da conexão.

Integrando a Evolution API ao Kommo CRM

Método 1: Via Webhook Direto

Configure os webhooks da Evolution API para enviar eventos diretamente ao Kommo. O Kommo possui uma API de leads que permite criar e atualizar registros automaticamente quando mensagens são recebidas. Para isso:

• Obtenha as credenciais da API do Kommo (token de acesso)
• Configure o webhook da Evolution API para chamar seu servidor intermediário
• No servidor intermediário, processe o evento e use a API do Kommo para registrar o contato e a mensagem

Método 2: Via Make (Integromat)

Para quem prefere uma abordagem visual e sem código, o Make é uma excelente opção. Crie um cenário que:

• Recebe webhook da Evolution API quando uma mensagem chega
• Busca ou cria o contato no Kommo
• Registra a mensagem no histórico do lead
• Dispara automações como notificações ou mudança de etapa

Método 3: Via N8N (Self-Hosted)

O N8N é uma alternativa open-source ao Make. Você pode rodá-lo no mesmo servidor da Evolution API, reduzindo custos. O fluxo é similar ao do Make, mas com mais flexibilidade para personalizações.

Configurando o Fluxo de Mensagens Bidirecionais

A integração completa envolve dois fluxos:

WhatsApp → Kommo (Mensagens Recebidas)

Quando um cliente envia mensagem no WhatsApp:

• A Evolution API recebe e envia via webhook
• O orquestrador processa e envia ao Kommo
• O Kommo registra a mensagem no card do lead
• Se necessário, dispara automações (resposta automática, notificação ao vendedor)

Kommo → WhatsApp (Mensagens Enviadas)

Quando um agente ou automação envia mensagem pelo Kommo:

• O Kommo dispara um evento via webhook
• O orquestrador captura e envia para a Evolution API
• A Evolution API entrega a mensagem no WhatsApp do cliente
• O status de entrega é atualizado no Kommo

Adicionando IA ao Fluxo

Com a integração base funcionando, você pode adicionar inteligência artificial para responder automaticamente. O fluxo expandido fica:

• Mensagem recebida via Evolution API
• Contexto do cliente é buscado no Kommo
• Mensagem + contexto são enviados ao modelo de IA
• Resposta da IA é enviada de volta via Evolution API
• Tudo é registrado no Kommo

Para aprofundar nesse tema, confira nosso guia de automação de WhatsApp com IA e IA no atendimento ao cliente.

Solução de Problemas Comuns

Desconexão Frequente

Se a instância desconecta com frequência, verifique:

• Memória do servidor (2GB é o mínimo recomendado)
• Versão da Evolution API (mantenha atualizada)
• Se o WhatsApp está aberto em outro dispositivo (pode causar conflito)
• Configuração de timeout no Nginx

Mensagens Não Chegam ao Kommo

Verifique a cadeia de webhooks: teste cada endpoint individualmente para identificar onde o fluxo está quebrando. Ferramentas como webhook.site ajudam a debugar.

QR Code Expira Rápido

O QR Code tem validade curta. Automatize o processo de reconexão configurando monitoramento da instância e alertas quando a conexão cai.

Monitoramento e Manutenção

Para manter a integração rodando de forma estável:

• Configure monitoramento de uptime (UptimeRobot ou similar)
• Habilite logs detalhados na Evolution API
• Faça backups regulares do banco de dados
• Mantenha o Docker e a API atualizados
• Monitore o consumo de recursos do servidor

Considerações de Escalabilidade

A Evolution API suporta múltiplas instâncias no mesmo servidor, permitindo conectar vários números de WhatsApp. Para operações de grande porte:

• Use um servidor mais robusto (4 vCPUs, 8GB RAM para 10+ instâncias)
• Considere balanceamento de carga entre múltiplos servidores
• Implemente filas (Redis/RabbitMQ) para processar mensagens em pico
• Mantenha instâncias de backup para failover

Dentro do Método METRIK, a fase de Estruturação aborda exatamente como montar essa infraestrutura de forma escalável. Não é apenas sobre fazer funcionar — é sobre fazer funcionar de forma sustentável quando o volume cresce.

Conclusão

A integração entre Evolution API e Kommo CRM é uma das formas mais custo-eficientes de automatizar o WhatsApp para negócios. Com a configuração correta, você obtém uma solução robusta, flexível e escalável que compete com provedores que cobram milhares por mês.

Se você precisa de ajuda com a implementação ou quer aprender a oferecer esse serviço para clientes, a comunidade Metrik tem o suporte e o conhecimento que você precisa.

Quer aprender a integrar WhatsApp profissionalmente? Entre para a comunidade Metrik e domine integrações de CRM.