Caricamento file
Tipi consentiti, limiti di dimensione, archiviazione cloud ed elaborazione automatica degli allegati.
A cosa serve
- Accettare documenti o foto dagli utenti nei flussi di agenti.
- Conservare evidenza per manutenzione, qualità e HACCP.
- Isolare file per tenant con URL firmati a TTL breve.
Come funziona
Gli upload vanno a GCS con isolamento bucket per tenant. Il file viene scansionato per MIME, dimensione e malware, poi vengono emessi URL firmati con TTL breve per il consumo downstream.
Tipi consentiti e limiti
La piattaforma accetta i seguenti tipi di file per il caricamento:
| Tipo | MIME | Limite |
|---|---|---|
application/pdf | 25 MB | |
| PNG | image/png | 25 MB |
| JPEG | image/jpeg | 25 MB |
| WebP | image/webp | 25 MB |
| GIF | image/gif | 25 MB |
Il limite massimo per file e di 25 MB. I file che superano questa dimensione verranno rifiutati con un errore di validazione.
Archiviazione
I file vengono archiviati in Google Cloud Storage (GCS) seguendo una struttura organizzata per tenant:
files/{tenant}/{collezione}/{campo}/{uuid}_{nome}- tenant: identificativo unico dell'organizzazione
- collezione: nome della collezione a cui appartiene il record
- campo: nome del campo di tipo "file" nel template
- uuid: identificativo unico generato automaticamente
- nome: nome originale del file
URL firmati
Per accedere ai file archiviati, la piattaforma genera URL firmati con una scadenza di 60 minuti. Questo garantisce che i file siano accessibili solo temporaneamente e solo da utenti autorizzati.
Utilizzo nelle collezioni
I campi di tipo file nei template di estrazione memorizzano i metadati del file:
- Percorso GCS
- Nome originale
- Tipo MIME
- Dimensione in byte
Invio tramite WhatsApp
Gli agenti possono ricevere ed elaborare allegati (immagini e PDF) automaticamente tramite WhatsApp. Quando un utente invia un file nella conversazione:
- Il file viene scaricato e archiviato in GCS
- Viene elaborato utilizzando la visione IA per estrarre contenuto rilevante
- L'agente utilizza le informazioni estratte per continuare la conversazione
Questo consente flussi come l'acquisizione di documenti, la verifica dell'identita o la ricezione di ricevute direttamente da WhatsApp.
Benefici chiave
- Isolamento per tenant — nessuna perdita tra clienti.
- URL firmati: accesso temporaneo, revocabile.
- Scan malware automatico prima di accettare.
- Limiti per dimensione e MIME configurabili.
- Integrazione diretta con work orders e HACCP.