O que é
No menu Aplicações ela aparece com o nome Evolution GO: uma API para WhatsApp gratuita e
open source, publicada pela Evolution Foundation. “Evolution API” é o nome do protocolo/ecossistema
mais amplo — inclusive existe uma “Evolution API” tradicional, mais antiga, com um community node
próprio no n8n; o Evolution GO é a implementação atual instalada pelo GW Server. Roda em Docker,
muito usada junto do n8n (para orquestrar mensagens) e do
Typebot (para os fluxos de conversa).
O cenário de APIs não oficiais de WhatsApp muda o tempo todo: recursos que funcionam hoje (botões,
mídia) podem parar de funcionar amanhã por um bloqueio novo do WhatsApp. Espere sempre menos do que
a documentação da API promete, e trate mensagem de texto simples como o uso mais confiável.
Instalando
Siga o fluxo comum de instalação: domínio, fuso horário e SSL. O painel
busca a versão mais recente publicada no Docker Hub. Com a
integração Cloudflare configurada, os registros de DNS são criados
automaticamente — nenhum passo manual de DNS é necessário.
É uma aplicação leve: dá para instalar mais de uma instância no mesmo servidor sem peso relevante.
Bancos de dados
Diferente da maioria das outras aplicações, o Evolution GO sobe com dois bancos PostgreSQL: o
principal e o de autenticação. Os dois aparecem separados na aba Banco, com exportação e
importação independentes.
Ver Gerenciando uma aplicação para a ressalva do Adminer (troque o driver
para PostgreSQL antes de logar).
Ativando a licença gratuita
O acesso ao painel de administração (/manager/login) exige a GLOBAL_API_KEY da instalação —
a mesma chave usada para autenticar chamadas na API. Ela fica na aba Ambiente da gestão da
aplicação.
- Copie a GLOBAL_API_KEY na aba Ambiente.
- Acesse
/manager/loginno domínio da instalação e cole a chave. - Na primeira vez, gere a licença gratuita informando nome e e-mail.
- Confirme pelo e-mail de ativação.
O e-mail de ativação da licença é enviado pela própria Evolution — não pelo GW Server. Em caso de
falha (link “expirado” mesmo recém-chegado, ou nenhum e-mail chegando), tente o login via
Google na mesma tela: resolve a maioria dos casos de e-mail travado.
Depois de ativada, o login seguinte é direto: já não pede nova licença.
Criando uma instância
Cada número de WhatsApp conectado é uma instância, criada na aba própria dentro do painel do
Evolution GO.
O nome da instância aceita apenas letras, números e hífen — sem espaço. Token e proxy são
opcionais.
Conectando um número de WhatsApp
Depois de criar a instância, informe o número completo com DDI e conecte por um dos dois
métodos:
- QR code: mais rápido quando funciona, mas nem sempre conecta de primeira.
- Código de pareamento: em Dispositivos conectados → Conectar dispositivo, no celular — mais
confiável quando o QR code falha.
Há relatos (não confirmados por medição própria) de números sendo banidos ao conectar numa API não
oficial. Prefira conectar um número que você já usa ativamente no dia a dia, em vez de um número
dedicado apenas a testes de API.
Usando no n8n: o community node
Para orquestrar mensagens a partir de workflows, instale o community node do Evolution no n8n:
- No n8n, vá em Settings → Community Nodes e instale o pacote do Evolution.
- Crie uma credencial com a URL base da instalação (sem barra final no fim) e a API key da
instância (revelada em Configurações → Revelar, dentro do próprio Evolution GO). - Adicione o node Evolution ao workflow e escolha a ação — a mais estável na prática é
enviar mensagem de texto.
Nem toda ação do node funciona o tempo todo: bloqueios do WhatsApp mudam com frequência, e uma
atualização do node costuma restaurar o que parou de funcionar.
Segurança
O Evolution GO tem jail própria de fail2ban contra força bruta de autenticação
(POST/GET em /auth, /login, /session), banindo depois de tentativas malsucedidas
repetidas. Ver Fail2ban.
Veja também
Em vídeo: Aula 28 · Instalação e licença do Evolution GO · Aula 29 · Criando uma instância no Evolution GO · Aula 32 · Um exemplo real: Typebot, n8n e Evolution GO juntos