Descubra como turbinar sua automação enviando imagens, PDFs e áudio pelo n8n com a Evolution API! Veja dicas essenciais, passo a passo e evite armadilhas comuns no mundo do base64. Aprenda tudo neste guia para iniciantes.

Você já imaginou automatizar o envio de imagens, PDFs e áudios de forma simples através do n8n? Integrando o n8n à Evolution API é possível criar fluxos inteligentes que enviam mídias automaticamente, ampliando o potencial das suas automações para WhatsApp, atendimento ao cliente e muito mais.

Este guia prático vai ensinar, desde o básico, como enviar mídia pelo n8n usando Evolution API, com dicas preciosas para os formatos mais comuns — imagem, PDF e áudio usando base64. Aqui você entenderá o conceito, verá exemplos reais e saberá como fugir dos erros que atrasam seu projeto. Vamos lá?

O que é Evolution API e como funciona no n8n

A Evolution API é uma solução bastante utilizada para integrar e automatizar o envio de mensagens e mídias, principalmente utilizando o WhatsApp. Ela oferece diversas funcionalidades que ampliam os recursos do n8n, uma ferramenta de automação visual com foco em flexibilidade e integração de sistemas.

Quando unimos Evolution API e n8n, tornamos possível criar fluxos automáticos para enviar imagens, PDFs, áudios e outros arquivos a partir de eventos, requisições ou interações com bases de dados. O papel da Evolution API, nesse contexto, é receber o comando do n8n (geralmente via webhook ou requisições HTTP) e entregar a mídia ao destinatário.

No n8n, você configura credenciais e nodes HTTP Request para interagir com a Evolution API: basta usar os endpoints certos, inserir as informações do arquivo e definir detalhes como número de destino e tipo de mídia. É uma solução escalável, segura e que permite customizações — perfeita para atendimento, bots e notificações automatizadas.

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

Aprofunde seus conhecimentos com a Formação Agentes de IA

Se você gostou desse guia e quer dominar a criação de fluxos profissionais, recomendo conhecer a Formação Agentes de IA. Com aulas do básico ao avançado, você aprende na prática a usar o n8n e construir agentes de IA mesmo sem saber programar. O curso é perfeito para quem deseja criar automações robustas, integrar APIs (como a Evolution) e ainda montar um portfólio para vender serviços ou atuar como freelancer.

A comunidade é super ativa, tem material atualizado e suporte constante. Mais de 8.100 alunos já estão automatizando com IA e n8n!

Vale a pena conferir: Veja a formação e os projetos

Passo a passo para configurar o n8n com Evolution API

Para começar a integração do n8n com a Evolution API, siga este passo a passo fácil:

1. Crie uma conta na Evolution API: após se registrar, obtenha a sua chave de API (o token de autenticação).
2. No n8n, instale e configure: se ainda não tem o n8n rodando, instale localmente ou em um servidor VPS (como da Hostinger, que recomendamos por praticidade e desempenho). Depois, crie um novo workflow no painel.
3. Adicione um node HTTP Request: configure para fazer uma chamada POST ao endpoint de envio de mídia da Evolution API (geralmente: /send-media ou similar).
4. Informe os dados do arquivo: no body do node HTTP Request, inclua dados como o número do recipiente, tipo de mídia, arquivo em base64 e o token de autenticação.
5. Faça um teste: envie uma imagem ou arquivo para conferir se a automação funciona. Verifique o retorno da API e valide se o arquivo chegou corretamente.

Se preferir, pode usar triggers para disparar o envio em resposta a eventos (ex: nova linha em uma planilha ou pedido aprovado). Cada passo pode ser adaptado ao seu fluxo, facilitando para quem está começando.

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:

Como enviar imagem, PDF e áudio pelo n8n usando Evolution API

Cada tipo de mídia exige pequena variação na configuração do HTTP Request dentro do n8n, veja como enviar cada formato:

Enviar imagem Evolution API n8n:

• Use o endpoint de envio de mídia.
• No campo ‘type’ defina como ‘image’.
• Inclua o arquivo em base64.
• O destinatário recebe a imagem normalmente.

Enviar PDF n8n Evolution API:

• O processo é quase igual ao de imagem, mas o ‘type’ deve ser ‘document’ ou ‘pdf’, dependendo da API.
• O arquivo convertido para base64 e enviado no body do request.

Enviar áudio base64 n8n Evolution API:

• No ‘type’, use ‘audio’.
• O áudio precisa necessariamente estar em base64 (use ferramentas para converter .mp3, .wav, etc.).

Exemplo básico de JSON para envio:
{
“to”: “5511999999999”,
“type”: “image”,
“fileName”: “exemplo.jpg”,
“base64”: “”,
“token”: “”
}

Lembre-se sempre de respeitar o formato exigido pelo endpoint. Com isso, você automatiza facilmente tarefas como envio de comprovantes, tickets, áudios de confirmação, etc.

Cuidados com o envio de arquivos em base64

O uso de base64 é comum para trafegar arquivos em APIs como a Evolution. No entanto, é essencial tomar alguns cuidados:

• Tamanho dos arquivos: arquivos muito grandes podem gerar erros ou travar o fluxo. Verifique o limite de tamanho suportado pela Evolution API para evitar falhas.
• Conversão correta: certifique-se de que a conversão do arquivo para base64 está correta. Usar online converters ou nodes no n8n pode facilitar esse passo. Erros na codificação costumam resultar em arquivos corrompidos.
• Limpeza de caracteres estranhos: no base64, espaços extras ou quebras de linha podem invalidar o arquivo.
• Segurança: não trafegue dados sensíveis sem criptografia adicional, se necessário.

Para evitar problemas constantes:

• Sempre valide o arquivo convertido antes de testar no fluxo.
• Use funções de limpeza para o resultado do base64.
• Configure alertas no n8n para detectar falhas automáticas.

Esses cuidados garantem um fluxo estável e seguro para seu envio de mídias.

Hospede seu n8n de forma fácil e estável com a Hostinger

Se você procura uma hospedagem confiável para rodar automações com n8n, eu recomendo a VPS da Hostinger. É fácil de instalar, os planos são acessíveis e a escalabilidade é ótima para quem está começando.

Você ainda consegue vantagens únicas: instalação do n8n automática, controle total do seu ambiente, uptime garantido e suporte ágil. Sem falar que dá para escalar recursos conforme seu projeto cresce.

Testa lá usando o cupom HORADECODAR e confere todos os planos com desconto aqui: https://www.hostinger.com.br/horadecodar

Dicas, erros comuns e melhores práticas para automação

Automatizar o envio de mídia pelo n8n com Evolution API é simples, mas alguns detalhes podem salvar seu projeto. Confira abaixo as principais dicas e alertas para quem está começando:

Dicas práticas:

• Conheça bem a documentação da Evolution API.
• Use variáveis dinâmicas para personalizar mensagens e nomes de arquivos.
• Evite salvar arquivos pesados no n8n; sempre utilize URLs temporárias, quando possível.
• Faça logs detalhados, especialmente para capturar respostas de erro.

Erros comuns:

• Token da API inválido ou expirado.
• Falhas na conversão de arquivo para base64.
• Formatação incorreta do JSON enviado.
• Superar o limite de envio permitido pela API.

Melhores práticas:

• Tenha fluxos de retry automático para arquivos que não forem entregues.
• Organize seus nodes para fácil manutenção (nomes e comentários ajudam muito).
• Realize testes periódicos para identificar gargalos, especialmente com arquivos grandes ou múltiplos envios simultâneos.

Seguindo essas dicas, sua automação terá maior robustez, e você evitará as armadilhas mais comuns do processo de integração.

Como enviar uma imagem pelo n8n usando Evolution API?

Para enviar uma imagem pelo n8n usando o Evolution API, você deve configurar um workflow que utilize o nó HTTP Request para fazer uma solicitação POST para o endpoint de envio de mídia do Evolution API. Basta anexar o arquivo da imagem e seguir as instruções de autenticação fornecidas pela API.

É possível enviar arquivos PDF pelo n8n usando Evolution API?

Sim, é possível enviar arquivos PDF. O Evolution API aceita o envio de diferentes tipos de mídia, como PDF, seguindo o mesmo processo de envio de imagens, bastando apenas alterar o tipo de arquivo anexado na requisição.

Como envio um áudio pelo n8n usando a Evolution API?

Para enviar um arquivo de áudio, configure o nó HTTP Request do n8n com o método e endpoint corretos fornecidos pela Evolution API e anexe o arquivo de áudio na requisição. Certifique-se de que o formato de áudio seja compatível com o serviço.

Conclusão: Envie mídias de forma profissional e automatizada pelo n8n!

Enviar mídia pelo n8n usando Evolution API é uma solução poderosa para aumentar o nível da sua automação. O processo é bastante acessível para iniciantes: basta entender os conceitos básicos, configurar os nodes corretos e cuidar dos detalhes com base64.

Se você seguir este guia, terá mais confiança para automatizar o envio de imagens, PDFs e áudios nos seus workflows, fugindo dos problemas mais comuns e garantindo uma entrega profissional. Não se esqueça de experimentar outras integrações do n8n e praticar sempre — quanto mais você explora, mais simples e eficiente ficam suas automações.

Por que meu arquivo chega corrompido no WhatsApp?

Na maioria das vezes o problema não está na Evolution API, e sim no base64

Espaço extra, quebra de linha no meio da string ou o tipo de mídia declarado errado já bastam pra estragar o arquivo

Antes de culpar o fluxo, valide a string convertida e confira se o ‘type’ bate com o formato real do arquivo

Dá pra enviar vídeo pelo n8n usando a Evolution API?

O raciocínio é o mesmo de imagem, PDF e áudio: muda o tipo declarado e o arquivo que vai no corpo da requisição

Antes de montar o fluxo, confira na documentação da sua instância quais formatos ela aceita, pra não perder tempo testando algo que não passa

Preciso mesmo converter tudo pra base64?

Depende de como você recebe a mídia no fluxo

Se o arquivo já vem de um node anterior no n8n, muitas vezes dá pra encaminhar sem retrabalho

O base64 entra quando você precisa embutir o arquivo direto no corpo da requisição, e é aí que mora a maioria dos errinhos chatos

base64 ou URL: qual usar pra enviar mídia?

Esse é o tipo de decisão que ninguém explica e que faz diferença no seu fluxo

Enviar em base64 é prático quando o arquivo já está dentro do n8n e você quer mandar tudo numa requisição só, sem depender de um link externo

O custo é que arquivos maiores incham o corpo da requisição e a chance de erro de codificação sobe

Já apontar pra uma URL da mídia deixa a requisição leve e é mais amigável com arquivos pesados, desde que o link fique acessível na hora do envio

Regra de bolso: arquivo pequeno e gerado no próprio fluxo, base64 resolve; arquivo pesado ou que já mora numa URL estável, aponta pro link e evita dor de cabeça

Deu erro e você não sabe por onde começar? Segue a ordem

Primeiro confira a autenticação: token errado ou vencido derruba tudo antes mesmo da mídia sair

Depois olhe o JSON: uma vírgula fora do lugar ou uma aspa trocada já quebra o envio

Só então desconfie do arquivo: base64 mal convertido ou formato incompatível costuma ser o vilão final

Testar nessa sequência economiza um tempo absurdo, porque você elimina as causas mais comuns antes das mais raras