Como Instalar Evolution API em VPS: WhatsApp Self-Hosted

Como Instalar Evolution API em VPS

Se você quer instalar Evolution API em VPS para conectar WhatsApp com automações, este é o guia completo.

Evolution API (EVO) é sistema intermediário que conecta WhatsApp a ferramentas automação:

• N8N (workflows automação)
• Typebot (chatbots)
• Chatwoot (atendimento)
• OpenAI/IA (assistentes inteligentes)

Caso uso real (Gerenciando Web):

Página inscrição curso → Botão WhatsApp → Typebot captura nome/email/telefone → Dados enviados N8N → Salvos Mautic → WhatsApp conectado via Evolution API inicia conversa com assistente IA treinado → Assistente responde dúvidas produto automaticamente.

Tudo automatizado, zero intervenção manual. Evolution API é peça-chave ligando WhatsApp ao ecossistema automação.

Neste tutorial:

1. Pré-requisitos (VPS, DNS, SMTP)
2. Instalar Evolution API SetupOrion (8 passos)
3. Configurar DNS subdomínio
4. Acessar gerenciador Evolution
5. Conectar WhatsApp (QR Code)
6. Integrações nativas disponíveis

Pré-Requisitos

Antes de instalar Evolution API, você precisa:

1. Servidor VPS

• Provedor: Contabo, DigitalOcean, Vultr
• Mínimo: 2GB RAM, 2 CPU, 20GB disco
• Recomendado: 4GB RAM (melhor estabilidade)
• OS: Ubuntu 22.04 LTS
• Acesso: SSH configurado

2. Traefik + Portainer Instalados

OBRIGATÓRIO. Evolution API precisa dessas ferramentas:

• Traefik: Proxy reverso (gerencia SSL, rotas)
• Portainer: Gerenciador containers Docker (interface visual)

Tutorial instalação: Traefik + Portainer SetupOrion

3. Domínio e Acesso DNS

Você precisa criar subdomínio:

• api.seudominio.com – Gerenciador Evolution API

Acesso gerenciador DNS (Cloudflare recomendado).

4. Credenciais SMTP (Opcional Mas Recomendado)

Para notificações automação:

• Opção 1: Amazon SES (recomendado)
• Opção 2: SendGrid

Você vai precisar: Host SMTP, porta, usuário, senha.

5. Ferramentas Locais

• Cliente SSH: Termius, PuTTY, terminal
• Navegador: Chrome ou Firefox
• Celular: WhatsApp instalado (conectar via QR Code)

Tempo estimado instalação: 10-15 minutos

Passo 1: Conectar SSH Servidor

ssh root@SEU-IP-VPS

Digite senha quando solicitado.

Passo 2: Executar SetupOrion

bash <(curl -sSL setup.oriondesign.art.br)

Menu com opções disponíveis aparece.

Se primeira vez instalando SetupOrion: Tutorial SetupOrion

Passo 3: Selecionar Evolution API

1. Menu mostra: “03 – Evolution API”
2. Digite: 03
3. Enter

Passo 4: Configurar Subdomínio

Pergunta: “Qual domínio para Evolution API?”

Resposta: api.seudominio.com

ANTES de dar Enter, criar registro DNS:

1. Abra gerenciador DNS (Cloudflare ou outro)
2. Adicionar registro:
   • Type: CNAME
   • Name: api
   • Target: vps.seudominio.com (ou IP direto)
   • Proxy: Desligado (nuvem cinza)
3. Salvar

Volte ao terminal e dê Enter.

Passo 5: Confirmar Instalação

Pergunta: “Está correto?”

Resposta: Y (yes)

Instalação Evolution API inicia automaticamente.

Passo 6: Aguardar Instalação (5 Etapas)

SetupOrion executa 5 etapas automatizadas:

1. Download Evolution API
2. Configuração containers Docker
3. Integração Traefik (SSL automático)
4. Integração Portainer (gerenciamento)
5. Geração credenciais acesso

Tempo: 3-5 minutos (Evolution API é leve)

Passo 7: Salvar Credenciais Acesso

Ao final, terminal mostra:

Server URL: https://api.seudominio.com
Global API Key: abc123xyz789...

IMPORTANTE: Copie e salve em local seguro (bloco notas, gerenciador senhas).

Você precisa dessas credenciais para acessar gerenciador.

Passo 8: Verificar Portainer

1. Acesse: https://portainer.seudominio.com
2. Menu lateral → Stacks
3. Localizar: evolution-api
4. Status: Running ✅

Evolution API instalada e rodando.

Acessar Gerenciador Evolution API

1. Abrir Navegador

Acesse: https://api.seudominio.com/manager

2. Login Gerenciador

1. Server URL: https://api.seudominio.com (pré-preenchido)
2. Global API Key: Cole API Key salva Passo 7
3. Clicar: “Login”

Gerenciador Evolution API abre.

Criar Instância WhatsApp

Instância = conexão WhatsApp única.

Você pode ter múltiplas instâncias (múltiplos números WhatsApp conectados).

1. Criar Nova Instância

1. Gerenciador → Clicar: “+ Instância” ou “Create Instance”
2. Preencher dados:
   • Instance Name: Nome identificador (ex: gerenciandoweb, empresa, vendas)
   • Number: Número WhatsApp completo com código país (ex: 5549988887777)
   • Token: Deixar padrão gerado (ou customizar)
3. Clicar: “Save”

Instância criada. Status: Disconnected (desconectado – normal).

Conectar WhatsApp (QR Code)

1. Gerar QR Code

1. Instância criada → Clicar: “Settings” ou ícone engrenagem
2. Clicar: “Connect” ou “Generate QR Code”
3. QR Code aparece na tela

2. Escanear QR Code WhatsApp

1. Abra WhatsApp no celular (mesmo número cadastrado instância)
2. WhatsApp → Menu (3 pontos) → “Dispositivos conectados”
3. Clicar: “Conectar dispositivo”
4. Confirmar (digital, senha, etc)
5. Apontar câmera para QR Code na tela

3. Nomear Dispositivo

WhatsApp pergunta nome dispositivo:

• • Sugestão: Evolution API ou Automação
  • Salvar

4. Sincronização Automática

Evolution API sincroniza automaticamente:

• • • Contatos
    • Conversas recentes
    • Mensagens

Status muda: Disconnected → Connected ✅

WhatsApp conectado Evolution API. Pronto para automações.

Integrações Nativas Evolution API

Evolution API tem integrações nativas (não precisa código):

1. Evolution Bot

Chatbot simples integrado. Configure fluxos conversação básicos direto gerenciador.

2. Chatwoot

Sistema atendimento multi-canal. Conecte WhatsApp Evolution API ao Chatwoot para atendimento organizado, múltiplos atendentes, histórico conversas.

Tutorial: Instalar Chatwoot VPS

3. Typebot

Chatbot visual drag-and-drop. Crie fluxos captura leads, qualificação, automação conversas.

Tutorial: Instalar Typebot VPS

4. OpenAI (ChatGPT)

Conecte assistentes IA treinados. WhatsApp responde automaticamente usando ChatGPT/GPT-4.

5. Dify

Plataforma low-code IA. Crie aplicações IA customizadas, conecte WhatsApp.

6. Flowise

Ferramenta visual criar workflows IA. Similar Dify, código aberto.

Integrações Externas (Via Webhook/API)

Evolution API conecta com qualquer ferramenta via API/Webhook:

N8N (Recomendado)

Plataforma automação workflows poderosa.

Exemplo workflow:

• • 1. Typebot captura lead (nome, email, telefone)
    2. Webhook envia dados N8N
    3. N8N processa:
       • Salva contato Mautic
       • Adiciona planilha Google Sheets
       • Envia notificação Slack
       • Inicia conversa WhatsApp Evolution API
    4. WhatsApp enviado automaticamente via Evolution API

Tutorial completo: Instalar N8N VPS

Mautic

Email marketing automação. Conecte Evolution API via N8N ou webhook direto.

Tutorial: Instalar Mautic VPS

Make (Ex-Integromat)

Alternativa N8N (cloud, pago). Conecta Evolution API via API.

Zapier

Similar Make. Conecta via webhooks.

Gerenciar Múltiplas Instâncias

Evolution API permite múltiplas instâncias (múltiplos números WhatsApp):

Casos uso:

• • • Empresa com múltiplos departamentos (vendas, suporte, financeiro)
    • Agência gerenciando clientes diferentes
    • Testes (produção + homologação)

Como criar:

• • 1. Gerenciador → Criar nova instância (mesmo processo)
    2. Nome diferente (identificar)
    3. Número WhatsApp diferente
    4. Gerar QR Code, conectar

Cada instância independente, credenciais únicas, gerenciamento separado.

Verificar Logs e Status

Via Portainer

• • 1. Portainer → Stacks → evolution-api
    2. Clicar sobre stack
    3. Ver containers rodando
    4. Clicar container → Logs
    5. Ver atividade tempo real

Via Gerenciador Evolution

• • 1. Instância conectada → Settings
    2. Ver status conexão
    3. Ver últimas mensagens/eventos

Troubleshooting: Problemas Comuns

Erro 1: Evolution API Não Abre (Timeout)

Causas:

• • • Container parado
    • DNS incorreto
    • Traefik não instalado

Soluções:

• • 1. Portainer → Containers → evolution-api → Status “Running”
    2. Se parado: Start
    3. DNS: ping api.seudominio.com (retornar IP VPS)
    4. Verificar Traefik instalado: Tutorial Traefik

Erro 2: QR Code Não Conecta WhatsApp

Causas:

• • • QR Code expirado (válido 60-90 segundos)
    • Número instância diferente número WhatsApp
    • WhatsApp não atualizado

Soluções:

• • 1. Gerar novo QR Code
    2. Escanear rapidamente (antes expirar)
    3. Verificar número instância = número WhatsApp celular
    4. Atualizar WhatsApp app store

Erro 3: WhatsApp Desconecta Sozinho

Causas:

• • • Container reiniciou
    • Rede instável
    • Bugs Evolution v2 conhecidos

Soluções:

• • 1. Reconectar QR Code
    2. Verificar uptime servidor (estável?)
    3. Monitorar logs Portainer (erros)
    4. Se problema persistente: Aguardar Evolution v3

Erro 4: Mensagens Não Enviam

Causas:

• • • WhatsApp desconectado
    • API key incorreta integração
    • Rate limit WhatsApp (muitas mensagens)

Soluções:

• • 1. Verificar status conexão (Connected?)
    2. Reconectar se necessário
    3. Verificar credenciais API integração (N8N, etc)
    4. Reduzir volume envios (WhatsApp limita)

Segurança Evolution API

1. Global API Key Segura

• • • Nunca compartilhe API key
    • Não exponha em código público (GitHub, etc)
    • Guarde local seguro (gerenciador senhas)

2. Firewall VPS

• • • Permitir apenas portas necessárias (80, 443, SSH)
    • Bloquear resto
    • Tutorial: SSH Segurança

3. SSL Ativo

• • • Traefik gerencia SSL automaticamente (Let’s Encrypt)
    • Sempre HTTPS (nunca HTTP)
    • Certificado renova automaticamente

4. Backup Regular

• • • Backup configuração Evolution API (Portainer export stack)
    • Backup instâncias conectadas
    • Se servidor falhar, restaura rapidamente

Limitações Evolution API v2

Bugs conhecidos comunidade:

• • • Desconexões intermitentes (alguns usuários)
    • Lentidão envios massa (alto volume)
    • Integrações específicas instáveis

Workarounds:

• • • Monitorar conexão (reconectar se cair)
    • Limitar volume envios simultâneos
    • Testar extensivamente antes produção

Futuro: Evolution v3 resolverá muitos bugs, reescrita código, melhorias performance.

Perguntas Frequentes

Evolution API é gratuita?

Sim, software open-source gratuito. Você paga apenas VPS (~R$ 30-100/mês).

Posso conectar múltiplos números WhatsApp?

Sim, criando múltiplas instâncias. Cada instância = número WhatsApp único.

Evolution API substitui WhatsApp Business API oficial?

Não. WhatsApp Business API oficial (paga, $$$) tem recursos enterprise (verificação, mensagens template). Evolution API é alternativa self-hosted para automação básica/média.

Preciso manter WhatsApp aberto celular?

Não. Após conectar QR Code, WhatsApp funciona via Evolution API independente celular (mesmo celular desligado). Similar WhatsApp Web.

WhatsApp pode banir conta usando Evolution API?

Risco existe (contra termos WhatsApp). Recomendações:

• • • Use número teste (não principal)
    • Não envie spam
    • Respeite limites WhatsApp (não milhares mensagens/dia)
    • Comportamento natural (não robótico)

Evolution v3 será compatível com v2?

Ainda não confirmado. Provavelmente mudanças instalação/configuração. Por isso aguardamos v3 estável para reescrever tutorial.

Posso migrar Evolution API outro servidor?

Sim. Exportar stack Portainer, importar novo servidor, reconectar WhatsApp QR Code.

Evolution API consome muitos recursos VPS?

Não, muito leve. 2GB RAM suficiente para várias instâncias. Menos recursos que N8N, Mautic.

Como atualizar Evolution API?

Portainer → Stacks → evolution-api → Editor → Trocar tag versão → Update stack. Mas cuidado: atualizações podem quebrar (testar antes produção).

Preciso Evolution API para usar N8N com WhatsApp?

Sim. N8N não conecta WhatsApp diretamente. Evolution API é ponte N8N ↔ WhatsApp.

Curso Completo Automações WhatsApp

Conclusão

Você aprendeu como instalar Evolution API em VPS completo e funcional.

Recapitulando:

• • 1. Instalou Evolution API via SetupOrion (8 passos)
    2. Configurou DNS subdomínio
    3. Criou instância WhatsApp
    4. Conectou via QR Code
    5. Conheceu integrações nativas disponíveis

Evolution API v2 (versão atual) funciona MAS tem bugs conhecidos. Evolution v3 está em desenvolvimento e quando lançar (estável), este artigo será completamente reescrito.

Próximos passos:

• • • Testar conexão WhatsApp (enviar mensagens teste)
    • Integrar N8N (automações complexas)
    • Conectar Typebot (chatbots captura leads)
    • Criar workflows automação completos

Evolution API é peça fundamental ecossistema automação WhatsApp self-hosted. Com ela, você controla dados, sem limites plataformas pagas, customização total.