Ajuda Abrir chamado Fale conosco Entrar

n8n + Evolution API na VPS: primeiro acesso e como ligar o WhatsApp ao n8n

Aplicativos na VPSAtualizado em

Este kit junta duas ferramentas na mesma VPS: o n8n, para montar automações, e a Evolution API, que conecta o WhatsApp. Com os dois, você cria fluxos como responder mensagens automaticamente, avisar clientes pelo WhatsApp quando algo acontece no seu sistema ou levar as conversas para uma planilha ou CRM.

O que vale para todos os aplicativos (SSH, log, reiniciar) está no artigo Sua VPS com aplicativo: dados de acesso, onde fica cada coisa, ver o log, reiniciar o app.

O que vem no e-mail

n8n https://n8n.SEU-IP.yhostbr.online, com o e-mail do seu cadastro na yHost e a senha do n8n
Painel da Evolution https://evo.SEU-IP.yhostbr.online/manager
URL da API da Evolution https://evo.SEU-IP.yhostbr.online
API key da Evolution a chave de acesso da Evolution (guarde como se fosse uma senha)

Nos endereços, SEU-IP é o IP da VPS com traços no lugar dos pontos.

Primeiro acesso

  • n8n: abra o endereço do n8n e entre com o e-mail e a senha. O passo a passo completo, inclusive como trocar a senha, está no artigo n8n na VPS.
  • Evolution API: abra o painel da Evolution e entre com a URL da API e a API key. A tela abre em inglês: depois de entrar, escolha português no seletor de idioma do topo do painel. Os nomes do painel neste artigo estão em português. O passo a passo, inclusive como conectar o WhatsApp e trocar a chave, está no artigo Evolution API na VPS.

Comece conectando o WhatsApp no painel da Evolution. Depois ligue os dois apps como mostrado abaixo.

Enviar mensagens de WhatsApp pelo n8n

No n8n, o envio é feito pelo nó HTTP Request, chamando a Evolution API:

  1. No seu workflow, clique em +, procure HTTP Request e adicione o nó.
  2. Em Method, escolha POST.
  3. Em URL, coloque https://evo.SEU-IP.yhostbr.online/message/sendText/NOME-DA-INSTANCIA, trocando NOME-DA-INSTANCIA pelo nome que você deu à instância no painel da Evolution.
  4. Ligue Send Headers e preencha um cabeçalho: em Name, escreva apikey; em Value, cole a API key da Evolution.
  5. Ligue Send Body, deixe Body Content Type em JSON, escolha Using JSON em Specify Body e cole no campo JSON: 
    {
  "number": "5511999999999",
  "text": "Olá! Esta mensagem saiu do n8n."
}
  6. Troque o número pelo de destino: só dígitos, começando com 55 (Brasil) e o DDD.
  7. Clique em Execute step para testar. A mensagem sai pelo WhatsApp conectado na instância.

Receber as mensagens do WhatsApp no n8n

Para o n8n reagir a cada mensagem que chega, a Evolution avisa o n8n por um webhook:

  1. No n8n, crie um workflow e adicione o nó Webhook como gatilho.
  2. No nó, troque o HTTP Method para POST, porque a Evolution envia os avisos por POST.
  3. Copie a Production URL do nó e publique o workflow (botão Publish).
  4. No painel da Evolution, abra a instância e vá em Eventos > Webhook.
  5. Ligue Ativo, cole a Production URL no campo URL e, em Eventos, marque MESSAGES_UPSERT (mensagens novas).
  6. Clique em Salvar. Aparece "Webhook aplicado com sucesso".

A cada mensagem nova, o n8n roda o workflow com os dados da mensagem. Para ver o que chegou, abra a aba Executions do n8n.

Enquanto você monta o workflow, pode usar a Test URL no lugar da Production URL: clique em Listen for test event e os dados da próxima mensagem aparecem na tela. Quando terminar, volte o webhook da Evolution para a Production URL.

As mensagens que você mesmo manda pelo celular também chegam ao webhook. Se o seu workflow responde sozinho, filtre essas mensagens para ele não ficar respondendo a si mesmo.

Cuidados com o WhatsApp

  • A Evolution API conecta o WhatsApp do mesmo jeito que o WhatsApp Web, como um dispositivo conectado ao seu celular. Não é a API oficial do WhatsApp para empresas.
  • Evite mensagens em massa e mensagens para quem não pediu. O WhatsApp pode bloquear números que fazem isso. Cuidado especial com automações que mandam mensagens sozinhas.
  • Abra o WhatsApp no celular principal pelo menos uma vez a cada 14 dias. É uma regra do WhatsApp: se o celular principal ficar mais tempo sem usar o app, os dispositivos conectados são desconectados.

Onde roda na VPS

n8n pasta /opt/yhost/n8n, containers n8n e postgres
Evolution API pasta /opt/yhost/evolution, containers api, postgres e redis
Reiniciar entre na pasta do app (cd /opt/yhost/n8n ou cd /opt/yhost/evolution) e use docker compose restart

Problemas comuns

A página não abre logo depois da criação

A instalação leva alguns minutos depois que a VPS liga. Espere uns 10 minutos e tente de novo numa janela anônima. Para acompanhar, veja o log da instalação pelo SSH: tail -n 30 /var/log/yhost-app.log.

O navegador avisa que a conexão não é segura

O certificado HTTPS ainda não saiu. Ele costuma sair poucos minutos depois da instalação e, se o endereço da VPS demorou a ficar pronto, o sistema tenta de novo sozinho a cada 10 minutos. Espere e recarregue a página. Enquanto o aviso aparecer, não digite senhas nem a chave. Se o aviso continuar depois de 1 hora, abra um chamado.

O n8n recebe erro 401 da Evolution

A API key no cabeçalho apikey está errada ou foi trocada. Confira a chave em /opt/yhost/evolution/.env, na linha EVO_KEY.

O n8n não recebe as mensagens

Confira, nesta ordem: o workflow está publicado; o nó Webhook está com HTTP Method POST; no painel da Evolution, o webhook da instância está Ativo, com a Production URL e o evento MESSAGES_UPSERT marcado; e a instância aparece como Conectado.

O envio dá erro 400

Confira o JSON (os campos number e text) e o número: só dígitos, com 55 e o DDD. Confira também se o nome da instância no fim da URL está igual ao do painel da Evolution.

Precisa de ajuda?

Abra um chamado em https://yhost.com.br/painel/suporte. Informe o IP da VPS e o que aconteceu. Se tiver uma mensagem de erro, mande um print.

Ainda com dúvida? A nossa equipe ajuda pelo chamado.

Abrir chamado