Como Instalar a Evolution API e N8N no seu VPS

Vou te mostrar, de forma direta e prática, como configurar um VPS, instalar o EasyPanel, subir a Evolution API e ainda adicionar o N8N para automações. O objetivo é ter um ambiente pronto para registrar instâncias WhatsApp e integrá-las ao seu sistema para enviar mensagens automáticas.

Recomendo as VPS: DigitalOcean, Contabo, Hostinger, HostGator e a melhor de todas Napoleon Host

Visão geral do fluxo

• Contratar um VPS (recomendo provedores com suporte em português se preferir atendimento local).
• Acessar o terminal do VPS e instalar Docker.
• Rodar o EasyPanel via Docker (painel que gerencia projetos e templates).
• Instalar o template Evolution API dentro do EasyPanel.
• Criar e autenticar instâncias WhatsApp (scan do QR via WhatsApp > Dispositivos conectados).
• Integrar token, nome da instância e número remetente ao seu sistema.
• Opcional: instalar N8N para fluxos automatizados.

1. Escolhendo o VPS

Você pode usar qualquer VPS: DigitalOcean, Contabo, Hostinger, HostGator, Napoleon Host, etc. Minha recomendação prática:

• Se for iniciante e quiser suporte em português, considere Napoleon Host.
• Se quer um processo mais internacional, DigitalOcean e Contabo são boas opções.
• Tamanhos: para testes pessoais 2 CPU / 2 GB pode funcionar, mas para um SaaS ou filas maiores recomendo ao menos 4–8 GB de RAM e 2–8 CPUs. Um exemplo real usado aqui foi um droplet com 8 GB e 4 CPUs (custos variam conforme provedor).

2. Criando a máquina (exemplo DigitalOcean)

• Crie o droplet, escolha a região (próxima aos seus usuários é ideal), tamanho e sistema.
• Opte por autenticação por senha se não quiser lidar com SSH key inicialmente (mas use senha forte).
• Habilite monitoramento e anote o nome e senha do droplet.
• Abra o console via painel do provedor e aguarde o servidor subir.

3. Instalando Docker e EasyPanel

Com o terminal aberto, o primeiro passo é instalar o Docker. Um comando comum para instalar Docker de forma rápida é:

curl -fsSL https://get.docker.com | bash

Depois de instalar o Docker, você deve executar o comando oficial do EasyPanel para rodar o painel via Docker. Recomendo usar a linha oficial que o EasyPanel fornece (copie e cole no terminal do VPS). Esse comando faz o pull e cria os containers necessários.

docker run --rm -it \
  -v /etc/easypanel:/etc/easypanel \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  easypanel/easypanel setup

Em poucos minutos o EasyPanel ficará disponível através de uma URL (fornecida no painel do EasyPanel). Anote essa URL e crie seu usuário e senha no painel do EasyPanel.

4. Criando um projeto e instalando a Evolution API

No EasyPanel:

1. Clique em criar projeto. Atenção: nomes de projeto costumam exigir letras minúsculas e underscore; evite espaços e maiúsculas.
2. Dentro do projeto, vá em Templates/Modelos e procure por “Evolution API”.
3. Selecione a versão desejada (ou deixe a padrão) e crie o serviço.

O EasyPanel provisiona a Evolution API dentro do projeto. Esse processo leva alguns minutos até o container ficar 100% operacional.

5. Autenticação do manager (API key) e acesso ao painel Evolution

Para acessar o painel de gerenciamento da Evolution você precisa do API key do manager. No EasyPanel, dentro das variáveis de ambiente do serviço Evolution, copie o valor do campo de autenticação (API key).

Ao abrir o link do manager, cole esse token na tela de login. Esse token é o que permite controlar o manager da Evolution — guarde-o com segurança. Em outras máquinas ou navegadores novos, será solicitado o token novamente.

6. Criando e autentificando uma instância WhatsApp

1. No manager da Evolution, clique em “mais instâncias” ou “nova instância”.
2. Defina um nome para a instância (sem erros de digitação) e selecione o papel apropriado.
3. Informe o número de telefone no formato internacional (ex.: 55 + DDD + número para Brasil).
4. Depois de criada, abra as opções da instância e gere o QR Code.
5. No WhatsApp do celular: Configurações > Dispositivos conectados > Conectar dispositivo. Use o scanner do WhatsApp para ler o QR Code.

Ao escanear, a instância será vinculada e o status mudará para conectado. A partir daí você pode enviar mensagens usando essa instância via API.

7. Integração com seu sistema

Para integrar o seu sistema (um SaaS, site ou automação), você vai precisar basicamente de:

• URL do manager (host da Evolution)
• token do manager (API key)
• nome da instância
• número remetente (o telefone que você vinculou)

Com esses dados configurados na sua integração, seu sistema poderá disparar mensagens via Evolution. Faça testes com mensagens curtas e verifique logs para confirmar entrega.

8. N8N como bônus: automatizando fluxos

No EasyPanel você pode instalar outros serviços em templates. Um excelente complemento é o N8N, que permite criar workflows visuais para automações.

• Crie o template N8N dentro do mesmo projeto.
• Após a instalação, acesse o N8N, crie sua conta administrativa e comece a montar fluxos.
• O N8N pode se comunicar com a Evolution para disparar mensagens, reagir a eventos e integrar com outras APIs.

Dicas práticas e recomendações finais

• Segurança: guarde senhas e tokens em local seguro; tokens de manager dão controle total.
• Backups: faça snapshots do VPS antes de grandes mudanças.
• Escalabilidade: se o volume crescer, aumente RAM/CPU do VPS para evitar filas e lentidão.
• Suporte: escolha um provedor que ofereça suporte no idioma que você prefere para facilitar resolução de problemas.
• Templates adicionais: além do Evolution e N8N, você pode instalar WordPress, bancos de dados, PHPMyAdmin e outros serviços via EasyPanel.
• Testes: envie mensagens de teste para confirmar que tudo está funcionando antes de colocar em produção.

Resumo

Com um VPS, Docker e EasyPanel você tem um ambiente rápido para rodar a Evolution API e registrar instâncias WhatsApp. Adicionando o N8N, ganha uma camada visual poderosa para automatizar toda a lógica de disparo e integração. É um setup flexível, escalável e com várias possibilidades para SaaS, agências e sistemas internos.

Se preferir, escolha um provedor com suporte local para facilitar a configuração inicial, anote senhas e tokens e comece testando com um número antes de migrar tudo para produção.