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