Evolution GO: o que é, como instalar e como ligar o WhatsApp ao n8n
Neste guia
- O que é o Evolution GO
- Evolution GO ou Evolution API: o que muda
- Antes de instalar: o que esperar de uma API não oficial
- Como instalar o Evolution GO
- Ativando a licença gratuita
- Criando a instância e conectando o número
- Usando o Evolution GO no n8n
- Ideias de uso que funcionam
- Segurança: o painel é alvo desde o primeiro dia
- Perguntas frequentes
Quem quer automatizar o WhatsApp sem pagar por mensagem acaba numa API não oficial. E nesse mundo, a Evolution é a mais conhecida no Brasil. O Evolution GO é a versão nova dela: gratuita, leve e com painel próprio. Eu uso no meu dia a dia para mandar notificações e dados de acesso pelo n8n. Neste artigo eu mostro o que ele é, como instalar, como passar pela ativação da licença (que travou comigo duas vezes) e como mandar a primeira mensagem pelo n8n. Mais abaixo estão os vídeos com tudo isso na tela.
O que é o Evolution GO
O Evolution GO é uma API de WhatsApp gratuita e de código aberto, publicada pela Evolution Foundation. Em termos simples: ela conecta um número de WhatsApp a um programa no seu servidor, e a partir daí outros sistemas conseguem enviar e receber mensagens por esse número, sem ninguém tocar no celular.
Ele roda em Docker e guarda os dados em dois bancos PostgreSQL: o principal e o de autenticação. Cada número conectado é uma instância, e o mesmo Evolution GO aguenta várias.
Evolution GO ou Evolution API: o que muda
“Evolution API” virou o nome do ecossistema inteiro. Na prática, hoje existem duas:
| Evolution API (tradicional) | Evolution GO | |
|---|---|---|
| Idade | A mais antiga e mais conhecida | A implementação nova, leve: várias instâncias no mesmo servidor sem peso relevante |
| Licença | Sem cadastro | Gratuita, com cadastro na primeira entrada |
| n8n | Nó próprio da comunidade | Nó próprio do Evolution GO |
Se você já usa a versão tradicional, eu mostro a instalação dela em como instalar a Evolution API em VPS. Para começar do zero hoje, eu vou de Evolution GO.
Antes de instalar: o que esperar de uma API não oficial
O WhatsApp está cada vez mais rígido com APIs que não são a oficial da Meta. Recursos que funcionam hoje, como botões e listas, podem parar amanhã. Por isso eu sou bem franco: não espere muito além de mandar e receber mensagens de texto. É o uso mais confiável, e é o que eu uso.
💡 Dica do Gabriel
Existem relatos de números banidos só por conectar numa API não oficial. Comigo nunca aconteceu, e eu uso essas APIs há muito tempo. A diferença, acredito, é que os números que eu conecto são números de verdade: estão nos meus grupos, eu converso por eles todo dia. Evite conectar um chip novo, usado só pela API.
Como instalar o Evolution GO
O Evolution GO é um contêiner Docker, então dá para subir em qualquer VPS com Docker. Você vai precisar de um subdomínio (algo como evogo.seudominio.com.br) apontado para o servidor e de um certificado SSL.
No GW Server, a instalação fica no menu Aplicações: você informa o domínio e o fuso horário, o painel busca a versão mais recente publicada e, com a integração da Cloudflare ligada, cria até o registro de DNS sozinho. A gestão da aplicação fica numa tela própria, com os dois bancos, as variáveis de ambiente, o certificado, os logs e o backup.
Veja a instalação e a ativação:
Ativando a licença gratuita
O painel do Evolution GO fica em /manager/login, no endereço da instalação. Para entrar, você usa a GLOBAL_API_KEY, uma chave que está nas variáveis de ambiente da aplicação. É a mesma chave que autentica as chamadas à API: guarde com cuidado.
Na primeira entrada, ele pede a licença gratuita: nome e e-mail, e um link de ativação chega na sua caixa. Quando funciona, é rápido. Quando não funciona…
📊 Dados Reais
Ativação da licença por e-mail: o link chegou em cerca de 3 minutos e, ao clicar, já aparecia como usado. Tentei de novo, e com outro endereço de e-mail: mesmo erro. O e-mail é enviado pela própria Evolution, não pelo seu servidor. A ativação pelo login do Google, na mesma tela, funcionou na primeira tentativa.
Medido em: Evolution GO 0.7.2 instalado num GW Server, gravação da aula de instalação (agosto de 2026).
Depois de ativada, a licença fica registrada: nas próximas vezes, a GLOBAL_API_KEY basta para entrar.
Criando a instância e conectando o número
- No painel, vá em Instâncias e crie uma nova.
- O nome aceita só letras, números e hífen, sem espaço. Token e proxy são opcionais.
- Clique em conectar e informe o número completo, com o DDI (55 para o Brasil).
- Leia o QR code em Dispositivos conectados, no celular.
Se o QR code ficar carregando sem fim, use o código de pareamento: no celular, em Conectar dispositivo, escolha conectar com o número de telefone e digite o código que o painel mostra.
Usando o Evolution GO no n8n
O n8n é o melhor parceiro de uma API de WhatsApp: ele recebe um evento de qualquer lugar e transforma em mensagem.
- No n8n, vá em Settings → Community Nodes e instale o pacote do Evolution (o nome está na documentação do próprio Evolution). A documentação do n8n sobre nós da comunidade explica a instalação.
- Crie a credencial com a URL base da instalação, sem a barra no final, e a chave da instância (no painel do Evolution GO, em configurações da instância, opção revelar).
- No workflow, adicione o nó do Evolution e escolha enviar mensagem de texto. Número com 55, texto da mensagem, executar.
Veja a instância sendo criada e a primeira mensagem saindo pelo n8n:
Se uma ação do nó parar de funcionar do nada, não é você: o WhatsApp mudou alguma regra. Atualizar o nó costuma resolver.
Ideias de uso que funcionam
- Notificações para os seus grupos, como aviso de venda ou alerta de sistema. É o meu uso principal.
- Dados de acesso depois da compra: a plataforma de pagamento avisa o n8n por webhook, e o n8n manda login e senha para o cliente no WhatsApp.
- Lembretes de agendamento, renovação ou vencimento.
- Atendimento automático, juntando com o Typebot. Eu monto um completo em chatbot de WhatsApp com Typebot, n8n e Evolution.
⚠️ Atenção
Mensagem de marketing em massa é o caminho mais rápido para o banimento: muita gente marcando como spam derruba o número. Use a API para mensagens que a pessoa espera receber.
Segurança: o painel é alvo desde o primeiro dia
Assim que o Evolution GO entra no ar com um domínio público, robôs começam a testar endereços como /.git e /.env atrás de senhas esquecidas. No dia da gravação, o servidor já tinha banido alguns. No GW Server, o Evolution GO tem uma regra própria no fail2ban, que bane quem erra repetidamente o login (/auth, /login, /session). Eu explico como essa defesa funciona no artigo sobre o fail2ban.
Se você ainda não tem o n8n instalado, comece pelo guia de como instalar o n8n em VPS. E para ir fundo em automações com WhatsApp e IA, esse é o assunto do curso de n8n.
Quero meu servidor com WhatsApp e n8n →
Perguntas frequentes
O Evolution GO é gratuito?
Sim. O Evolution GO é gratuito e de código aberto. Ele pede uma licença, mas ela também é gratuita: serve para a Evolution saber quem está usando. Você gera com nome e e-mail, ou pelo login do Google, na primeira vez que entra no painel.
Qual a diferença entre Evolution GO e Evolution API?
Os dois são APIs de WhatsApp da mesma comunidade. A Evolution API tradicional é a versão mais antiga e mais conhecida, com o próprio nó no n8n. O Evolution GO é a implementação mais nova, leve o bastante para rodar várias instâncias no mesmo servidor, com painel próprio e licença gratuita.
O Evolution GO pode banir meu número de WhatsApp?
Qualquer API não oficial carrega esse risco, e há relatos de bloqueio. Eu uso APIs desse tipo há muito tempo e nunca tive um número banido, mas conecto números que uso de verdade no dia a dia, em conversas e grupos. Evite número novo usado só na API e nunca faça disparo em massa.
O QR code do Evolution GO não conecta. O que fazer?
Use o código de pareamento. No celular, em Dispositivos conectados, toque em Conectar dispositivo e escolha a opção de conectar com o número de telefone. O painel do Evolution GO gera o código, e essa via costuma funcionar quando o QR code fica carregando sem fim.
