Como redirecionar mensagens do Chatwoot para WhatsApp com Evolution API e n8n (incluindo mídia)

Aprenda, de forma prática e acessível, como redirecionar mensagens do Chatwoot para o WhatsApp usando Evolution API e n8n, incluindo o envio automático de mídia. Guia essencial para quem busca automatização de atendimento com integração de ferramentas modernas.

Uma imagem sobre Redirecionar Chatwoot para WhatsApp com Evolution API e n8n

Automatização é a palavra-chave no relacionamento moderno com clientes. Com a ascensão de plataformas como Chatwoot, WhatsApp e o poder das integrações via Evolution API e n8n, ficou muito mais prático oferecer uma experiência fluida, centralizada e até surpreender o cliente com respostas rápidas e personalizadas. Neste tutorial, você aprenderá, passo a passo e de forma descomplicada, a redirecionar mensagens do Chatwoot diretamente para o WhatsApp, inclusive anexando mídias como imagens, áudios e documentos. Tudo isso aproveitando o potencial do n8n para criar fluxos automatizados e do Evolution API para facilitar a comunicação entre sistemas.

Se você está começando agora em integrações e automações, fique tranquilo: este artigo vai abordar desde o conceito das ferramentas até a aplicação prática, ideal para quem quer sair do básico e já entregar soluções reais dentro das empresas. Vamos nessa?

Entendendo as ferramentas: Chatwoot, Evolution API e n8n

Antes de mergulhar na prática, é fundamental entender o papel de cada ferramenta neste processo de integração:


  • Chatwoot: é uma plataforma open source para atendimento multicanal, capaz de centralizar conversas de diversos canais (WhatsApp, e-mail, redes sociais, etc). Um grande diferencial é a possibilidade de conexão via APIs e webhooks, facilitando integrações com outras plataformas.



  • Evolution API: trata-se de uma API de gateway que facilita a comunicação com o WhatsApp (Business ou não). Com ela, conseguimos enviar e receber mensagens, inclusive mídia, de forma programática. É o elo entre suas fontes de mensagens (como Chatwoot) e o WhatsApp.



  • n8n: é uma plataforma de automação de fluxos. Ele permite criar workflows visuais — ou seja, você monta os passos do processo de automação arrastando e configurando “nós” (nodes). No contexto deste artigo, o n8n vai intermediar a conversa entre Chatwoot e Evolution API, automatizando o repasse de mensagens e arquivos.


Essas três ferramentas, quando interligadas, formam um sistema capaz de automatizar e escalar o atendimento, reduzindo tarefas repetitivas e melhorando a experiência do cliente. Se você é iniciante, experimente explorar cada uma individualmente antes de partir para a integração — e use a documentação de cada uma como aliada. Integrar Chatwoot Evolution API mídia via n8n nunca foi tão acessível.

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

Aprenda automação de verdade: Formação Agentes de IA

Se você gostou da ideia de conectar ferramentas como Chatwoot, WhatsApp, Evolution API e n8n sem precisar saber programar, vale MUITO a pena conhecer a Formação Agentes de IA da Hora de Codar. Ela mostra, do absoluto zero, como criar automações profissionais, agentes inteligentes e integrações de verdade, usando n8n e muita IA – tudo de forma prática e com projetos reais.

O melhor é que dá para aplicar o aprendizado imediatamente em empresas ou até oferecer como serviço! A formação já tem mais de 8.000 alunos e foco total em praticidade. Ficou curioso? Veja mais detalhes sobre o curso e como o mercado está crescendo rápido para quem domina n8n e IA:

Conheça a Formação Agentes de IA

Treinamento completo em n8n do básico ao avançado

Preparando o ambiente e configurando as integrações

O primeiro passo para redirecionar mensagens do Chatwoot para WhatsApp é preparar o ambiente de automação, conectando todas as ferramentas de forma eficiente.

1. Instalação e acesso ao n8n
O n8n pode ser hospedado localmente ou em servidores na nuvem. Usuários iniciantes podem se beneficiar de soluções que oferecem instalação simplificada — uma excelente alternativa é utilizar uma VPS (Servidor Privado Virtual) com o n8n já pré-instalado, como a da Hostinger.

2. Criando integrações no Chatwoot

  • No painel do Chatwoot, acesse as configurações de webhooks e crie um novo webhook para eventos de mensagens recebidas.
  • O objetivo aqui é fazer com que, sempre que uma nova mensagem (texto ou mídia) chegar, ela seja enviada para um endpoint (um endereço de internet) onde o n8n irá captar essa informação e iniciar o fluxo de automação.

3. Obtendo credenciais da Evolution API

  • O Evolution API normalmente exige um token de autenticação e a identificação do seu número de WhatsApp.
  • Tenha esses dados à mão para configurar no n8n e garantir que todas as mensagens sejam entregues de modo seguro e autenticado.

4. Checando permissões e formatos de mídia

  • Verifique se tanto o Chatwoot quanto seu plano e implementação do WhatsApp via Evolution API têm suporte para mídias (imagens, áudios, PDFs).

Com o ambiente preparado e as integrações básicas feitas, você já consegue visualizar a ponte entre Chatwoot e WhatsApp para mensagens, pronta para ser automatizada usando o n8n.

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:

Configurando a Evolution API para redirecionamento de mensagens e mídia

A etapa de configuração da Evolution API é fundamental para garantir que todas as mensagens, incluindo mídias, fluam do Chatwoot até o WhatsApp sem travas.

Passos essenciais para configurar:

  • Acesse o painel de gerenciamento da Evolution API e confirme que o seu número do WhatsApp está devidamente conectado e autenticado.
  • Obtenha os detalhes da API: token, endpoints de envio de mensagens e de envio de mídia. Anote essas URLs e dados, pois você vai precisar deles ao configurar o workflow do n8n.

Para mensagens de texto simples:

  • Use o endpoint padrão de envio de mensagem, geralmente aceitando métodos POST com campos como número de destino, conteúdo da mensagem e token.

Para envio de mídia:

  • A maioria dos gateways, inclusive a Evolution API, exige um endpoint separado para enviar arquivos.
  • Os campos comuns incluem: número do destinatário, URL do arquivo de mídia (ou upload direto, dependendo da API), legenda (opcional), tipo de mídia (imagem, áudio, documento) e autenticação.

Dicas importantes para iniciante:

  • Sempre consulte a documentação oficial da Evolution API para exemplos práticos de chamadas de envio de mídia.
  • Teste o envio de mensagens e mídias diretamente pelo painel da API antes de automatizar com o n8n. Isso ajuda a garantir que tudo está funcionando corretamente.

Esse cuidado inicial garante que, ao integrar com o n8n, o redirecionamento de mensagens Chatwoot Evolution API mídia ocorra de forma natural, sem gargalos ou perdas de informação.

Criando workflows no n8n para automatização e envio de mídia

Com o ambiente configurado, chega a etapa mais divertida: construir o workflow de automação no n8n para automatizar o WhatsApp Chatwoot n8n — incluindo suporte total para mídia!

Fluxo básico no n8n:

  1. Webhook (Trigger):
  • Adicione um node do tipo Webhook no início do seu fluxo.
  • Configure a URL gerada neste node no webhook do Chatwoot (como destino de eventos de mensagens). Assim, toda mensagem recebida dispara o fluxo automaticamente.
  1. Tratamento da mensagem:
  • Use um node do tipo Function/JavaScript ou Set para identificar e separar mensagens de texto das de mídia (cheque os campos do JSON recebido).
  • Caso seja mídia, pegue o link de mídia (normalmente disponível na estrutura de mensagem do Chatwoot) e prepare para o envio via Evolution API.
  1. Envio via Evolution API:
  • Para texto, adicione um node HTTP Request com os dados necessários para envio simples.
  • Para mídia, configure outro node HTTP que faça o upload ou envie o link direto para o endpoint da Evolution API, sempre preenchendo os campos de autenticação, tipo de mídia e legenda se necessário.

Dicas para facilitar a criação do fluxo:

  • Teste cada etapa separadamente usando exemplos de payloads.
  • Utilize Logs para registrar os retornos de cada node e detectar rapidamente eventuais erros.
  • Documente seu fluxo para futuras manutenções!

Exemplo de aplicação: Você pode automatizar o envio de uma mensagem de boas-vindas no WhatsApp quando um cliente inicia uma conversa no Chatwoot, ou encaminhar imagens e áudios automaticamente para o WhatsApp de um atendente.

A automação de envio de mídia Chatwoot WhatsApp n8n abre um leque de oportunidades para facilitar rotinas e ganhar produtividade.

Hospedagem prática para n8n? A Hostinger resolve!

Se você quer subir o n8n com segurança, rapidez e zero dor de cabeça, recomendo testar a VPS Hostinger. Lá você encontra planos específicos para hospedar o n8n (já com instalação automática), controle total do ambiente, performance estável e suporte 24/7. Dá para experimentar, escalar recursos conforme sua demanda e até tem reembolso em 30 dias se não gostar. Use o cupom HORADECODAR para garantir desconto exclusivo nos planos:

Veja VPS Hostinger para n8n aqui

Hostinger A melhor VPS para seu n8n

Testando, validando e ajustando o fluxo de integração

Agora que seu fluxo está montado, é hora de testar, validar e refinar o processo para garantir robustez e confiabilidade na integração.

1. Teste inicial:

  • Envie mensagens de texto e diferentes tipos de mídia para o Chatwoot e veja se elas chegam corretamente ao WhatsApp.
  • Utilize ferramentas de monitoramento do n8n para acompanhar o processamento de cada etapa do fluxo.

2. Validação de mídia e arquivos:

  • Teste imagens, áudios e documentos. Confirme se os formatos são suportados e se a qualidade da mídia é mantida.
  • Observe eventuais limitações de tamanho de arquivo impostas na Evolution API ou no WhatsApp.

3. Ajustes finos:

  • Se algum envio falhar, use os dados de retorno dos nodes HTTP do n8n para entender o motivo (erros de autenticação, formatos não aceitos, etc).
  • Implemente notificações de erro ou logs adicionais para monitorar falhas futuras.

4. Sugestão para evolução:

  • Automatize mensagens de confirmação para alertar os operadores caso algum envio não seja concluído.
  • Crie fluxos separados para diferentes tipos de mensagens, facilitando a expansão e manutenção futura.

Com o processo validado, você terá uma integração automatizada, escalável e fácil de gerenciar, elevando o padrão do atendimento automatizado na sua empresa.

É possível redirecionar mensagens do Chatwoot para o WhatsApp, incluindo mídias como imagens e vídeos, utilizando Evolution API e n8n?

Sim, é possível redirecionar mensagens textuais e mídias do Chatwoot para o WhatsApp usando a Evolution API junto com o n8n. A integração permite capturar mensagens recebidas no Chatwoot, processá-las no n8n e enviá-las automaticamente para o contato correspondente no WhatsApp, incluindo anexos de mídia (imagens, vídeos, áudios ou documentos).

Quais são os requisitos para configurar o redirecionamento de mensagens do Chatwoot para o WhatsApp com Evolution API e n8n?

Para configurar essa automação, você precisa de uma conta no Chatwoot, uma instância funcional da Evolution API (com acesso à API WhatsApp) e um servidor/nuvem rodando o n8n. Além disso, é necessário gerar tokens de acesso e realizar a autenticação entre as plataformas, além de configurar os Webhooks corretos para a captura e encaminhamento das mensagens nas rotas apropriadas do fluxo n8n.

Como garantir que mídias enviadas pelo Chatwoot não sejam perdidas ao redirecionar para o WhatsApp?

Para garantir que mídias não sejam perdidas, seu fluxo no n8n deve lidar corretamente com URLs ou anexos de mídia provenientes do Chatwoot, baixá-los (se necessário) e enviá-los via Evolution API para o WhatsApp utilizando os endpoints adequados para media do WhatsApp. Certifique-se de testar anexos nos formatos suportados e configurar o workflow para tratar possíveis erros ou incompatibilidades de formato.

Conclusão: Automatize seu atendimento e escale resultados

Automatizar o redirecionamento de mensagens do Chatwoot para WhatsApp com Evolution API e n8n, incluindo o envio de mídia, é um divisor de águas para times de atendimento e empresas que buscam eficiência. Com o passo a passo deste artigo, ficou claro que, mesmo sendo iniciante, é possível construir fluxos robustos, personalizados e fáceis de manter, automatizando desde mensagens simples até o envio de arquivos.

A integração Chatwoot Evolution API mídia via n8n destrava produtividade, elimina tarefas manuais repetitivas e, principalmente, proporciona experiências incríveis aos clientes pelo WhatsApp.

Explore ainda mais as oportunidades: aprofunde-se em automações com a Formação Agentes de IA e garanta escalabilidade com uma VPS Hostinger, aproveitando o cupom HORADECODAR. Chegou a hora de elevar o padrão de seus atendimentos!

Erros comuns ao redirecionar Chatwoot para WhatsApp (e como resolver)

Na hora de conectar tanta ferramenta, algo vai dar errado no caminho, e tudo bem, faz parte 🙂

Se liga nos tropeços mais comuns e como sair deles:

A mensagem não chega no WhatsApp:

Quase sempre é o webhook do Chatwoot apontando pra URL errada, ou o node Webhook do n8n em modo de teste em vez de produção

Abra o histórico de execuções do n8n e confira se o fluxo chegou a disparar, isso te diz na hora se o problema é antes ou depois do n8n

A mídia não vai, mas o texto vai:

Geralmente o link do arquivo que vem do Chatwoot não está sendo repassado no campo certo pro endpoint de mídia da Evolution API

Cheque no node HTTP se você está mandando pro endpoint de mídia e não pro de texto, são endereços diferentes

Erro de autenticação:

Token vencido, copiado com espaço no meio ou faltando no cabeçalho da requisição

Já me ferrei uma vez colando token com um espaço invisível no final, então revise esse detalhe antes de sair caçando bug em outro lugar

A dica de ouro é testar node por node no n8n, isolando cada etapa, assim você acha onde o fluxo quebra sem adivinhação

É possível fazer o caminho inverso, do WhatsApp de volta para o Chatwoot?

Sim, o mesmo tripé Chatwoot, Evolution API e n8n funciona nas duas direções. Assim como você captura a mensagem no Chatwoot e joga no WhatsApp, dá pra configurar um webhook na Evolution API que dispara quando chega mensagem no WhatsApp, e o n8n repassa isso de volta pra dentro do Chatwoot. Na prática você monta um fluxo espelhado: um webhook de origem, o tratamento da mensagem no n8n e a chamada final na API de destino. É assim que se constrói um atendimento realmente mão dupla, com o cliente falando pelo WhatsApp e o time respondendo centralizado no Chatwoot

Por que usar Evolution API e n8n em vez da API oficial do WhatsApp?

Aqui é sobre trade-off, não sobre bala de prata. A Evolution API funciona como um gateway que conversa com o WhatsApp de forma programática, e junto do n8n ela te dá liberdade pra montar o fluxo do seu jeito, arrastando nós e sem depender de código pesado. É um caminho muito acessível pra quem está começando em automação e quer entregar solução real rápido. A API oficial tem o seu lugar em cenários mais corporativos e regulados, então vale entender o contexto do seu projeto antes de escolher. Pra automatizar atendimento e escalar sem PC da Nasa nem burocracia, esse combo Evolution API mais n8n resolve muito bem

Leia também

Escrito por | Matheus Battisti

Matheus Battisti
Fundador da Hora de Codar

Programador apaixonado pelo mundo das tecnologias, sempre buscando em aprender e se aprofundar em linguagens, frameworks e o que mais for necessário para executar um bom trabalho. Agora tem uma nova missão que é de passar seu conhecimento adiante para formar novos programadores e especializar mais os que já são.

Subscribe
Notify of
guest

0 Comentários
Oldest
Newest Most Voted

Formações

Formação Claude Code

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

  • 120 aulas
  • 4 projetos
  • 9h 45min

Blog | Mais populares