Configuração da API Evolution

Jun 9, 2025

Overview

A aula apresenta um passo a passo para instalar e configurar a Evolution API em um servidor VPS, conectando o WhatsApp a agentes de inteligência artificial, além de procedimentos para adquirir domínio, configurar DNS e gerenciar a infraestrutura.

Conceitos Iniciais e a Evolution API

  • Evolution API é uma aplicação open source que automatiza o uso do WhatsApp Web por sistemas.
  • Por ser de código aberto, a Evolution API é gratuita e transparente quanto à segurança dos dados.
  • Não é necessário conhecer programação avançada para usar a Evolution API.
  • O uso da Evolution requer um servidor próprio, geralmente uma VPS (máquina virtual).

Escolha e Configuração da VPS

  • Opte por VPS com boas especificações (ex: 6 vCPUs, RAM suficiente) para evitar travamentos.
  • Prefira datacenters localizados nos EUA para menor latência e maior estabilidade.
  • Escolha armazenamento NVMe ao invés de SSD normal para maior velocidade na execução dos aplicativos.
  • O sistema operacional recomendado é o Ubuntu 20.04 (Linux).
  • Salve a senha da VPS durante a criação; ela é essencial para o acesso.

Gerenciamento de Domínio e DNS

  • Adquira um domínio (ex: Hostinger) para mascarar o IP da VPS e facilitar o acesso aos aplicativos.
  • Utilize a Cloudflare para gerenciar os registros DNS e proteger/exibir domínios personalizados.
  • Crie registros A para o IP principal da VPS e CNAME para subdomínios dos aplicativos (ex: evolution.seudominio.com).
  • Desative o proxy das entradas para evitar problemas de roteamento.

Instalação dos Aplicativos via Terminal

  • Use o aplicativo Terminus para acessar remotamente a VPS com usuário root.
  • Faça backup/restauração da VPS através de snapshots.
  • Utilize o instalador gratuito da Orion para instalar ferramentas (Portainer, Evolution, N8n).
  • Instale primeiro o Portainer (gerenciador das instâncias) seguindo o passo a passo do script.
  • Após a instalação, use as credenciais criadas para acessar o Portainer.

Instalação e Acesso à Evolution API

  • Pelo Terminal, escolha instalar a Evolution após concluir o setup do Portainer.
  • Insira o domínio dedicado à Evolution e as credenciais do Portainer quando solicitado.
  • Concluída a instalação, acesse Evolution pela URL gerada e use a Global API Key fornecida.
  • A API Key pode ser recuperada dentro do Terminus, acessando os arquivos da VPS.

Integrações e Próximos Passos

  • É possível integrar a Evolution à DeFi AI para automações avançadas com inteligência artificial no WhatsApp.
  • Para aprender integrações com a DeFi, acesse o vídeo indicado pelo instrutor.

Key Terms & Definitions

  • Evolution API — Aplicação open source para automação do WhatsApp Web.
  • VPS (Virtual Private Server) — Servidor virtual utilizado para hospedar aplicativos.
  • Portainer — Gerenciador de aplicativos e instâncias Docker.
  • Snapshot — Cópia de segurança do estado atual da VPS.
  • DNS (Domain Name System) — Sistema que traduz domínios em endereços IP.
  • API Key — Chave de acesso utilizada para autenticar e conectar sistemas à Evolution API.

Action Items / Next Steps

  • Contrate uma VPS, preferencialmente com Ubuntu 20.04 e NVMe.
  • Registre um domínio e configure os DNS na Cloudflare.
  • Baixe e configure o Terminus para acessar a VPS.
  • Use o instalador da Orion para implantar Portainer e Evolution API.
  • Anote as senhas e API Key geradas durante o processo.
  • Participe do desafio gratuito “5K com IA” se desejar aprofundar conhecimento e praticar automações.