Como integrar n8n com Evolution API para WhatsApp: guia rápido

Como integrar n8n com Evolution API para WhatsApp e automatizar o envio de mensagens. Guia rápido para criar workflows eficientes e escalar sua comunicação no WhatsApp!

Automatizar o envio de mensagens pelo WhatsApp pode ser um divisor de águas para empresas e profissionais que desejam melhorar o relacionamento com clientes, agilizar atendimentos e escalar operações de marketing. Neste artigo, você vai descobrir como integrar n8n com Evolution API para WhatsApp de maneira simples e prática, criando fluxos automatizados sem precisar programar. Vamos abordar desde os conceitos básicos até dicas de uso no dia a dia, passando por um passo a passo detalhado para quem quer pôr a mão na massa.

Se você está buscando um tutorial integração n8n WhatsApp ou quer saber como criar um workflow n8n Evolution API, este conteúdo é para você. Prepare-se para dominar como enviar mensagens WhatsApp Evolution API, centralizar suas comunicações e tornar sua operação mais inteligente!

O que é o n8n e como ele pode automatizar o WhatsApp

O n8n é uma poderosa plataforma de automação visual, open source, que permite você criar workflows conectando diferentes ferramentas, APIs e serviços, tudo sem exigir conhecimentos avançados de programação. No contexto do WhatsApp, o n8n se destaca por possibilitar integrações com APIs externas, como a Evolution API, permitindo automatizar desde respostas rápidas a notificações de vendas, alertas, confirmações e muito mais.

Por exemplo, imagine que você quer enviar uma mensagem de boas-vindas automaticamente para todo novo contato que chega em seu sistema. Com alguns cliques no n8n, é possível criar um fluxo que detecta um novo cadastro, busca os dados do usuário e aciona a Evolution API para disparar uma mensagem personalizada via WhatsApp. Isso é só o começo: também dá para criar fluxos complexos, como pesquisa de satisfação, lembretes de consulta, follow-up de vendas, entre outros.

Principais recursos do n8n para WhatsApp:

• Criação de fluxos automatizados via interface visual drag-and-drop
• Integração com centenas de serviços e APIs
• Flexibilidade para personalizar mensagens, incluir variáveis e condições
• Possibilidade de escalabilidade, atendendo pequenas empresas ou grandes operações

Com o n8n, tarefas repetitivas e demoradas se transformam em algo automático, deixando sua equipe livre para focar no que realmente importa: o atendimento estratégico e humano.

Que tal aprender a fundo sobre automações, n8n e Agentes de IA?

Se você gostou deste passo a passo e tem interesse em criar soluções mais avançadas com n8n, vale muito a pena conhecer a Formação Agentes de IA da Hora de Codar. O curso é super prático, voltado para iniciantes (mesmo quem nunca programou antes!) e já tem mais de 8.100 alunos.

Você aprende desde o básico até a criação de agentes de IA de verdade, integrações completas com APIs, automação de vendas, CRM e muito mais. O acesso é vitalício, cheio de bônus e você ainda participa de um grupo ativo para tirar dúvidas e trocar ideias.

Se quiser entender como tudo isso pode virar renda ou um novo caminho profissional — e acompanhar as demandas do mercado de automação e IA — dê uma olhada na formação: Clique aqui para conhecer a Formação Agentes de IA

Formação Recomendada

Formação Agentes de IA

Domine a criação de Agentes de IA e Venda para Empresas

• 402 aulas
• 32 projetos
• 38h 19min

Conhecer formação

Visão geral da Evolution API para WhatsApp

A Evolution API é uma solução robusta para integração com o WhatsApp, facilitando o envio e recebimento de mensagens de maneira automatizada e escalável. Com ela, você pode conectar sistemas internos, CRMs, ERPs ou plataformas próprias diretamente ao WhatsApp, garantindo agilidade e eficiência na comunicação.

Entre os principais recursos da Evolution API, destacam-se:

• Envio e recebimento de mensagens de texto, imagens, documentos e áudios pelo WhatsApp
• Recebimento de webhooks para eventos como recebimento de mensagem, status de entrega e leitura
• Geração de relatórios e logs detalhados
• Suporte a múltiplos números e sessões

Utilizando a Evolution API em conjunto com o n8n, é possível criar automações como:

• Notificações automáticas de vendas concluídas
• Alerta de pagamento por boleto ou PIX
• Mensagens de aniversário, promoções recorrentes e lembretes personalizados

Além disso, a API é pensada para quem deseja escalar o atendimento via WhatsApp sem depender de um time grande. Basta construir os workflows certos, e toda a comunicação passa a ser gerida por automações configuradas conforme o seu negócio.

Vídeo recomendado: Como configurar n8n e WhatsApp na VPS passo a passo

Aprenda a configurar de maneira profissional uma estrutura com: Easy Panel, n8n e Evolution API, para criar automações no WhatsApp. De maneira direta ao ponto você terá o WhatsApp conectado ao n8n, pronto para integrar qualquer automação e Agente de IA, confira:

Pré-requisitos e configurações iniciais para integração

Antes de integrar o n8n à Evolution API para WhatsApp, é importante garantir que alguns pré-requisitos estejam cumpridos. Isso facilita o processo e evita contratempos.

Pré-requisitos básicos:

• Ter uma conta ativa e configurada na Evolution API, com acesso à chave de API e documentação oficial
• Instância do n8n operante (pode ser local, cloud ou em uma VPS como a Hostinger)
• Acesso ao endpoint da Evolution API a partir do n8n
• Familiaridade básica com o painel do n8n e edição de workflows

Passos recomendados para a configuração inicial:

1. Certifique-se que o seu n8n está acessível e atualizado. Se possível, use uma VPS confiável para garantir disponibilidade contínua (veja a recomendação de VPS ao final do artigo).
2. Acesse a documentação da Evolution API para entender os endpoints de envio de mensagem e webhooks.
3. Gere sua chave de API na Evolution e salve em local seguro.
4. No n8n, crie uma credencial do tipo HTTP Request para autenticar suas requisições à Evolution API.
5. Teste o envio de uma mensagem simples via API, utilizando o n8n para garantir que a integração básica está funcionando antes de criar fluxos mais complexos.

Esses passos preparam o terreno para você realizar toda a automação de WhatsApp que imaginar, sem surpresas desagradáveis no caminho.

Passo a passo: conectando o n8n à Evolution API para WhatsApp

Agora que você já conhece os conceitos e pré-requisitos, vamos ao passo a passo prático de como integrar n8n com Evolution API para WhatsApp:

1. 
   

   Configuração das Credenciais:
   No n8n, vá em “Credenciais” e adicione um novo item do tipo HTTP Request. Insira o token da Evolution API para autenticação, normalmente informando no cabeçalho (header) Authorization.

   
   
2. 
   

   Crie um Novo Workflow:
   No painel do n8n, clique em “New Workflow”. Adicione um nó do tipo “Webhook” (caso queira receber eventos) ou “Manual Trigger” para testes.

   
   
3. 
   

   Envie uma Mensagem de Teste:
   Adicione um nó “HTTP Request” após o gatilho do seu fluxo. Configure-o para realizar uma solicitação POST para o endpoint de envio da Evolution API (consulte a documentação para a URL correta). No corpo (body), inclua os dados obrigatórios: número do destinatário, mensagem e outras opções.

   
   
4. 
   

   Teste e Ajuste o Fluxo:
   Execute o workflow e verifique o retorno. Se tudo estiver correto, a mensagem chegará ao WhatsApp informado. Ajuste o fluxo conforme sua necessidade, podendo adicionar nodes de lógica (por exemplo, para personalizar a mensagem).

   
   
5. 
   

   Automatize Segundo o Seu Objetivo:
   A partir desse fluxo inicial, adicione etapas para buscar contatos do seu CRM, disparar mensagens automáticas em eventos específicos ou implementar respostas automáticas.

   
   

Dica: Use a função de logs do n8n para monitorar falhas e otimizar o workflow.

Ao seguir esses passos, você vai conseguir não só enviar mensagens WhatsApp Evolution API, mas construir automações robustas, escaláveis e eficientes para o seu negócio.

Recomendação de VPS para rodar o n8n — Hostinger

Uma dica importante para quem quer evitar dores de cabeça com disponibilidade e performance no n8n: utilize uma VPS confiável e estável. A Hostinger oferece VPS com n8n pré-instalado, planos flexíveis e excelente custo-benefício — e você ainda pode usar o cupom HORADECODAR para garantir 10% de desconto.

Entre os benefícios estão execução ilimitada de fluxos, suporte 24/7, escalabilidade fácil e ambiente totalmente amigável para quem está começando. Vale a pena conferir: Conheça a VPS Hostinger para n8n utilizando o cupom HORADECODAR para economizar!

Principais casos de uso e dicas para automatizar mensagens no WhatsApp

Automatizar o WhatsApp usando n8n e Evolution API abre um leque de possibilidades para negócios de vários segmentos. Confira alguns dos principais casos de uso:

1. Notificações e lembretes:

• Envie confirmação de pedidos, status de envio e lembre lembretes de agendamento automaticamente, reduzindo o trabalho manual da equipe.

1. Atendimento automático:

• Implemente assistentes virtuais que respondem dúvidas frequentes, fazem triagens ou coletam informações iniciais dos clientes.

1. Follow-up e engajamento:

• Realize o pós-venda, pesquisas de satisfação ou envio de promoções recorrentes para clientes cadastrados.

Dicas práticas para ir além:

• Use variáveis dinâmicas para personalizar cada mensagem (nome, data, produto, etc).
• Sempre monitore a resposta das automações para corrigir eventuais falhas rapidamente.
• Integre com sistemas internos (ERP, CRM, lojas virtuais) para automatizar ainda mais seu atendimento e vendas.
• Com o crescimento do volume, utilize o painel de logs do n8n para manter a segurança e rastreabilidade das operações.

Com criatividade, dá para criar experiências exclusivas para seu público no WhatsApp, fortalecendo o relacionamento e potencializando resultados de vendas e suporte.

Como integrar o n8n com Evolution API para WhatsApp?

Para integrar o n8n com a Evolution API para WhatsApp, basta gerar uma chave de API na sua conta Evolution, instalar o n8n em seu ambiente, adicionar um node HTTP Request, configurar o método, a URL e os headers de autenticação, e testar o fluxo enviando uma mensagem. O artigo traz um passo a passo detalhado desse processo.

Quais dados são necessários para configurar o envio de mensagens via WhatsApp no n8n?

Você precisará da URL da Evolution API, da sua chave de API, do número de telefone autorizado e do corpo da mensagem que deseja enviar. Esses dados são inseridos na configuração do node HTTP Request dentro do n8n.

É possível automatizar o envio de mensagens para múltiplos contatos usando o n8n com Evolution API para WhatsApp?

Sim, é possível. Basta configurar o fluxo no n8n para receber uma lista de contatos e usar funções ou loops para enviar mensagens individualizadas para cada número através da Evolution API. Isso permite automação de notificações, lembretes e outras interações em massa de forma prática.

Conclusão

Integrar o n8n com a Evolution API para WhatsApp é uma estratégia acessível para qualquer pessoa ou empresa que deseja modernizar e automatizar a comunicação no WhatsApp. Com poucos passos e recursos intuitivos, já é possível criar fluxos que otimizam a rotina, agilizam atendimentos e aumentam a eficiência de vendas e suporte — tudo sem precisar ser um expert em tecnologia.

Lembre-se que, além de saber como integrar n8n com Evolution API para WhatsApp, escolher boas ferramentas faz toda a diferença. Hospedar seu n8n na Hostinger garante estabilidade e flexibilidade, e investir em conhecimento com a Formação Agentes de IA abre portas para dominar de vez o universo das automações inteligentes.

Aproveite as dicas, explore os exemplos de workflow n8n Evolution API e avance passo a passo rumo a operações cada vez mais automatizadas. O futuro da comunicação está ao alcance de quem aprende a automatizar!

Antes de entrar nos recursos, a resposta curta pra quem caiu aqui procurando só isso:

Evolution API é uma API que serve de ponte entre o WhatsApp e os seus sistemas, ou seja, ela expõe rotas HTTP pra você mandar e receber mensagem por código, em vez de alguém digitar na mão

É isso que faz ela combinar tão bem com o n8n: o n8n não precisa "saber" WhatsApp, ele só precisa saber fazer uma requisição HTTP, e a Evolution cuida do resto

Se você já integrou qualquer API de terceiro na vida (pagamento, e-mail, CRM), a lógica aqui é exatamente a mesma, muda só o que tem do outro lado da linha 🙂

Erros mais comuns nessa integração (e como destravar cada um):

O fluxo ficar verde no n8n e a mensagem não chegar é o clássico aqui, então bora pelos suspeitos de sempre

A API respondeu erro de autenticação?

Quase sempre é a chave indo no lugar errado ou com nome de campo diferente do que a Evolution espera, confira o formato exato na documentação oficial antes de sair mudando o fluxo

A API respondeu OK mas ninguém recebeu nada?

Olhe a instância: se a sessão do WhatsApp caiu, a rota continua respondendo e a mensagem simplesmente não sai

Depois olhe o número do destinatário, formato de número é onde mais gente se ferra (código do país, dígito a mais, dígito a menos)

O webhook não dispara?

Se o seu n8n está rodando local, a Evolution precisa alcançar aquela URL pela internet, e localhost não é alcançável de fora

Tome cuidado com um detalhe bobo: URL de teste e URL de produção do webhook são diferentes no n8n, é muito comum configurar uma e testar a outra

Dica: antes de culpar o fluxo, abra a execução no n8n e leia o corpo da RESPOSTA da requisição, ela costuma dizer com todas as letras o que faltou

Como fazer o n8n receber mensagens, e não só enviar:

A maior parte dos tutoriais para no envio, mas é a mão CONTRÁRIA que vira atendimento de verdade

A lógica é simples: em vez do n8n chamar a Evolution, a Evolution chama o n8n toda vez que chega mensagem nova

Quem faz esse papel é o gatilho de webhook do seu fluxo, ele fica ali parado esperando a batida

Quando a mensagem cai, você tem os dados do contato e o texto dentro do fluxo, e daí pra frente é n8n normal: condição, consulta no banco, chamada de IA, o que você quiser

Depois de decidir a resposta, é o mesmo nó de requisição do passo a passo lá de cima que devolve a mensagem pro contato

É esse loop (recebe, pensa, responde) que transforma o fluxo em agente de atendimento em vez de robô de disparo

Bora testar com uma mensagem sua mesmo antes de soltar pro público? 😀

O que envelhece nessa integração (leia antes de copiar qualquer tutorial):

Essa dupla se mexe rápido, e é aí que mora a dor de cabeça

Tanto o n8n quanto a Evolution evoluem, então nomes de campo, caminhos de rota e telas do painel mudam de versão pra versão

Por isso a regra aqui é uma só: tutorial (este inclusive) serve pra você entender a LÓGICA, a documentação oficial serve pra você conferir os nomes exatos na hora de configurar

Se alguma coisa que você copiou não funcionar de primeira, a primeira checagem é a versão que você está rodando, não o passo do tutorial

E vale o cuidado de sempre: antes de atualizar sua instância no meio de uma operação viva, teste o fluxo em um ambiente separado, já vi muita automação parar por atualização feita na sexta à noite haha

Por que o fluxo do n8n executa sem erro mas a mensagem não chega no WhatsApp?

Na maioria das vezes é um destes três: a instância do WhatsApp está desconectada (a API responde normalmente mesmo assim), o número do destinatário está em formato inválido, ou a requisição foi para um ambiente diferente do que você está olhando. Abra a execução no n8n e leia o corpo da resposta da requisição, e em seguida confira se a instância continua conectada antes de mexer no fluxo.

Dá pra disparar pra uma lista grande de contatos de uma vez?

Tecnicamente sim, o fluxo aceita, mas o caminho seguro é espaçar os envios em vez de mandar tudo de um golpe, e testar antes com uma lista pequena de números seus. Além de reduzir risco pro seu número, isso facilita muito identificar qual contato falhou quando alguma coisa der errado.

Antes de entrar nos recursos, a resposta curta pra quem caiu aqui procurando só isso:

Evolution API é uma API que serve de ponte entre o WhatsApp e os seus sistemas, ou seja, ela expõe rotas HTTP pra você mandar e receber mensagem por código, em vez de alguém digitar na mão

É isso que faz ela combinar tão bem com o n8n: o n8n não precisa "saber" WhatsApp, ele só precisa saber fazer uma requisição HTTP, e a Evolution cuida do resto

Se você já integrou qualquer API de terceiro na vida (pagamento, e-mail, CRM), a lógica aqui é exatamente a mesma, muda só o que tem do outro lado da linha 🙂

Erros mais comuns nessa integração (e como destravar cada um):

O fluxo ficar verde no n8n e a mensagem não chegar é o clássico aqui, então bora pelos suspeitos de sempre

A API respondeu erro de autenticação?

Quase sempre é a chave indo no lugar errado ou com nome de campo diferente do que a Evolution espera, confira o formato exato na documentação oficial antes de sair mudando o fluxo

A API respondeu OK mas ninguém recebeu nada?

Olhe a instância: se a sessão do WhatsApp caiu, a rota continua respondendo e a mensagem simplesmente não sai

Depois olhe o número do destinatário, formato de número é onde mais gente se ferra (código do país, dígito a mais, dígito a menos)

O webhook não dispara?

Se o seu n8n está rodando local, a Evolution precisa alcançar aquela URL pela internet, e localhost não é alcançável de fora

Tome cuidado com um detalhe bobo: URL de teste e URL de produção do webhook são diferentes no n8n, é muito comum configurar uma e testar a outra

Dica: antes de culpar o fluxo, abra a execução no n8n e leia o corpo da RESPOSTA da requisição, ela costuma dizer com todas as letras o que faltou

Como fazer o n8n receber mensagens, e não só enviar:

A maior parte dos tutoriais para no envio, mas é a mão CONTRÁRIA que vira atendimento de verdade

A lógica é simples: em vez do n8n chamar a Evolution, a Evolution chama o n8n toda vez que chega mensagem nova

Quem faz esse papel é o gatilho de webhook do seu fluxo, ele fica ali parado esperando a batida

Quando a mensagem cai, você tem os dados do contato e o texto dentro do fluxo, e daí pra frente é n8n normal: condição, consulta no banco, chamada de IA, o que você quiser

Depois de decidir a resposta, é o mesmo nó de requisição do passo a passo lá de cima que devolve a mensagem pro contato

É esse loop (recebe, pensa, responde) que transforma o fluxo em agente de atendimento em vez de robô de disparo

Bora testar com uma mensagem sua mesmo antes de soltar pro público? 😀

O que envelhece nessa integração (leia antes de copiar qualquer tutorial):

Essa dupla se mexe rápido, e é aí que mora a dor de cabeça

Tanto o n8n quanto a Evolution evoluem, então nomes de campo, caminhos de rota e telas do painel mudam de versão pra versão

Por isso a regra aqui é uma só: tutorial (este inclusive) serve pra você entender a LÓGICA, a documentação oficial serve pra você conferir os nomes exatos na hora de configurar

Se alguma coisa que você copiou não funcionar de primeira, a primeira checagem é a versão que você está rodando, não o passo do tutorial

E vale o cuidado de sempre: antes de atualizar sua instância no meio de uma operação viva, teste o fluxo em um ambiente separado, já vi muita automação parar por atualização feita na sexta à noite haha

Por que o fluxo do n8n executa sem erro mas a mensagem não chega no WhatsApp?

Na maioria das vezes é um destes três: a instância do WhatsApp está desconectada (a API responde normalmente mesmo assim), o número do destinatário está em formato inválido, ou a requisição foi para um ambiente diferente do que você está olhando. Abra a execução no n8n e leia o corpo da resposta da requisição, e em seguida confira se a instância continua conectada antes de mexer no fluxo.

Dá pra disparar pra uma lista grande de contatos de uma vez?

Tecnicamente sim, o fluxo aceita, mas o caminho seguro é espaçar os envios em vez de mandar tudo de um golpe, e testar antes com uma lista pequena de números seus. Além de reduzir risco pro seu número, isso facilita muito identificar qual contato falhou quando alguma coisa der errado.