Desenvolvimento de Automação N8n para Coleta Inteligente de Documentos (Whatsapp, Box, Supabase)

Estou desenvolvendo um sistema (agente n8n) e preciso de um profissional para implementar um fluxo automatizado no *n8n*, integrado com:

* WhatsApp via Evolution API
* Supabase (PostgreSQL)
* Box (armazenamento de arquivos com antivírus)

⚠️ Importante:
Toda a infraestrutura já está pronta (API, n8n e banco).
Preciso apenas da **implementação do workflow + script do banco**.

# 🎯 Objetivo

Criar um fluxo automatizado que:

* Converse com o cliente via WhatsApp
* Identifique o protocolo pelo número do WhatsApp
* Consulte os documentos necessários daquele protocolo
* Solicite documentos automaticamente
* Receba anexos enviados pelo cliente
* Identifique corretamente qual documento foi enviado
* Salve o arquivo no Box
* Vincule corretamente ao item específico no banco


# 🚨 Regra crítica do sistema (ponto mais importante)

👉 Os documentos NÃO são fixos.
👉 Cada protocolo possui sua própria lista de documentos.

E principalmente:

❗ **NUNCA salvar documento de forma genérica**

Todo arquivo deve ser vinculado obrigatoriamente a um item específico do protocolo.

Exemplo:

* rg → vinculado ao item rg
* cpf → vinculado ao item cpf

se não for possível identificar automaticamente:

👉 o sistema deve perguntar ao cliente antes de salvar

---

# 🧠 funcionamento esperado

### fluxo:

1. Cliente envia mensagem no WhatsApp
2. N8n recebe via webhook (Evolution API)
3. Identifica o cliente pelo número
4. Busca protocolo ativo no Supabase
5. Consulta documentos pendentes
6. Solicita documentos

---

### Quando o cliente envia arquivo:

1. N8n recebe o anexo
2. Faz download do arquivo
3. Tenta identificar o tipo do documento
4. Se não identificar → pergunta ao cliente
5. Faz upload no Box
6. Salva no banco vinculado ao documento correto
7. Atualiza status para "recebido"
8. Continua o fluxo

---

# 🔧 O que precisa ser entregue

## 1. Workflow completo no n8n

* Webhook (Evolution API)
* Tratamento de mensagens (texto vs anexo)
* Download de mídia do WhatsApp
* Integração com Box (upload via API)
* Integração com Supabase (preferencialmente via REST)
* Controle de estado da conversa
* Fluxo completo de atendimento

---

## 2. Script SQL (Supabase)

Estrutura baseada em:

* protocolos (vinculado ao WhatsApp)
* documentos_protocolo (dinâmicos por protocolo)
* documentos_recebidos (vinculado corretamente ao documento)

---

## 3. Lógica do agente

O sistema deve:

* saber quais documentos faltam
* identificar documentos recebidos
* validar antes de salvar
* perguntar ao cliente quando necessário

---

# ⚠️ Regras técnicas

* NÃO usar IA para escrever diretamente no banco
* O n8n deve controlar a lógica
* IA deve ser usada apenas para interpretação/conversa
* Nunca salvar documento sem vínculo correto
* Deve tratar erros (arquivo inválido, duplicado, etc)


# 🔐 Segurança

* Arquivos devem ser armazenados no Box
* Não utilizar links públicos diretos
* Garantir rastreabilidade


# 🎯 Diferenciais (não obrigatórios, mas valorizados)

* Identificação automática de documentos (rg, cpf, etc)
* uso de ocr ou ia para validação
* estrutura pronta para escalar como saas
* experiência com automação de whatsapp


# 📦 entregáveis

* json do workflow do n8n (pronto para importação)
* script sql do supabase
* instruções de uso/configuração


# 💬 observações finais

já possuo:

* evolution api rodando
* n8n configurado
* supabase ativo

👉 preciso apenas da implementação da lógica.