Tipi di file supportati e limiti
WhatsApp Business API supporta i seguenti tipi di file: immagini (JPEG, PNG, GIF - max 5MB), video (MP4, 3GPP - max 16MB), audio (AAC, M4A, AMR, MP3, OGG - max 16MB), documenti (PDF, Word, Excel, PowerPoint - max 100MB), e sticker (WebP - max 100KB).
I PDF sono il tipo di file business piu inviato via WhatsApp: fatture, preventivi, contratti, manuali, cataloghi. Il destinatario puo aprire il PDF direttamente in WhatsApp senza uscire dall'app, rendendo l'esperienza molto fluida.
Per i video, considera che file di grandi dimensioni impiegano piu tempo a essere scaricati dal destinatario. Per video istruttivi o promozionali, ottimizza la dimensione del file prima dell'invio: punta a meno di 10MB per un'esperienza ottimale.
Implementazione tecnica via API
Per inviare un file via WhatsApp Business API, hai due opzioni: passare l'URL del file (il file deve essere accessibile pubblicamente tramite HTTPS) o caricare il file tramite l'API di media upload di WhatsApp e usare il media_id restituito nell'invio del messaggio.
Il metodo consigliato per file che invii frequentemente e il media upload: carica il file una volta, ottieni il media_id e riutilizzalo per tutti gli invii. Questo evita di dover passare l'URL ogni volta e riduce la latenza del primo invio.
I media_id hanno una scadenza: possono essere riutilizzati per un certo periodo dopo il caricamento. Implementa un meccanismo di cache che rinnova il media_id prima della scadenza per evitare errori in produzione.
File nei template con header immagine
I template WhatsApp possono avere un header di tipo immagine, video o documento. In questo caso, il file viene allegato direttamente al template approvato. Al momento dell'invio del template, puoi specificare il media_id del file da usare come header, permettendo di personalizzare la stessa struttura del template con file diversi.
Best practice per l'invio di file business
Per i documenti legali o commerciali (contratti, preventivi, fatture), assicurati che il PDF includa tutti i dati necessari e sia leggibile su mobile. Usa font sufficientemente grandi e layout a colonna singola per facilitare la lettura su schermo piccolo.
Per le immagini nei template marketing, ottimizza per il formato mobile: proporzioni 1:1 o 16:9 funzionano meglio su WhatsApp. Usa immagini ad alta risoluzione (minimo 1080px) per un aspetto professionale, ma comprimi il file per ridurre i tempi di caricamento.
