Evolution Go + Chatwoot: como integrar passo a passo

Para integrar a Evolution Go com o Chatwoot, você instala a Evolution Go no Portainer e usa um conector gratuito que eu criei, porque ela não tem integração nativa com o Chatwoot. Com o conector, você cria a conexão por dentro do Chatwoot, lê o QR Code, importa o histórico e consegue editar, excluir e encaminhar mensagens.

A Evolution Go é a nova versão da Evolution, a API não oficial de WhatsApp mais usada por quem trabalha com Chatwoot. Ela troca a biblioteca por trás da conexão e ficou bem mais leve e estável. Aqui eu mostro como instalar tudo.

Você vai ver o que mudou da Evolution antiga para a Go, o que precisa estar pronto antes, o passo a passo no Portainer e no Chatwoot, e onde estão os riscos de usar uma API não oficial.

O que é a Evolution Go e o que mudou

A Evolution é um projeto gratuito do Davidson que faz a ponte entre um número de WhatsApp e o seu sistema. A Evolution antiga usava a biblioteca Baileys. A Evolution Go usa a whatsmeow, escrita em Go.

Isso importa porque hoje existem três famílias de bibliotecas para API não oficial:

Nos últimos tempos a Baileys passou a dar muita instabilidade e perda de mensagem, e não era só na Evolution: outras APIs com Baileys tinham o mesmo problema. As APIs feitas com whatsmeow, nos meus testes, não perdem mensagem e respondem mais rápido.

Um ponto que pega muita gente: ir da Evolution antiga para a Go não é atualização. É outra stack, outros endpoints, outro funcionamento. Você faz uma instalação nova.

Por que a Evolution Go não conecta direto no Chatwoot

A Evolution antiga já vinha com conexão para Typebot, Flowise, n8n e Chatwoot. A Evolution Go é uma API crua, sem nenhum conector. Pelo que entendi do Davidson, a ideia é lançar os conectores à parte, dentro de um ecossistema próprio da Evolution, mas quando gravei o vídeo ainda não havia data.

Por isso fiz um conector. Ele é gratuito, mas roda junto com o meu projeto de módulos extras para o Chatwoot (Kanban, conexões, projetos, disparador, chat flows e configurações extras). Não dá para usar o conector sozinho. O projeto também é gratuito para instalar e usar; o código-fonte fica disponível para quem é da comunidade e quer modificar.

O que você precisa antes de começar

• Uma VPS com Portainer.
• O Chatwoot instalado. Se ainda não tem, veja como instalar o Chatwoot do zero.
• Os módulos extras instalados na versão que já traz o conector. No vídeo, gravado em abril de 2026, era a versão 1.0.2.
• Acesso ao DNS do seu domínio para criar um subdomínio.

Passo a passo: instalando a Evolution Go no Portainer

A stack completa está na página de apoio do vídeo. Você só ajusta duas coisas.

1. Gere uma chave de API. Pode ser qualquer senha forte; eu uso um gerador de chave de 32 caracteres. Essa chave é a que você vai usar para entrar no painel.
2. Crie um subdomínio apontando para o IP do seu servidor (no vídeo eu uso o Cloudflare, mas serve qualquer provedor de DNS).
3. Coloque a chave e o subdomínio na stack.
4. Confira a rede. Se você instalou o servidor seguindo os meus vídeos, já está certo. Se usou outro instalador automático, troque o nome da rede pelo que o seu servidor usa.
5. No Portainer, crie uma nova stack (por exemplo, "evolution-go"), cole o conteúdo, desative o Access Control e faça o deploy.

A stack já sobe um PostgreSQL e um Redis próprios, com o banco criado. Se você já tem os dois, pode remover esses serviços e apontar para os seus. A minha recomendação é manter PostgreSQL e Redis separados de outros projetos: gasta um pouco mais de hardware, mas se algo der errado você não perde tudo junto.

Passo a passo: conectando a Evolution Go ao Chatwoot

1. No Chatwoot, abra Configurações extras > Setup. Na versão nova dos módulos aparece a opção Evolution Go.
2. Informe a URL da Evolution Go, com https:// na frente, e o token (a chave de API que você criou). Salve.
3. Copie a stack do conector que o sistema gera nesse momento.
4. No Portainer, crie uma nova stack com esse conteúdo. O nome da stack tem que ser exatamente o nome do serviço que aparece na linha 2. Não troque.
5. Não crie subdomínio público para o conector. Ele foi feito para funcionar em localhost, por velocidade e segurança. O token e a URL do Kanban ele configura sozinho.
6. Desative o Access Control e faça o deploy.
7. Volte ao Chatwoot e clique em atualizar. Se der erro nessa segunda atualização, o conector não subiu direito.

A imagem do conector está no Docker Hub. Quando gravei, só havia a tag develop. Procure sempre a versão mais nova disponível quando for instalar.

Primeiro acesso e criação da conexão

Para conferir se a Evolution Go subiu, acesse o seu subdomínio com /manager/login no final e entre com a chave de API. No primeiro acesso ela pede para validar a licença: você informa nome e e-mail, confirma no e-mail recebido e faz login de novo. É gratuito, a validação só autoriza o uso.

Pelo painel da própria Evolution Go dá para criar instâncias e ler o QR Code, o que serve se você for usar com n8n ou outro sistema. Para o Chatwoot, crie a conexão por dentro dele:

1. Vá em Conexões > Adicionar nova conexão.
2. Escolha o provedor Evolution Go e dê um nome.
3. Defina quantos dias de histórico quer importar. Isso só funciona no momento da conexão, porque a Evolution Go manda esse evento uma única vez. Depois não dá para importar.
4. Clique em criar e leia o QR Code com o WhatsApp.

A caixa de entrada aparece no Chatwoot com as conversas importadas. Nos testes do vídeo funcionaram texto, áudio e arquivos nos dois sentidos, além de três funções que o conector já entrega: editar, excluir e encaminhar mensagens. A exclusão feita no Chatwoot apaga também no WhatsApp. Você pode criar quantas conexões quiser.

Erros comuns na instalação

• Esquecer o https:// na URL das configurações extras.
• Mudar o nome da stack do conector. Ele precisa ser idêntico ao do serviço.
• Criar subdomínio para o conector. Não precisa e não funciona assim.
• Usar uma rede diferente da do Chatwoot quando o servidor foi montado com outro instalador.
• Conectar o número antes de decidir quantos dias de histórico importar.
• Tentar migrar a Evolution antiga para a Go apenas trocando a versão da imagem.

O lado honesto: risco de bloqueio e quando ir para a API oficial

A Evolution Go é uma API não oficial. Ela conecta pelo QR Code como se fosse o WhatsApp Web, e isso vai contra os termos da Meta. Você não paga por mensagem, mas existe risco de o número ser bloqueado. O risco cresce com disparo em massa para quem não te conhece, encaminhamento para muita gente e pedido de dados sensíveis, como CPF, dentro da conversa.

Além disso, a whatsmeow é uma biblioteca de código aberto mantida pela comunidade. Ela está estável hoje, mas ninguém garante que vai continuar. Se o WhatsApp mudar algo do lado dele, todas as APIs não oficiais ficam dependentes de uma correção.

Use a Evolution Go quando o cliente quer economizar, tem volume moderado e aceita o risco. Vá para a API oficial quando o número é o principal canal de venda da empresa, quando há disparo em volume ou quando perder o número seria um prejuízo sério. Expliquei os custos no artigo sobre o preço da API oficial do WhatsApp. E, se quiser comparar com outra opção não oficial, veja como montar vários números com WAHA e Chatwoot.

Perguntas frequentes

O que é a Evolution Go?

É a nova versão da Evolution, a API não oficial e gratuita de WhatsApp criada pelo Davidson. Ela troca a biblioteca Baileys pela whatsmeow, escrita em Go, e ficou mais leve e estável.

A Evolution Go tem integração nativa com o Chatwoot?

Não. A Evolution Go é uma API crua, sem conectores. A ligação com o Chatwoot é feita por um conector gratuito da Astra Online, que roda junto com o projeto de módulos extras e não funciona sozinho.

Como migrar da Evolution API para a Evolution Go?

Não existe atualização direta. A Evolution Go é outra stack, com outros endpoints e outro funcionamento, então é preciso fazer uma instalação nova. Trocar só a versão da imagem não funciona.

A Evolution Go importa o histórico de conversas para o Chatwoot?

Sim, mas só no momento da conexão, porque a Evolution Go envia esse evento uma única vez. Defina quantos dias de histórico quer importar antes de ler o QR Code, já que depois não dá para importar.

A Evolution Go pode bloquear o meu número de WhatsApp?

Sim, existe esse risco. Ela conecta pelo QR Code como se fosse o WhatsApp Web, o que vai contra os termos da Meta, e o risco cresce com disparo em massa para desconhecidos, encaminhamento para muita gente e pedido de dados sensíveis na conversa.

Quer isso instalado e funcionando?

No AstraChat, o Chatwoot Pro da Astra Online, a conexão com a Evolution Go convive com a API oficial, Instagram e Facebook, além de Kanban, agentes de IA, disparador, flows, chat interno e ligações pelo WhatsApp. Tudo no seu servidor, com a sua marca e atendentes ilimitados.

Ele vem na Comunidade Astra Online, com código-fonte, atualizações, grupo VIP e a primeira instalação feita pelo especialista em Chatwoot Raphael Popiolek. Se preferir que eu instale e configure tudo, me chame no WhatsApp e me diga quantos números você quer conectar.