> ## Documentation Index > Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt > Use this file to discover all available pages before exploring further. # Media nelle intestazioni dei template WhatsApp: immagini e video > Quali formati e dimensioni di media WhatsApp accetta nelle intestazioni dei template, perché i link YouTube non si incorporano e come caricare e fare riferimento ai media tramite Flowella. Un template WhatsApp può portare un pezzo di media nella sua intestazione: un'immagine, un video o un documento. Utilizzato bene, raddoppia i tassi di apertura e coinvolgimento di un messaggio altrimenti solo testo. Utilizzato male — formato sbagliato, URL non funzionante, tipo MIME non corrispondente — fa fallire l'invio o rende il template amatoriale. Questa pagina è il riferimento pratico per ciò che funziona, ciò che non funziona e come far passare i media attraverso Flowella. ## Formati e limiti supportati Questi sono i formati e i limiti di dimensione che Meta impone sui media nelle intestazioni dei template (e altrove nei messaggi della WhatsApp Business Platform). ### Immagini | Formato | Estensione | Tipo MIME | Dimensione max | | - | - | - | - | | JPEG | `.jpeg` / `.jpg` | `image/jpeg` | 5 MB | | PNG | `.png` | `image/png` | 5 MB | Le immagini devono essere **8-bit, RGB o RGBA**. WebP **non** è accettato nelle intestazioni dei template (è valido solo nei messaggi sticker, che sono un tipo di messaggio separato). **Dimensioni raccomandate:** rapporto d'aspetto 1,91:1, minimo 800×418 px. Anche le immagini quadrate (1:1) vengono visualizzate in modo accettabile. Altri rapporti d'aspetto vengono letterbox dal client WhatsApp. ### Video | Formato | Estensione | Tipo MIME | Dimensione max | | - | - | - | - | | 3GPP | `.3gp` | `video/3gpp` | 16 MB | | MP4 | `.mp4` | `video/mp4` | 16 MB | I video devono utilizzare il **codec video H.264** e il **codec audio AAC**, con un **singolo stream audio o nessun audio**. I video codificati con il profilo H.264 **"High" e B-frame** non sono supportati dai client WhatsApp Android. Codificate (o ricodificate) con il profilo H.264 **"Main" senza B-frame**, o il profilo **"Baseline"**, e posizionate le box `moov` prima delle box `mdat` per una compatibilità più ampia. Se utilizzate ffmpeg, il flag `-movflags faststart` gestisce l'ordinamento `moov`/`mdat`. ### Documenti | Formato | Estensione | Tipo MIME | Dimensione max | | - | - | - | - | | PDF | `.pdf` | `application/pdf` | 100 MB | | Microsoft Word | `.doc` / `.docx` | `application/msword` / `application/vnd.openxmlformats-officedocument.wordprocessingml.document` | 100 MB | | Microsoft Excel | `.xls` / `.xlsx` | `application/vnd.ms-excel` / `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` | 100 MB | | Microsoft PowerPoint | `.ppt` / `.pptx` | `application/vnd.ms-powerpoint` / `application/vnd.openxmlformats-officedocument.presentationml.presentation` | 100 MB | | Testo semplice | `.txt` | `text/plain` | 100 MB | I PDF sono i più affidabilmente visualizzati su tutti i dispositivi. I documenti Office funzionano ma richiedono che il destinatario abbia un'app compatibile installata; su un mobile non aziendale di solito si aprono come anteprime. ## Cosa non funziona Non potete incorporare un video YouTube o Vimeo in un'intestazione template. L'intestazione deve essere un file MP4 o 3GPP che Meta possa recuperare e ospitare. Se volete inviare un video YouTube, due opzioni: 1. **Mettete il link YouTube nel corpo o in un pulsante URL.** Toccarlo apre l'app YouTube o il browser. L'anteprima del video mostrata in WhatsApp sarà una miniatura statica. 2. **Scaricate il video e ricaricatelo come MP4.** Soggetto ai vostri diritti di ridistribuzione del contenuto, il che di solito significa che deve essere il vostro video. Quest'ultimo è il modo per ottenere un'anteprima video effettiva in conversazione. Le GIF animate (`.gif`) non sono nell'elenco supportato. WhatsApp le converte lato server quando vengono condivise peer-to-peer nell'app consumer, ma la Business Platform non lo fa. Ricodificate la GIF come MP4 (che i client mobili WhatsApp riproducono con riproduzione automatica e senza suono, allo stesso modo in cui mostrano una GIF). Le immagini WebP sono valide solo per i messaggi sticker, non per le intestazioni dei template. Convertite in JPEG o PNG prima di utilizzare come immagine di intestazione. Gli iPhone salvano per impostazione predefinita le foto in formato HEIC, che non è nell'elenco supportato. Cambiate l'impostazione dell'iPhone per acquisire in JPEG, oppure convertite HEIC in JPEG prima del caricamento. Un'immagine da 6 MB, un video da 18 MB o un PDF da 110 MB verranno rifiutati. Comprimete prima del caricamento. Per le immagini, il client WhatsApp ricomprime anche in visualizzazione, quindi una foto da 4 MB non sembrerà significativamente migliore di una da 1 MB su uno schermo di telefono. ## Due modi per allegare media a un template Meta supporta due pattern per far entrare i media in un template: ### Pattern 1: Handle media (raccomandato) Caricate il file tramite l'API Media di Meta, ottenete indietro un **handle media** e fate riferimento all'handle quando inviate il template. Utilizzato da Flowella per impostazione predefinita. Benefici: * Meta ospita il file, quindi non ci sono fallimenti di URL non funzionante al momento dell'invio. * Consegna più veloce perché Meta non deve recuperare da un URL esterno. * Funziona per i limiti di dimensione completi sopra. L'handle è valido per 30 giorni. Se il vostro template viene inviato ripetutamente con lo stesso media, Flowella aggiorna automaticamente l'handle prima che scada. Per le intestazioni DOCUMENT, Flowella riutilizza anche i media documento caricati di recente dove possibile, quindi i reinvii dello stesso template non hanno bisogno di ricaricare il file. Se Meta rifiuta un id riutilizzato, Flowella ricade sul caricamento di nuovo. ### Pattern 2: URL HTTPS pubblico Fornite un URL a un file accessibile pubblicamente. Meta lo recupera al momento dell'invio. Questo è utile quando: * Il media cambia per destinatario (un PDF personalizzato, un'etichetta di spedizione per ordine). * Il media viene generato al volo e non volete caricare per invio. Avvertenze: * L'URL deve essere **raggiungibile pubblicamente** (nessuna autenticazione) e utilizzare **HTTPS con un certificato valido**. * Se l'URL restituisce un errore o è lento, l'invio fallisce. * Meta memorizza nella cache il file recuperato per un po'; aggiornare il file all'URL non aggiorna necessariamente ciò che viene inviato. ## Come Flowella gestisce il caricamento dei media Per la maggior parte dei casi d'uso, Flowella gestisce l'handle media per voi: In **Template → Crea**, scegliete **Immagine**, **Video** o **Documento** come tipo di intestazione, quindi **trascinate il file sulla zona di caricamento tratteggiata** o fate clic su di essa per sfogliare. Il drag-and-drop funziona per tutti e tre i tipi di intestazione e utilizza lo stesso percorso di caricamento del clic. Per le intestazioni **Documento**, l'editor mostra anche un campo **Nome file documento** che ha come predefinito il file caricato — modificatelo per controllare il nome che i destinatari vedono sulla bolla documento di WhatsApp. Formato, dimensione e tipo MIME vengono verificati prima della sottomissione. Se rilasciate o scegliete un file non supportato, un toast vi dice immediatamente cosa non va (tipo sbagliato o oltre il limite di dimensione) invece di aspettare che Meta rifiuti il template. Il file viene caricato tramite l'API Media di Meta. L'handle restituito viene salvato rispetto al template. Quando il template viene inviato per l'approvazione, Meta vede il media effettivo (non un URL), quindi il processo di revisione può valutare gli elementi visivi come parte dell'approvazione. Finché il media dell'intestazione del template non cambia, ogni invio utilizza lo stesso handle. Gli handle vengono aggiornati automaticamente prima della scadenza. Per le intestazioni DOCUMENT, il **Nome file documento** che avete impostato nell'editor viene mantenuto con la bozza, portato attraverso l'approvazione e la pubblicazione di Meta e utilizzato su ogni invio — invii da workflow HubSpot, invii di test, invii in massa e invii dalla posta in arrivo mostrano tutti il vostro nome file invece del nome interno del template. Quando utilizzate **Template → Duplica**, Flowella copia il file di intestazione e il **Nome file documento** nella nuova bozza. Se la copia fallisce, l'editor mostra un avviso e blocca la pubblicazione finché non ricaricate il file. Per i media per destinatario (PDF personalizzati, etichette di spedizione), utilizzate l'opzione **URL pubblico** nel costruttore di template e passate l'URL come variabile durante l'attivazione dell'invio da un workflow o dall'API. Vedere [Azioni del workflow](/it/hubspot/workflow-actions). ## Progettazione per il viewport WhatsApp Alcune note di progettazione che non appaiono nella specifica di Meta ma che contano nella pratica: * **Testo sulle immagini.** Mantenetelo grande e ad alto contrasto. WhatsApp mostra l'immagine a circa larghezza dello schermo mobile, quindi qualsiasi cosa più piccola di circa 14 px viene visualizzata illeggibile. * **Area sicura.** WhatsApp può ritagliare o letterbox; mantenete il contenuto critico nel centro 80% dell'immagine. * **Coerenza del brand.** L'immagine di intestazione e il nome di visualizzazione WhatsApp e la foto del profilo si trovano tutti vicini — mantenerli visivamente coerenti. * **Primo fotogramma di un video.** WhatsApp utilizza il primo fotogramma come anteprima fissa prima della riproduzione del video. Non aprite con un fotogramma nero o uno splash del logo aziendale; iniziate con un'immagine significativa. * **Nome file documento.** Quando si invia un PDF o altro documento, il **nome file** è visibile al destinatario sulla bolla documento di WhatsApp. L'editor del template espone un campo **Nome file documento** sotto il caricamento dell'intestazione DOCUMENT; ha come predefinito il nome del file caricato ed è ciò che i destinatari vedono effettivamente quando il template viene inviato. Utilizzate un nome chiaro e descrittivo come `Acme-Ordine-12345-Ricevuta.pdf`, non `allegato.pdf` o il nome dell'oggetto CDN Meta. ## Errori comuni e correzioni Il tipo MIME effettivo del file non corrisponde a quello dichiarato. Spesso accade quando un "JPEG" esportato da iPhone è in realtà HEIC, o quando uno strumento rinomina un `.docx` in `.pdf` senza convertirlo. Correzione: ispezionate il file (su macOS/Linux: `file -I yourfile.png`) e riesportate nel formato giusto o cambiate l'estensione per corrispondere. Il codec audio è qualcosa di diverso da AAC, o ci sono più stream audio. Correzione: ricodificate con `ffmpeg -i input.mp4 -c:v libx264 -profile:v main -c:a aac -movflags faststart output.mp4`. Codificato con profilo H.264 High e B-frame. Ricodificate con profilo Main o Baseline. Meta non può raggiungere l'URL. Cause comuni: l'URL richiede autenticazione, il certificato non è valido, il server è lento a rispondere (timeout) o l'URL restituisce un redirect invece del file. Correzione: testate l'URL con `curl -I` per confermare che restituisca 200 con il tipo di contenuto giusto e che il certificato sia valido. Poi riprovate. La sorgente è a bassa risoluzione, o è stata ingrandita. WhatsApp non ri-elabora per la nitidezza; ciò che caricate è ciò che viene mostrato. Correzione: caricate almeno 800 px sul bordo lungo per un'immagine 1,91:1 e non ingrandite una sorgente piccola. ## Guide correlate * [Riferimento template](/it/app/template-reference) — la struttura completa del template in cui questo media si inserisce * [Template](/it/app/templates) — creazione template passo-passo in Flowella * [Azioni del workflow](/it/hubspot/workflow-actions) — passaggio di URL media per destinatario tramite workflow HubSpot This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.