Se você trabalha com [[automação](https://clubmartech.com.br/blog/automacao-[testes](https://clubmartech.com.br/blog/testes-moderados-valide-retrabalho/)-script-inteligente/) de [marketing](https://comecandonaweb.com.br/marketing-digital/)](https://clubmartech.com.br/significado/automacao-de-marketing/) ou [vendas](https://clubmartech.com.br/blog/vendas-b2b-posicionamento-receita/) no Brasil, já esbarrou no dilema: como conectar [WhatsApp](https://clubmartech.com.br/significado/whatsapp/) aos seus sistemas [sem](https://clubmartech.com.br/blog/sem-avancado-estrategia-roi/) pagar os custos da API oficial da Meta ou depender de [plataformas](https://clubmartech.com.br/blog/plataformas-customer-intelligence-real/) fechadas? A **Evolution API** resolve esse problema. É uma solução open-source que permite integrar WhatsApp a CRMs, [chatbots](https://clubmartech.com.br/significado/chatbots/), automações e qualquer sistema via REST API — com controle total da [infraestrutura](https://clubmartech.com.br/blog/infraestrutura-[dados](https://clubmartech.com.br/blog/dados-transformar-volume-acionavel/)-[ia](https://clubmartech.com.br/blog/ia-marketing-vendas-inteligentes/)-meses/).A Evolution API se tornou referência no ecossistema brasileiro de martech por combinar flexibilidade técnica, custo acessível e uma comunidade ativa. Neste guia, você vai entender o que é, como instalar, configurar e usar a Evolution API para escalar operações de atendimento, vendas e campanhas.## O que é a Evolution API e por que ela se tornou popularA Evolution API é um projeto open-source que expõe uma interface REST sobre o protocolo do WhatsApp Web, permitindo enviar e receber mensagens, gerenciar contatos, criar grupos e automatizar fluxos — tudo via chamadas HTTP.Diferente da API oficial do WhatsApp Business (Cloud API da Meta), que exige aprovação, templates pré-aprovados e cobra por conversa, a Evolution API opera sobre a conexão do WhatsApp Web via QR Code. Isso significa:
- **Custo zero de mensagens**: você paga apenas a infraestrutura (servidor).
- **Sem aprovação de templates**: envie mensagens livres, sem esperar validação da Meta.
- **Controle total**: hospede onde quiser, customize como precisar.
- **Multi-device e multi-instância**: conecte vários números no mesmo servidor.
O projeto nasceu da necessidade real de agências, startups e times de operação que precisavam de WhatsApp programático sem a burocracia e o custo da API oficial. Hoje, a comunidade no GitHub soma milhares de stars e contribuições ativas.### Para quem a Evolution API faz sentidoA Evolution API atende bem cenários como:
- **Agências de marketing** que gerenciam WhatsApp de múltiplos clientes.
- **Times de vendas** que precisam de follow-up automatizado e integração com CRM.
- **Operações de suporte** que querem chatbots conectados ao WhatsApp.
- **SaaS e produtos digitais** que enviam notificações transacionais.
- **E-commerces** que automatizam confirmação de pedido, rastreio e pós-venda.
## Arquitetura e funcionamento técnico da Evolution APIA Evolution API funciona como um middleware entre sua aplicação e o WhatsApp Web. A arquitetura é direta:
[Sua Aplicação] → [Evolution API (REST)] → [WhatsApp Web Protocol] → [WhatsApp]Os componentes principais são:
- **Servidor HTTP (Node.js)**: expõe endpoints REST para todas as operações.
- **Gerenciador de sessões**: mantém conexões ativas com múltiplos números.
- **Sistema de webhooks**: notifica sua aplicação sobre mensagens recebidas, status de entrega e eventos.
- **Armazenamento**: MongoDB ou PostgreSQL para persistência de sessões e mensagens.
- **Cache**: Redis para gerenciamento de filas e performance.
Cada número conectado é uma “instância”. Você pode rodar dezenas de instâncias no mesmo servidor, cada uma com seu QR Code e configuração independente.### Endpoints principaisA API segue padrões REST consistentes:
| Operação | Endpoint | Método |
| Criar instância | /instance/create | POST |
| Conectar (QR Code) | /instance/connect/{instance} | GET |
| Enviar texto | /message/sendText/{instance} | POST |
| Enviar mídia | /message/sendMedia/{instance} | POST |
| Listar contatos | /chat/contacts/{instance} | GET |
| Configurar webhook | /webhook/set/{instance} | POST |
Se você quer entender melhor como APIs REST funcionam e como modelar endpoints de forma sustentável, vale conferir o artigo sobre
APIs RESTful na prática.## Evolution API vs. API Oficial do WhatsApp Business: quando usar cada umaAntes de escolher, vale entender as diferenças práticas:
| Critério | Evolution API | API Oficial (Meta) |
| Custo por mensagem | Zero | $0.005–$0.08 por conversa |
| Aprovação de templates | Não necessária | Obrigatória |
| Suporte multi-device | Sim | Sim |
| Risco de banimento | Moderado (se mal usado) | Baixo |
| SLA e suporte oficial | Comunidade | Meta/BSPs |
| Compliance empresarial | Depende da implementação | Certificado |
| Escala | Centenas de mensagens/min | Milhares/min |
| Green tick (verificado) | Não disponível | Disponível |
**Quando usar a Evolution API**: projetos internos, MVPs, operações de pequeno e médio porte, agências, testes de conceito, automações que não exigem compliance corporativo rigoroso.**Quando usar a API oficial**: operações enterprise com SLA, necessidade de selo verificado, volume muito alto (milhões de mensagens/mês), compliance regulatório obrigatório.Para muitos times de marketing e vendas no Brasil, a Evolution API cobre 80% dos casos de uso com uma fração do custo. A migração para a API oficial faz sentido quando a operação atinge escala e maturidade que justifiquem o investimento.## Como instalar a Evolution API com Docker (passo a passo)A forma mais prática de rodar a Evolution API é via Docker Compose. Aqui está o setup completo para produção.### Pré-requisitos
- Servidor Linux (Ubuntu 22.04+ recomendado) com mínimo 2GB RAM
- Docker e Docker Compose instalados
- Domínio apontando para o servidor (para HTTPS)
- Portas 8080 e 443 liberadas
### Docker Compose completoCrie um arquivo
docker-compose.yml:
version: "3.8"
services:
evolution-api:
image: atendai/evolution-api:latest
container_name: evolution-api
restart: always
ports:
- "8080:8080"
environment:
- SERVER_URL=https://api.seudominio.com.br
- AUTHENTICATION_API_KEY=sua-chave-secreta-aqui
- AUTHENTICATION_EXPOSE_IN_FETCH_INSTANCES=true
- DATABASE_ENABLED=true
- DATABASE_PROVIDER=postgresql
- DATABASE_CONNECTION_URI=postgresql://evolution:senha_segura@postgres:5432/evolution
- DATABASE_SAVE_DATA_INSTANCE=true
- DATABASE_SAVE_DATA_NEW_MESSAGE=true
- DATABASE_SAVE_DATA_CONTACTS=true
- CACHE_REDIS_ENABLED=true
- CACHE_REDIS_URI=redis://redis:6379
- CACHE_LOCAL_ENABLED=false
volumes:
- evolution_instances:/evolution/instances
depends_on:
- postgres
- redis
networks:
- evolution-network
postgres:
image: postgres:15-alpine
container_name: evolution-postgres
restart: always
environment:
- POSTGRES_USER=evolution
- POSTGRES_PASSWORD=senha_segura
- POSTGRES_DB=evolution
volumes:
- postgres_data:/var/lib/postgresql/data
networks:
- evolution-network
redis:
image: redis:7-alpine
container_name: evolution-redis
restart: always
volumes:
- redis_data:/data
networks:
- evolution-network
volumes:
evolution_instances:
postgres_data:
redis_data:
networks:
evolution-network:
driver: bridge### Subindo o ambiente
# Criar diretório do projeto
mkdir -p /opt/evolution-api && cd /opt/evolution-api
# Criar o docker-compose.yml (cole o conteúdo acima)
nano docker-compose.yml
# Subir os containers
docker compose up -d
# Verificar se está rodando
docker compose logs -f evolution-apiApós alguns segundos, a API estará disponível em
http://seu-servidor:8080. O log deve mostrar
HTTP server running on port 8080.### Configurando HTTPS com NginxPara produção, configure um reverse proxy com SSL:
server {
listen 443 ssl;
server_name api.seudominio.com.br;
ssl_certificate /etc/letsencrypt/live/api.seudominio.com.br/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/api.seudominio.com.br/privkey.pem;
location / {
proxy_pass http://localhost:8080;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}Os headers de WebSocket (
Upgradee
Connection) são essenciais — a Evolution API usa WebSocket para manter a conexão com o WhatsApp em tempo real.## Configuração e primeiros passos com a Evolution APICom o servidor rodando, vamos criar a primeira instância e conectar um número.### Criando uma instância
curl -X POST https://api.seudominio.com.br/instance/create
-H "Content-Type: application/json"
-H "apikey: sua-chave-secreta-aqui"
-d '{
"instanceName": "minha-empresa",
"integration": "WHATSAPP-BAILEYS",
"qrcode": true,
"webhookUrl": "https://seu-webhook.com.br/evolution",
"webhookByEvents": true,
"webhookEvents": [
"MESSAGES_UPSERT",
"MESSAGES_UPDATE",
"CONNECTION_UPDATE"
]
}'A resposta inclui um QR Code em base64. Escaneie com o WhatsApp do número que deseja conectar.### Enviando a primeira mensagem
curl -X POST https://api.seudominio.com.br/message/sendText/minha-empresa
-H "Content-Type: application/json"
-H "apikey: sua-chave-secreta-aqui"
-d '{
"number": "5511999999999",
"text": "Olá! Esta é uma mensagem enviada via Evolution API."
}'### Enviando mídia (imagem, documento, áudio)
curl -X POST https://api.seudominio.com.br/message/sendMedia/minha-empresa
-H "Content-Type: application/json"
-H "apikey: sua-chave-secreta-aqui"
-d '{
"number": "5511999999999",
"mediatype": "image",
"media": "https://seusite.com.br/imagem-promo.jpg",
"caption": "Confira nossa oferta especial!"
}'## Webhooks: recebendo eventos em tempo realWebhooks são o coração da automação com a Evolution API. Cada vez que algo acontece (mensagem recebida, mensagem lida, conexão perdida), a API envia um POST para a URL configurada.### Configurando webhooks por instância
curl -X POST https://api.seudominio.com.br/webhook/set/minha-empresa
-H "Content-Type: application/json"
-H "apikey: sua-chave-secreta-aqui"
-d '{
"url": "https://seu-sistema.com.br/webhooks/whatsapp",
"webhookByEvents": true,
"webhookBase64": false,
"events": [
"MESSAGES_UPSERT",
"MESSAGES_UPDATE",
"SEND_MESSAGE",
"CONNECTION_UPDATE",
"QRCODE_UPDATED"
]
}'### Estrutura do payload recebidoQuando uma mensagem chega, o webhook envia algo como:
{
"event": "messages.upsert",
"instance": "minha-empresa",
"data": {
"key": {
"remoteJid": "5511999999999@s.whatsapp.net",
"fromMe": false,
"id": "3EB0A0B0C1D2E3F4"
},
"message": {
"conversation": "Quero saber sobre o produto X"
},
"messageTimestamp": "1715356800",
"pushName": "João Silva"
}
}### Eventos mais úteis para automação
| Evento | Quando dispara | Uso típico |
MESSAGES_UPSERT | Nova mensagem recebida | Chatbot, roteamento, CRM |
MESSAGES_UPDATE | Status atualizado (lido, entregue) | Métricas de engajamento |
SEND_MESSAGE | Mensagem enviada com sucesso | Confirmação, logs |
CONNECTION_UPDATE | Conexão caiu ou reconectou | Alertas, reconexão automática |
QRCODE_UPDATED | Novo QR Code gerado | Painel de reconexão |
Com webhooks configurados, qualquer plataforma que aceite HTTP POST pode reagir a eventos do WhatsApp em tempo real.## Integrações com CRM, automação de marketing e chatbotsA força da Evolution API está na capacidade de se conectar a praticamente qualquer ferramenta do stack martech. Aqui estão as integrações mais comuns no mercado brasileiro.### Evolution API + N8N (automação low-code)O N8N é a ferramenta de automação mais usada com a Evolution API. A integração funciona via webhooks:
- Crie um workflow no N8N com um nó **Webhook** como trigger.
- Configure a URL do webhook do N8N na instância da Evolution API.
- Adicione nós de processamento: filtros, consultas ao CRM, lógica condicional.
- Use o nó **HTTP Request** para responder via Evolution API.
Exemplo de workflow N8N:
[Webhook Trigger] → [Filtrar por palavra-chave] → [Consultar CRM] → [Montar resposta] → [HTTP Request → Evolution API sendText]Esse padrão permite criar chatbots sofisticados sem escrever código, com lógica de negócio, consultas a banco de dados e integrações com dezenas de ferramentas.### Evolution API + Chatwoot (atendimento omnichannel)O Chatwoot é uma plataforma open-source de atendimento que se integra nativamente com a Evolution API. A combinação entrega:
- Inbox unificada para WhatsApp, e-mail e chat.
- Distribuição automática de conversas entre atendentes.
- Histórico completo de interações.
- Métricas de tempo de resposta e resolução.
A configuração é direta: no Chatwoot, crie um canal do tipo “API” e aponte para a instância da Evolution API. Os webhooks fazem o resto.Para quem busca uma visão mais ampla sobre atendimento omnichannel com IA, vale conferir o artigo sobre
Contato Inteligente com IA.### Evolution API + CRMs (HubSpot, Pipedrive, RD Station)A integração com CRMs segue um padrão comum:
- **Mensagem recebida** → webhook dispara → N8N/Make processa.
- **Identificar contato** → buscar no CRM por telefone.
- **Atualizar registro** → adicionar nota, mover no pipeline, criar tarefa.
- **Responder** → enviar mensagem personalizada via Evolution API.
Exemplo prático com Pipedrive:
// Webhook recebido do Evolution API
const { data } = webhookPayload;
const phone = data.key.remoteJid.replace("@s.whatsapp.net", "");
const message = data.message.conversation;
// Buscar deal no Pipedrive
const deal = await pipedrive.searchDeals({ term: phone });
// Atualizar nota no deal
await pipedrive.addNote({
deal_id: deal.id,
content: `WhatsApp: ${message}`
});
// Responder via Evolution API
await fetch("https://api.seudominio.com.br/message/sendText/minha-empresa", {
method: "POST",
headers: {
"Content-Type": "application/json",
"apikey": process.env.EVOLUTION_API_KEY
},
body: JSON.stringify({
number: phone,
text: `Olá ${deal.contact_name}! Recebi sua mensagem. Vou verificar e retorno em breve.`
})
});Esse tipo de integração transforma o WhatsApp em um canal ativo do CRM, com rastreabilidade completa. Para aprofundar em estratégias de qualificação via WhatsApp, veja o artigo sobre
qualificação de leads com CRM e IA.### Evolution API + Chatbots (Botpress, Typebot, Dialogflow)Para chatbots mais sofisticados com NLP e fluxos visuais:
- **Typebot**: integração nativa com Evolution API via configuração de webhook. Ideal para fluxos de qualificação e FAQ.
- **Botpress**: conecte via HTTP e use os recursos de NLU para entender intenções.
- **Dialogflow**: processe mensagens recebidas no Dialogflow e retorne respostas via Evolution API.
O padrão é sempre o mesmo: webhook recebe → processa no motor de chatbot → responde via API REST.## Casos de uso: atendimento, vendas, notificações e campanhasA Evolution API viabiliza automações que antes exigiam plataformas caras ou desenvolvimento complexo. Aqui estão os casos de uso mais comuns no mercado brasileiro.### 1. Atendimento ao cliente com roteamento inteligenteMonte um sistema onde mensagens são classificadas por intenção e roteadas para o time correto:
- Mensagens com palavras como “cancelar”, “problema”, “reclamação” → time de retenção.
- Mensagens com “preço”, “plano”, “contratar” → time de vendas.
- Mensagens com “boleto”, “nota fiscal”, “pagamento” → time financeiro.
Com N8N ou Make, essa lógica é implementada em minutos, sem código.### 2. Follow-up automatizado de vendasCrie sequências de follow-up baseadas em eventos do CRM:
Dia 0: Lead entrou no pipeline → "Olá! Vi que você se interessou pelo [produto]. Posso ajudar?"
Dia 2: Sem resposta → "Só passando para ver se ficou alguma dúvida sobre [produto]."
Dia 5: Sem resposta → "Última mensagem! Temos uma condição especial até sexta. Quer saber mais?"Esse tipo de sequência, quando bem calibrada, aumenta taxas de conversão em 20-40% segundo dados de operações brasileiras que usam a Evolution API.### 3. Notificações transacionaisAutomatize comunicações operacionais:
- Confirmação de pedido com número de rastreio.
- Lembrete de agendamento 24h antes.
- Alerta de vencimento de boleto.
- Confirmação de pagamento recebido.
### 4. Campanhas segmentadasEnvie mensagens para listas segmentadas do CRM:
# Exemplo: enviar para lista de clientes com compra nos últimos 30 dias
for number in $(cat clientes_ativos.txt); do
curl -s -X POST https://api.seudominio.com.br/message/sendText/minha-empresa
-H "Content-Type: application/json"
-H "apikey: sua-chave-secreta-aqui"
-d "{
"number": "$number",
"text": "Novidade exclusiva para clientes: 20% off na nova coleção. Responda SIM para saber mais!"
}"
sleep 3 # Respeitar rate limit
doneO
sleepentre mensagens é fundamental para evitar bloqueios. Mais sobre isso na seção de boas práticas.Para estratégias mais amplas de marketing via WhatsApp, confira o artigo sobre
WhatsApp Marketing e performance.## Multi-device e multi-instância: escalando operaçõesUm dos diferenciais da Evolution API é o suporte a múltiplas instâncias no mesmo servidor. Isso permite:
- **Agências**: um servidor com instâncias separadas para cada cliente.
- **Empresas com múltiplos departamentos**: vendas, suporte e marketing em números diferentes.
- **Operações de alto volume**: distribuir carga entre vários números.
### Gerenciando múltiplas instâncias
# Listar todas as instâncias ativas
curl -X GET https://api.seudominio.com.br/instance/fetchInstances
-H "apikey: sua-chave-secreta-aqui"
# Verificar status de conexão
curl -X GET https://api.seudominio.com.br/instance/connectionState/minha-empresa
-H "apikey: sua-chave-secreta-aqui"
# Desconectar uma instância
curl -X DELETE https://api.seudominio.com.br/instance/logout/minha-empresa
-H "apikey: sua-chave-secreta-aqui"### Dimensionamento de infraestruturaComo referência para planejamento:
| Instâncias | RAM recomendada | CPU | Mensagens/hora estimadas |
| 1-5 | 2 GB | 1 vCPU | ~500 |
| 5-20 | 4 GB | 2 vCPU | ~2.000 |
| 20-50 | 8 GB | 4 vCPU | ~5.000 |
| 50+ | 16 GB+ | 8 vCPU | ~10.000+ |
Esses números variam conforme o tipo de mensagem (texto vs. mídia) e a complexidade dos webhooks processados.## Boas práticas para não ser banido do WhatsAppA Evolution API opera sobre o WhatsApp Web, que não é uma API oficial. O WhatsApp pode detectar comportamento automatizado e banir números. Siga estas práticas para minimizar riscos:### Regras de ouro
- **Respeite rate limits**: não envie mais de 1 mensagem a cada 3-5 segundos por número.
- **Evite mensagens em massa para contatos frios**: envie apenas para quem já interagiu com você.
- **Varie o conteúdo**: mensagens idênticas para muitos contatos são um sinal de spam.
- **Use horários comerciais**: evite envios entre 20h e 8h.
- **Monitore a taxa de bloqueio**: se muitos destinatários bloqueiam seu número, o risco de ban aumenta.
- **Aqueça números novos**: comece com volume baixo e aumente gradualmente ao longo de semanas.
- **Tenha opt-in**: envie apenas para quem autorizou receber mensagens.
### Sinais de alerta
- Mensagens não entregues com frequência crescente.
- QR Code pedindo reconexão repetidamente.
- Número temporariamente bloqueado (ban temporário de 24-72h).
Se um número for banido permanentemente, não há recurso. Por isso, diversifique: use múltiplos números e mantenha o volume por número dentro de limites seguros.## Segurança, compliance e LGPDOperar uma API de WhatsApp exige atenção a segurança e conformidade legal.### Segurança da infraestrutura
- **API Key forte**: use chaves com pelo menos 32 caracteres aleatórios.
- **HTTPS obrigatório**: nunca exponha a API sem SSL em produção.
- **Firewall**: restrinja acesso à porta da API apenas para IPs autorizados.
- **Atualizações**: mantenha a imagem Docker atualizada para patches de segurança.
- **Backup**: faça backup regular do volume de instâncias e do banco de dados.
# Exemplo de backup do PostgreSQL
docker exec evolution-postgres pg_dump -U evolution evolution > backup_$(date +%Y%m%d).sql### LGPD e consentimentoA Lei Geral de Proteção de Dados se aplica integralmente ao uso da Evolution API:
- **Base legal**: tenha consentimento explícito ou legítimo interesse documentado para enviar mensagens.
- **Opt-out**: ofereça forma clara de o contato parar de receber mensagens (ex: “envie SAIR para cancelar”).
- **Retenção de dados**: defina por quanto tempo mensagens e dados de contato são armazenados.
- **Acesso e exclusão**: esteja preparado para atender pedidos de acesso e exclusão de dados.
- **Registro de consentimento**: armazene quando e como cada contato autorizou o recebimento.
### Termos de serviço do WhatsAppÉ importante ter clareza: a Evolution API opera em uma zona cinzenta dos termos de serviço do WhatsApp. O uso de APIs não oficiais viola tecnicamente os ToS da Meta. Na prática, milhares de empresas brasileiras operam dessa forma, mas o risco existe. Para operações que exigem garantia contratual e compliance certificado, a
API oficial do WhatsApp Businessé o caminho correto.## Métricas e monitoramento de performancePara operar a Evolution API de forma profissional, monitore indicadores-chave:### Métricas operacionais
- **Taxa de entrega**: % de mensagens efetivamente entregues.
- **Tempo de resposta do webhook**: latência entre evento e processamento.
- **Uptime da conexão**: % do tempo que a instância permanece conectada.
- **Uso de recursos**: CPU, RAM e disco do servidor.
### Métricas de negócio
- **Taxa de resposta**: % de contatos que respondem às mensagens.
- **Tempo médio de primeira resposta**: quanto tempo o lead leva para responder.
- **Taxa de conversão por canal**: comparar WhatsApp vs. e-mail vs. outros canais.
- **Custo por conversa**: infraestrutura dividida pelo número de conversas.
### Monitoramento com alertasConfigure alertas para:
# Health check simples via cron
*/5 * * * * curl -sf https://api.seudominio.com.br/instance/connectionState/minha-empresa
-H "apikey: sua-chave" | grep -q "open" ||
curl -X POST https://hooks.slack.com/services/SEU/WEBHOOK/SLACK
-d '{"text":"⚠️ Evolution API: instância minha-empresa desconectada!"}'## Alternativas à Evolution API e quando considerar migrarA Evolution API não é a única opção. Conheça o ecossistema:
| Solução | Tipo | Diferencial |
| Evolution API | Open-source, self-hosted | Comunidade ativa, multi-instância |
| WPPConnect | Open-source, self-hosted | Mais leve, menos features |
| Baileys | Biblioteca Node.js | Máxima flexibilidade, mais código |
| API Oficial Meta | Cloud, paga | Compliance, escala, selo verificado |
| Plataformas (Twilio, MessageBird) | SaaS, paga | Facilidade, suporte, multi-canal |
**Considere migrar** quando:
- O volume ultrapassar a capacidade segura de APIs não oficiais.
- Compliance regulatório exigir API certificada.
- O custo de manutenção da infraestrutura superar o custo da API oficial.
- A operação precisar de SLA garantido.
Para entender melhor o ecossistema de APIs como produto e modelo de negócio, vale a leitura sobre
API Economy e ecossistemas escaláveis.## Conclusão: próximos passos para implementar a Evolution APIA Evolution API democratizou o acesso ao WhatsApp programático no Brasil. Com Docker, um servidor básico e algumas horas de configuração, qualquer time de marketing ou vendas consegue:
- **Conectar WhatsApp ao CRM** e ter rastreabilidade completa de conversas.
- **Automatizar atendimento** com chatbots e roteamento inteligente.
- **Criar sequências de vendas** com follow-up automatizado.
- **Enviar notificações transacionais** sem custo por mensagem.
- **Integrar com o stack martech** via webhooks e ferramentas low-code como N8N.
Para começar hoje:
- Suba o ambiente Docker com o compose deste artigo.
- Conecte um número de teste via QR Code.
- Configure um webhook apontando para um endpoint de teste (use webhook.site para validar).
- Integre com N8N ou Make para criar seu primeiro fluxo automatizado.
- Implemente as boas práticas anti-ban desde o dia zero.
O investimento em infraestrutura é mínimo (a partir de R$ 50/mês em VPS), e o retorno em eficiência operacional e conversão justifica a implementação para qualquer operação que dependa de WhatsApp como canal de relacionamento.Para complementar sua estratégia de marketing conversacional, explore também os artigos sobre
marketing conversacional com IA e WhatsAppe
automação de vendas com chatbots.—## SEO Técnico### Schema Markup (JSON-LD)
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Evolution API: Guia Completo para Automação de WhatsApp em Marketing e Vendas",
"description": "Evolution API é a solução open-source que conecta WhatsApp ao seu stack de marketing e vendas. Veja como instalar com Docker, configurar webhooks, integrar com CRMs e chatbots, e escalar automações sem depender da API oficial da Meta.",
"author": {
"@type": "Organization",
"name": "Club Martech",
"url": "https://clubmartech.com.br"
},
"publisher": {
"@type": "Organization",
"name": "Club Martech",
"url": "https://clubmartech.com.br",
"logo": {
"@type": "ImageObject",
"url": "https://clubmartech.com.br/logo.png"
}
},
"datePublished": "2025-05-10",
"dateModified": "2025-05-10",
"mainEntityOfPage": "https://clubmartech.com.br/blog/evolution-api-guia-completo-para-automacao-de-whatsapp-em-marketing-e-vendas/",
"keywords": "evolution api, whatsapp, automação, chatbot, api, open source, docker, marketing conversacional, webhooks, n8n"
}### FAQ Schema (JSON-LD)
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "O que é a Evolution API e para que serve?",
"acceptedAnswer": {
"@type": "Answer",
"text": "A Evolution API é um projeto open-source que expõe uma interface REST sobre o protocolo do WhatsApp Web, permitindo enviar e receber mensagens, gerenciar contatos, criar grupos e automatizar fluxos via chamadas HTTP, sem depender da API oficial da Meta."
}
},
{
"@type": "Question",
"name": "A Evolution API é gratuita?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Sim, a Evolution API é open-source e gratuita. O único custo é a infraestrutura de hospedagem (servidor/VPS), que pode começar a partir de R$ 50/mês."
}
},
{
"@type": "Question",
"name": "Como instalar a Evolution API com Docker?",
"acceptedAnswer": {
"@type": "Answer",
"text": "A instalação com Docker é feita via docker-compose, configurando variáveis de ambiente para banco de dados, porta e webhooks. O processo leva poucos minutos em um VPS com Docker instalado."
}
},
{
"@type": "Question",
"name": "A Evolution API pode ser integrada com CRMs e chatbots?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Sim, a Evolution API se integra com CRMs, chatbots e ferramentas de automação como n8n, Make e Typebot via webhooks e REST API, permitindo fluxos automatizados de atendimento e vendas."
}
}
]
}