🖥️

Configuração da API Evolution no VPS

Jun 9, 2025

Overview

A aula explica passo a passo como instalar e configurar a Evolution API para automação do WhatsApp, utilizando uma VPS e ferramentas auxiliares.

Conceitos Iniciais

  • Evolution API é um aplicativo open source que permite automatizar interações no WhatsApp via integração de sistemas.
  • Por ser código aberto, garante transparência, colaboração da comunidade e uso gratuito (desde que tenha hospedagem).
  • O uso comum envolve rodar a Evolution API em uma máquina virtual (VPS).

Preparação da VPS

  • Recomenda-se contratar uma VPS robusta, como a VPS 2 (6 vCPUs e boa memória RAM).
  • Prefira servidores localizados nos Estados Unidos para menor latência e maior estabilidade.
  • Opte por armazenamento NVMe ao invés de SSD convencional para melhor desempenho.
  • Instale o Ubuntu 20.04 como sistema operacional da VPS.
  • Crie e salve cuidadosamente a senha da máquina para acesso remoto.
  • Ative a opção "Private Networking" para maior privacidade e gerenciamento de rede.

Gerenciamento de Domínio e DNS

  • Adquira um domínio (por exemplo, na Hostinger) para organizar e mascarar os serviços da VPS.
  • Gerencie DNS pelo Cloudflare para proteger o IP e facilitar redirecionamentos.
  • Configure registros A e CNAME para apontar subdomínios aos respectivos serviços (ex: evolution.seudominio.com.br).

Instalação e Acesso à VPS

  • Baixe e instale o Terminus para acessar a VPS via SSH.
  • Faça backup da VPS com snapshots e saiba como redefinir a senha caso precise.
  • Acesse a VPS com usuário root e a senha criada no setup.

Instalação de Ferramentas Open Source

  • Utilize o instalador Orion para instalar rapidamente Evolution API, DeFi, N8n e Portainer.
  • O Portainer facilita o gerenciamento das instâncias dos aplicativos na VPS.
  • Siga a ordem do instalador, informando domínios, nomes e senhas solicitados.

Configuração da Evolution API

  • Após instalar o Portainer, utilize o instalador Orion para instalar a Evolution API.
  • Informe a URL do Portainer, usuário e senha criados anteriormente.
  • Defina o domínio para a Evolution e aguarde a finalização do deploy.
  • O instalador fornecerá a Global API Key para uso da Evolution API.

Recuperação e Gestão da API Key

  • Se perder a API Key, acesse via Terminus no diretório de dados Evolution para recuperá-la.
  • Não é possível alterá-la por esse arquivo, apenas visualizar a chave salva.

Integração com DeFi AI e Outros Serviços

  • Para integrações avançadas (ex: DeFi AI), siga o tutorial complementar indicado no vídeo.
  • A DeFi permite automação com respostas em áudio, leitura, transcrição e envio de imagens e vídeos pelo WhatsApp.

Key Terms & Definitions

  • Evolution API — Sistema open source que integra e automatiza o uso do WhatsApp Web por API.
  • VPS (Virtual Private Server) — Servidor virtual usado para hospedar aplicações.
  • Portainer — Gerenciador visual para administrar containers e stacks de aplicações.
  • Cloudflare — Serviço de gerenciamento de DNS e proteção de domínios.
  • Snapshot — Cópia de segurança do estado atual da VPS.
  • Global API Key — Chave de acesso única para utilizar a Evolution API.

Action Items / Next Steps

  • Contratar uma VPS adequada e registrar um domínio.
  • Configurar DNS e instalar Ubuntu 20.04 na VPS.
  • Instalar e configurar Portainer e Evolution API usando o instalador Orion.
  • Salvar as senhas e a API Key geradas durante o processo.
  • Conferir o vídeo complementar para integração Evolution + DeFi AI, se necessário.
  • Participar do desafio gratuito 5K com IA (live de 5 dias) para aprofundar conhecimentos.