Como Enviar Imagens e Arquivos via WhatsApp usando API do Organize.Chat com N8N
📋 Introdução
Este guia completo demonstra como implementar o envio automatizado de imagens, PDFs, vídeos e outros arquivos via
WhatsApp utilizando a API do Organize.Chat integrada com a plataforma de automação N8N.
A solução permite que você envie arquivos de forma embedada diretamente no WhatsApp, ou seja, os arquivos aparecem
incorporados na conversa ao invés de serem enviados como links para download.
💡 Vantagens desta implementação:
- Envio de múltiplos formatos de arquivo (imagens, PDFs, vídeos)
- Arquivos aparecem embedados no WhatsApp
- Integração completa com workflows N8N
- Gatilhos personalizáveis (webhooks, chats, etc.)
- Processo totalmente automatizado
⚙️ Pré-requisitos
Ferramentas Necessárias
- Conta ativa no Organize.Chat com API habilitada
- Instância N8N (cloud ou self-hosted)
- Token de acesso da API do Organize.Chat
- URLs dos arquivos que serão enviados
Conhecimentos Técnicos
- Conhecimento básico de N8N e workflows
- Compreensão de HTTP requests (GET/POST)
- Familiaridade com APIs REST
Formatos de Arquivo Suportados
🔧 Configuração do Token de Acesso
Passo 1:
Acesse sua conta no Organize.Chat e vá para o menu Perfil
Passo 2:
Clique em Configurações do Perfil
Passo 3:
Role a página para baixo até encontrar a seção Token de Acesso
Passo 4:
Copie o token existente ou clique em Reiniciar para gerar um novo
⚠️ Importante: Quando você envia mensagens usando a API, elas aparecem como se fossem enviadas pelo usuário proprietário
do token. Mantenha seu token seguro e não o compartilhe.
🔨 Configuração do Workflow N8N
Estrutura do Fluxo
O workflow N8N será composto por 3 componentes principais:
1. Gatilho (Manual, Webhook, ou outro)
2. HTTP Request para download do arquivo
3. HTTP Request para envio via API Organize.Chat
Componente 1: Configuração do Gatilho
Passo 1:
Adicione um nó de Manual Trigger ou o gatilho de sua preferência
Passo 2:
Configure uma variável fileUrl contendo a URL do arquivo a ser enviado
{ "fileUrl": "https://exemplo.com/arquivo.pdf" }
Componente 2: Download do Arquivo
Passo 1:
Adicione um nó HTTP Request
Passo 2:
Configure os seguintes parâmetros:
- Method: GET
- URL: {{$json.fileUrl}}
- Response Format: File
Componente 3: Envio via API
Passo 1:
Adicione outro nó HTTP Request
Passo 2:
Configure a URL da API:
https://api.organize.chat/v1/accounts/{ACCOUNT_ID}/messages/{MESSAGE_ID}/send
Passo 3:
Configure os parâmetros do request:
- Method: POST
- Authentication: Bearer Token
- Token: Seu token do Organize.Chat
- Body Content Type: Form-Data
Passo 4:
No campo Body Parameters, adicione:
- Parameter Name: attachments
- Parameter Type: File
- Input Data Field Name: data
📝 Diferenças importantes:
- Para texto: use Content Type application/json
- Para arquivos: use Content Type form-data
- O campo attachments deve conter os dados binários do arquivo
💡 Exemplos Práticos
Exemplo 1: Enviando uma Imagem
// Configuração do gatilho { "fileUrl": "https://exemplo.com/relatorio-mensal.png", "accountId": "123456", "messageId":
"MSG001" } // HTTP Request - Download Method: GET URL: {{$json.fileUrl}} Response Format: File // HTTP Request - Envio
API Method: POST URL: https://api.organize.chat/v1/accounts/{{$json.accountId}}/messages/{{$json.messageId}}/send
Content-Type: multipart/form-data Authorization: Bearer SEU_TOKEN_AQUI Body: - attachments: [arquivo binário baixado]
Exemplo 2: Enviando PDF via Webhook
// Webhook recebe dados { "client_name": "João Silva", "pdf_url":
"https://storage.exemplo.com/contratos/contrato-123.pdf", "phone": "5511999999999" } // Fluxo processa e envia arquivo
// O PDF será enviado como anexo no WhatsApp
⚙️ Baixe um fluxo do N8N de exemplo
Você pode baixar gratuitamente para o seu N8N, fazer adaptações e inserir o token do Organize.Chat
Baixar
🔍 Troubleshooting Comum
Problema: "Token inválido ou expirado"
Solução:
- Verifique se o token foi copiado corretamente
- Gere um novo token nas configurações do perfil
- Certifique-se de usar o formato Bearer TOKEN
Problema: "Arquivo não foi enviado"
Possíveis causas:
- Content-Type incorreto: Use multipart/form-data
- Campo de dados: Certifique-se que o campo data contém o arquivo binário
- URL inacessível: Verifique se a URL do arquivo está pública
- Tamanho do arquivo: WhatsApp tem limites por tipo de arquivo
Problema: "Arquivo aparece como link ao invés de embedado"
Verificações:
- Confirme que está usando form-data e não JSON
- O arquivo deve ser enviado no campo attachments
- Alguns tipos de arquivo podem não suportar embed
Problema: "Timeout na requisição"
Soluções:
- Aumente o timeout do nó HTTP Request para arquivos grandes
- Verifique a velocidade de download da URL fonte
- Considere otimizar o tamanho dos arquivos
⚠️ Limites importantes:
- Imagens: Máximo 16MB
- Vídeos: Máximo 64MB
- Documentos: Máximo 100MB
- Áudio: Máximo 16MB
✅ Melhores Práticas
Segurança
- Nunca compartilhe seu token de acesso
- Use variáveis de ambiente no N8N para armazenar tokens
- Rotacione tokens periodicamente para maior segurança
- Monitore o uso da API para detectar atividades suspeitas
Performance
- Otimize imagens antes do envio para reduzir tempo de processamento
- Use CDNs para hospedar arquivos quando possível
- Implemente retry logic para requests que podem falhar
- Configure timeouts apropriados baseados no tamanho dos arquivos
Organização do Workflow
- Use nomes descritivos para os nós do N8N
- Adicione comentários explicando a lógica complexa
- Teste com arquivos pequenos antes de processar arquivos grandes
- Implemente logs para rastreamento de erros
Monitoramento
- Configure alertas para falhas no workflow
- Monitore taxa de sucesso dos envios
- Acompanhe tempo de resposta da API
- Mantenha logs dos arquivos enviados
💡 Dica Pro: Crie um workflow de teste separado para validar novos tipos de arquivo antes de implementar em produção.
Isso evita problemas com clientes reais.ixe
