Automatizar o WhatsApp com inteligência, integrações e IA é hoje uma das estratégias mais poderosas para empresas. Neste tutorial completo, você aprenderá como integrar Evolution API + WhatsApp Cloud API + n8n passo a passo.
👉 Antes de começar: esse tipo de automação exige uma infraestrutura estável e bem configurada.
A VPS para n8n da Saldaris já vem pronta com ambiente otimizado, SSL, segurança e suporte especializado.
Oferta: contratando 1 ano, você ganha 1 hora de consultoria gratuita para configurar uma automação completa.
Visão geral da arquitetura
Você vai montar o seguinte fluxo:
Usuário → WhatsApp → Cloud API (Meta) → Evolution API (middleware) → n8n (processamento/IA) → Evolution API → WhatsApp
O n8n será o cérebro da automação.
Pré-requisitos
- VPS com acesso root
- Docker e Docker Compose instalados
- n8n rodando (porta pública com SSL)
- Conta no Meta Developers
- Número validado no WhatsApp Cloud API
- Domínio configurado com HTTPS
1. Criar aplicação no Meta (WhatsApp Cloud API)
1.1 Criar app
- Acesse: https://developers.facebook.com/
- Clique em Meus Apps → Criar App
- Escolha: Business
1.2 Adicionar produto WhatsApp
- No painel do app, clique em Adicionar produto
- Selecione WhatsApp
1.3 Obter credenciais
Você vai precisar de:
- Access Token
- Phone Number ID
- WhatsApp Business Account ID
👉 Guarde esses dados.
2. Configurar webhook no Meta
Esse passo é crítico.
- Vá em: WhatsApp → Configuração → Webhooks
- Configure:
Callback URL: https://SEU_SERVIDOR/evolution/webhook/meta Verify Token: seu_token_seguro
Depois selecione os eventos:
- messages
- message_status
3. Instalar a Evolution API
3.1 Clonar projeto
cd /opt git clone https://github.com/EvolutionAPI/evolution-api.git cd evolution-api
3.2 Configurar variáveis
cp .env.example .env nano .env
Configure:
PORT=8080 AUTHENTICATION_API_KEY=senha_forte WEBHOOK_GLOBAL_URL=https://seu-n8n/webhook/whatsapp WEBHOOK_GLOBAL_ENABLED=true
3.3 Subir com Docker
docker-compose up -d
Verifique:
docker ps
4. Criar instância na Evolution API
Use curl ou Postman:
curl -X POST http://localhost:8080/instance/create \
-H "apikey: senha_forte" \
-H "Content-Type: application/json" \
-d '{
"instanceName": "empresa01",
"token": "123456"
}'
Resposta esperada:
- Instância criada
- Status ativo
5. Vincular Evolution API ao WhatsApp Cloud
Aqui você conecta o Meta com a Evolution.
Certifique-se que:
- Webhook do Meta aponta para Evolution
- Evolution está acessível publicamente (porta 8080 ou proxy)
👉 Se usar Nginx:
location /evolution {
proxy_pass http://localhost:8080;
}
6. Criar webhook no n8n
6.1 Criar node Webhook
- Tipo: POST
- Path: whatsapp
URL final:
https://seu-n8n/webhook/whatsapp
6.2 Testar recebimento
Envie mensagem no WhatsApp e veja se chega no n8n.
7. Processar mensagem no n8n
7.1 Extrair dados
Use um node “Set”:
{{ $json.body.data.message }}
{{ $json.body.data.key.remoteJid }}
7.2 Criar lógica
Use:
- IF node
- Switch node
7.3 Integrar IA (opcional)
Adicione:
- OpenAI node
- AI Agent
8. Enviar resposta via Evolution API
Node HTTP Request:
POST http://localhost:8080/message/sendText
Headers:
apikey: senha_forte Content-Type: application/json
Body:
{
"number": "{{ $json.body.data.key.remoteJid }}",
"text": "Olá! Recebi sua mensagem."
}
9. Teste completo
Checklist:
- Mensagem chega no n8n ✔
- Processa corretamente ✔
- Resposta enviada ✔
Problemas comuns
- Webhook não funciona: problema de SSL ou porta
- Erro 401: token inválido
- Mensagem não responde: erro no HTTP Request
- Timeout: VPS fraca
Conclusão
Agora você tem uma automação completa com WhatsApp, Evolution API e n8n funcionando.
Essa estrutura permite:
- Atendimento automático
- Chatbot com IA
- Integração com CRM
- Funis de vendas
👉 Para garantir performance e estabilidade, utilize uma infraestrutura adequada.
Conheça a VPS para n8n da Saldaris
Contratando 1 ano, você ganha 1 hora de consultoria gratuita para configurar sua automação.
Erro: Formulário de contato não encontrado.
