Aprenda como configurar Evolution API no n8n com tokens, webhooks e teste de envio de forma simples e didática. Este guia passo a passo vai ajudar você, iniciante ou entusiasta da automação, a integrar o WhatsApp ao seu fluxo de trabalho usando o n8n e a Evolution API.
A automação é uma das maiores tendências para empresas que desejam escalar operações e ser mais eficientes. Uma das formas mais práticas de implementar automações de mensagens, especialmente no WhatsApp, é utilizando o n8n com a Evolution API. Este artigo é um passo a passo para quem está começando: aqui você vai aprender desde o conceito da Evolution API e sua relação com o n8n, até como obter e configurar os tokens, criar webhooks e realizar testes de envio práticos.
Se você já ouviu falar em integrar Evolution API ao n8n, mas ficou perdido sobre como fazer isso, acompanhe este guia para chegar ao final com fluxos funcionando e possibilidade de automatizar o WhatsApp, seja para notificações, vendas, atendimento ou qualquer outro processo automatizável.
O que é Evolution API e como funciona com o n8n?
A Evolution API é uma solução robusta voltada para automação de mensagens no WhatsApp. Ela permite interagir de maneira programática com a plataforma, realizando tarefas como disparo de mensagens, coleta de conversas e integração com outras ferramentas por meio de requisições HTTP e webhooks.
No contexto do n8n, a Evolution API abre portas para que seus fluxos de automação possam enviar e receber mensagens pelo WhatsApp de maneira totalmente personalizável. Funciona assim: você conecta seu fluxo do n8n à Evolution API, define eventos (como recebimento de novas mensagens) para disparar automações e utiliza tokens de autenticação para garantir a segurança na conexão.
Exemplo prático:
- Seu cliente envia uma mensagem no WhatsApp.
- A Evolution API recebe essa mensagem e aciona um webhook configurado no n8n.
- O n8n processa essa informação (pode puxar dados em outras ferramentas, consultar banco de dados, etc.) e responde automaticamente para o cliente direto no WhatsApp.
Essa integração permite não só centralizar as comunicações, mas automatizar processos, gerar relatórios e até acionar fluxos de vendas ou atendimento sem a necessidade de scripts complexos. Para o iniciante, o principal diferencial é permitir toda a configuração de maneira visual e sem código, bastando montar o fluxo, configurar os tokens e conectar os webhooks.
🤖 Quer dominar n8n e automações inteligentes?
Se você gostou da ideia de integrar APIs e automatizar tarefas no n8n, vale muito a pena conferir a Formação Agentes de IA da Hora de Codar. É um programa super prático, direto ao ponto e pensado para quem quer criar fluxos reais, integrando n8n com IA, WhatsApp, APIs e muito mais – mesmo sem programação.
O treinamento aborda desde o básico até as aplicações avançadas de agentes, te preparando para o mercado de automações, inclusive com exemplos prontos, templates exclusivos e acesso vitalício. Já são mais de 8 mil alunos usando o conteúdo para criar novas fontes de renda e soluções inteligentes!
Vale conferir a página da formação, ver depoimentos e analisar a proposta. Se estiver pensando em se aprofundar em automações e n8n, essa é sem dúvida uma das melhores opções do mercado.
Acesse: Conheça a Formação Agentes de IA
Pré-requisitos e primeiros passos para a integração
Antes de iniciar a integração entre a Evolution API e o n8n, é importante garantir que alguns pré-requisitos estejam atendidos para evitar obstáculos no processo:
- Conta ativa na Evolution API: Você precisa ter uma conta válida e acesso ao painel da Evolution API para obter tokens de autenticação e configurar webhooks.
- Instância do n8n: Você pode rodar o n8n localmente, em serviços online ou optar por uma hospedagem mais robusta, como a Hostinger, para garantir estabilidade e disponibilidade contínua.
- Conhecimentos básicos do n8n: Familiarize-se com a interface visual, criação de workflows (fluxos) e uso de nós (nodes) como HTTP Request, Webhook e Set.
- Postman ou ferramenta similar (opcional): Útil para testar os endpoints da API e simular requisições antes de colocar no fluxo do n8n.
Passos iniciais:
- Realize o login no painel da Evolution API para obter suas credenciais.
- Tenha o endereço e as credenciais do seu ambiente n8n à mão.
- Planeje o fluxo: defina qual evento no WhatsApp vai acionar o n8n e qual será a resposta automatizada.
Dica importante: Para projetos profissionais, recomenda-se uma VPS como a da Hostinger, pois roda o n8n 24/7, libera acesso a nodes customizados e oferece total escalabilidade.
Esses primeiros passos vão te preparar para a etapa fundamental: obter e configurar os tokens de autenticação.
Vídeo sugerido: Crie o seu primeiro Agente de IA – Tutorial completo n8n
Para visualizar o funcionamento do n8n na prática e aprender a criar seu próprio fluxo automatizado, sugerimos o vídeo “Crie o seu primeiro Agente de IA – Tutorial completo n8n”. Nele, você acompanha o passo a passo de integração, criação de fluxos e pode avançar ainda mais na automação usando n8n:
Assista agora e eleve sua automação ao próximo nível!
Como obter e configurar tokens da Evolution API no n8n
Os tokens de autenticação garantem que apenas usuários autorizados possam usar os recursos da Evolution API em conjunto com o n8n. Seguindo o passo a passo, você não terá dificuldades:
- Gerando e localizando o token:
- Acesse o painel da Evolution API;
- Localize na área de integrações a opção para gerar ou visualizar seus tokens (geralmente chamado de API Token ou Access Token);
- Copie o token, pois ele será utilizado nas requisições HTTP.
- Configurando o token no n8n:
- No n8n, crie um novo workflow ou edite um fluxo já existente.
- Adicione um node do tipo “HTTP Request” para realizar chamadas à Evolution API.
- No campo de autenticação, preencha o token gerado anteriormente (geralmente como header Authorization ou Bearer Token).
- Boas práticas:
- Armazene seus tokens em variáveis de ambiente ou no gerenciamento de credenciais do n8n para facilitar atualizações e manter a segurança.
- Nunca compartilhe ou exponha tokens publicamente.
Pronto! Agora o n8n está autenticado para interagir com a Evolution API. Os tokens são a chave para a comunicação segura e confiável entre as duas plataformas.
Criando e conectando webhooks para WhatsApp no n8n
O próximo passo prático é a criação e integração de webhooks, que são responsáveis por receber eventos em tempo real do WhatsApp através da Evolution API e transformá-los em gatilhos automáticos no n8n.
Como proceder:
- Crie um node “Webhook” no seu fluxo do n8n, defina o método como POST e copie a URL gerada.
- No painel da Evolution API, cadastre essa URL na seção designada para webhooks (geralmente com o nome webhook de recebimento de mensagens ou eventos).
- Defina quais eventos devem acionar o webhook (ex: nova mensagem recebida, mensagem entregue, etc.).
Após salvar essa configuração, sempre que o evento ocorrer no WhatsApp, a Evolution API enviará um POST para a URL do seu n8n, automaticamente acionando o seu workflow.
Exemplo:
- Mensagem recebida ➔ Evolution API aciona webhook ➔ Node Webhook do n8n processa ➔ Fluxo continua (ex: responde cliente, consulta sistema, etc.).
Lembre-se: Teste com envios reais ou utilize ferramentas que simulem POSTs para garantir que o n8n está recebendo e processando as informações corretamente. Assim, você fecha o ciclo de comunicação entre WhatsApp, Evolution API e n8n.
💻 Precisa hospedar seu n8n com estabilidade? Conheça a VPS da Hostinger
Se você pretende levar suas automações para um nível profissional, vale conferir a VPS da Hostinger. Ela já vem com n8n pré-instalado, tem planos ótimos e permite rodar múltiplos fluxos sem limites, com desempenho estável e auxílio da inteligência artificial Kodee para te ajudar em dúvidas ou otimizações.
Além disso, com o cupom HORADECODAR você ganha desconto, e ainda pode testar a solução por 30 dias sem risco. Acesse pelo link de indicação para garantir os benefícios:
👉 Conheça a VPS Hostinger para n8n
Testando o envio e automação: exemplos práticos com Evolution API
Com os tokens configurados e webhooks ativos, chegou a hora de colocar a integração para rodar na prática:
Testando o envio:
- Utilize o node “HTTP Request” no n8n para enviar uma mensagem via Evolution API.
- No corpo da requisição, utilize os dados obtidos do webhook (ex: número do cliente, conteúdo da mensagem).
- Execute o workflow no n8n e verifique se a mensagem chega corretamente ao WhatsApp do destinatário.
Exemplo de fluxo prático:
- Cliente envia “Quero comprar” via WhatsApp;
- Webhook aciona no n8n e captura o texto e número do cliente;
- Workflow faz uma consulta (pode ser em planilha, CRM, etc.) e responde com dados do produto;
- Node HTTP Request envia automaticamente a resposta ao cliente pelo WhatsApp.
Dica: Teste diferentes cenários (mensagem de erro, saudação personalizada, etc.) e adicione lógicas condicionais para um atendimento mais inteligente no seu fluxo. Assim, o teste de envio Evolution API n8n fica completo, e você garante uma automação robusta e escalável.
Como configurar a Evolution API no n8n utilizando tokens e webhooks?
Para configurar a Evolution API no n8n, comece criando um novo workflow e adicionando o node HTTP Request. No campo de autenticação, insira o token fornecido pela Evolution API. Para webhooks, adicione o node Webhook para receber notificações de eventos. Configure a URL do webhook no painel da Evolution API apontando para o endereço fornecido pelo n8n. Salve e ative o workflow para começar a receber dados.
Como gerar e utilizar tokens de autenticação com a Evolution API no n8n?
O token de autenticação é obtido diretamente no painel da Evolution API, geralmente na seção de configurações de API. Após obter o token, vá até o node HTTP Request no n8n e adicione o token no cabeçalho da requisição (campo Authorization). Dessa forma, todas as solicitações enviadas ao Evolution API serão autenticadas com segurança.
Como testar o envio de mensagens via Evolution API pelo n8n?
Após configurar o token e o webhook no n8n, crie um node adicional de HTTP Request configurando a URL do endpoint de envio de mensagens da Evolution API, incluindo o número de WhatsApp e a mensagem. Execute o workflow manualmente para testar. Se estiver bem configurado, você verá a resposta da Evolution API confirmando o envio da mensagem para o WhatsApp integrado.
Conclusão: Sua automação WhatsApp com Evolution API e n8n pronta para escalar
Integrar a Evolution API ao n8n é um caminho certeiro para quem deseja automatizar interações no WhatsApp de maneira profissional, segura e escalável. Dominando os passos de configuração de tokens, integração de webhooks e testes de envio, você já tem toda a base para transformar ideias em soluções práticas.
Não esqueça de investir em uma boa hospedagem como a VPS Hostinger para manter seus fluxos sempre ativos e, se quiser se aprofundar, explore cursos como a Formação Agentes de IA da Hora de Codar, que acelera sua curva de aprendizado e abre portas para novas oportunidades no universo das automações.
Agora é hora de colocar as dicas em prática, testar os fluxos e aproveitar todo o potencial das automações no seu negócio!