Ir para o conteúdo

Digite pelo menos 2 letras.

Evolution GO: o que é, como instalar e como ligar o WhatsApp ao n8n

Evolution GO, API de WhatsApp gratuita, instalada no próprio servidor e ligada ao n8n
Neste guia
  1. O que é o Evolution GO
  2. Evolution GO ou Evolution API: o que muda
  3. Antes de instalar: o que esperar de uma API não oficial
  4. Como instalar o Evolution GO
  5. Ativando a licença gratuita
  6. Criando a instância e conectando o número
  7. Usando o Evolution GO no n8n
  8. Ideias de uso que funcionam
  9. Segurança: o painel é alvo desde o primeiro dia
  10. 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

  1. No painel, vá em Instâncias e crie uma nova.
  2. O nome aceita só letras, números e hífen, sem espaço. Token e proxy são opcionais.
  3. Clique em conectar e informe o número completo, com o DDI (55 para o Brasil).
  4. 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.

  1. 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.
  2. 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).
  3. 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.