> ## 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 modelli WhatsApp > Formati e dimensioni dei media accettati da WhatsApp nelle intestazioni dei modelli, perché i link YouTube non si incorporano e come caricarli in Flowella. Un modello WhatsApp può contenere un media nell'intestazione: un'immagine, un video o un documento. Se usato bene, raddoppia i tassi di apertura e di coinvolgimento di un messaggio altrimenti solo testuale. Se usato male (formato errato, URL non funzionante, tipo MIME non corrispondente), fa fallire l'invio o fa apparire il modello come amatoriale. Questa pagina è il riferimento pratico su cosa funziona, cosa non funziona e come scandagliare i media attraverso Flowella. ## Formati e limiti supportati Questi sono i formati e i limiti di dimensione che Meta impone ai media nelle intestazioni dei modelli (e altrove nei messaggi di WhatsApp Business Platform). ### Immagini | Formato | Estensione | Tipo MIME | Dimensione massima | | ------- | ---------------- | ------------ | ------------------ | | JPEG | `.jpeg` / `.jpg` | `image/jpeg` | 5 MB | | PNG | `.png` | `image/png` | 5 MB | Le immagini devono essere a **8 bit, RGB o RGBA**. WebP non è \*\*accettato nelle intestazioni dei modelli (è valido solo nei messaggi sticker, che sono un tipo di messaggio separato). **Dimensioni consigliate:** rapporto di aspetto 1,91:1, minimo 800×418 px. Anche le immagini quadrate (1:1) vengono rese in modo accettabile. Altri rapporti di aspetto sono letterboxati dal client WhatsApp. ### Video | Formato | Estensione | Tipo di MIME | Dimensione massima | | ------- | ---------- | ------------ | ------------------ | | 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 flusso audio o nessun audio**. I video codificati con il profilo H.264 **"Alto" e i fotogrammi B** non sono supportati dai client Android WhatsApp. Codificare (o ricodificare) con il profilo H.264 **"Principale" senza cornici B**, o con il profilo **"Baseline "**, e posizionare le caselle `moov` prima delle caselle `mdat` per una maggiore compatibilità. Se si usa ffmpeg, il flag `-movflags faststart` gestisce l'ordine `moov`/`mdat`. ### Documenti | Formato | Estensione | Tipo MIME | Dimensione massima | | -------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------- | ------------------ | | 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 normale | `.txt` | `text/plain` | 100 MB | I PDF sono i più affidabili tra i dispositivi. I documenti di Office funzionano, ma richiedono che il destinatario abbia installato un'applicazione compatibile; su un cellulare non aziendale di solito si aprono come anteprime. ## Cosa non funziona Non è possibile incorporare un video di YouTube o Vimeo nell'intestazione di un modello. L'intestazione deve essere un file MP4 o 3GPP che Meta può recuperare e ospitare. Se si desidera inviare un video di YouTube, ci sono due opzioni: 1. \*\*Toccandolo si apre l'applicazione o il browser di YouTube. L'anteprima del video visualizzata in WhatsApp sarà una miniatura statica. 2. **Scaricare il video e ricaricarlo in formato MP4.** In base ai propri diritti di ridistribuzione del contenuto, il che di solito significa che deve essere il proprio video. Quest'ultimo è il modo per ottenere un'anteprima del video durante la conversazione. Le GIF animate (`.gif`) non fanno parte dell'elenco supportato. WhatsApp le converte lato server quando vengono condivise peer-to-peer nell'app consumer, ma la Business Platform non lo fa. Ricodificare la GIF come MP4 (che i client mobili di WhatsApp riproducono con l'auto-play e senza audio, nello stesso modo in cui mostrano una GIF). Le immagini WebP sono valide solo per i messaggi adesivi, non per le intestazioni dei modelli. Convertire in JPEG o PNG prima di usarle come immagine di intestazione. Per impostazione predefinita, gli iPhone salvano le foto in formato HEIC, che non è nell'elenco dei formati supportati. Modificare l'impostazione dell'iPhone per acquisire in JPEG o convertire HEIC in JPEG prima del caricamento. Un'immagine da 6 MB, un video da 18 MB o un PDF da 110 MB verranno rifiutati. Comprimere prima del caricamento. Per le immagini, il client WhatsApp comprime anche in fase di visualizzazione, quindi una foto da 4 MB non sarà significativamente migliore di una da 1 MB sullo schermo di un telefono. ## Due modi per allegare i media a un modello Meta supporta due modelli per inserire i media in un modello: ### Schema 1: Maniglia multimediale (consigliato) Caricare il file tramite l'API Media di Meta, ottenere un **media handle** e fare riferimento all'handle quando si invia il template. Utilizzato da Flowella per impostazione predefinita. Vantaggi: * Meta ospita il file, quindi non ci sono errori di URL non funzionanti al momento dell'invio. * Consegna più rapida perché Meta non deve recuperare il file da un URL esterno. * Funziona per i limiti di dimensione completi di cui sopra. L'handle è valido per 30 giorni. Se il modello viene inviato ripetutamente con lo stesso supporto, Flowella aggiorna automaticamente l'handle prima che scada. ### Pattern 2: URL HTTPS pubblico Fornite un URL a un file accessibile pubblicamente. Meta lo recupera al momento dell'invio. È utile quando: * Il supporto cambia a seconda del destinatario (un PDF personalizzato, un'etichetta di spedizione per ordine). * Il supporto viene generato al volo e non si desidera caricarlo al momento dell'invio. Avvertenze: * L'URL deve essere **pubblicamente raggiungibile** (senza auth) 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 certo periodo; l'aggiornamento del 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 la gestione dei media per voi: In **Template → Create**, scegliere **Image**, **Video** o **Document** come tipo di intestazione, quindi trascinare il file nell'area di caricamento. Il formato, la dimensione e il tipo MIME vengono controllati prima dell'invio. Se il file non è supportato, viene visualizzato immediatamente un errore anziché attendere che Meta rifiuti il modello. Il file viene caricato tramite l'API Media di Meta. L'handle restituito viene salvato rispetto al modello. Quando il modello viene inviato per l'approvazione, Meta vede i media effettivi (non un URL), in modo che il processo di revisione possa valutare le immagini come parte dell'approvazione. Fino a quando i media dell'intestazione del modello non cambiano, ogni invio utilizza lo stesso handle. Gli handle vengono aggiornati automaticamente prima della scadenza. Per i supporti per destinatario (PDF personalizzati, etichette di spedizione), utilizzare l'opzione **Public URL** nel costruttore del modello e passare l'URL come variabile quando si attiva l'invio da un flusso di lavoro o dall'API. Vedere [Azioni del flusso di lavoro](/it/hubspot/workflow-actions). ## Progettazione per il viewport WhatsApp Alcune note di progettazione che non compaiono nelle specifiche di Meta, ma che sono importanti nella pratica: * Il testo sulle immagini deve essere grande e ad alto contrasto. WhatsApp mostra l'immagine all'incirca alla larghezza dello schermo mobile, quindi qualsiasi cosa più piccola di circa 14 px diventa illeggibile. * **Area sicura.** WhatsApp può effettuare ritagli o letterbox; mantenere i contenuti critici nell'80% centrale dell'immagine. * L'immagine di intestazione, il nome visualizzato e la foto del profilo di WhatsApp sono tutti vicini: manteneteli visivamente coerenti. * WhatsApp utilizza il primo fotogramma come anteprima prima della riproduzione del video. Non aprire con un riquadro nero o con un logo aziendale; inizia con un'immagine significativa. * Quando si invia un PDF o un altro documento, il **nome del file** è visibile al destinatario. Utilizzate un nome chiaro e descrittivo come `Acme-Order-12345-Receipt.pdf`, non `attachment.pdf`. ## Errori comuni e correzioni Il tipo MIME effettivo del file non corrisponde a quello dichiarato. Spesso accade quando un "JPEG" esportato dall'iPhone è in realtà HEIC o quando uno strumento rinomina un `.docx` in `.pdf` senza convertirlo. Correzione: ispezionare il file (su macOS/Linux: `file -I yourfile.png`) e riesportare nel formato corretto o cambiare l'estensione. Il codec audio è diverso da AAC o sono presenti più flussi audio. Correggere: ricodificare 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-frames. Ricodificare con il profilo Main o Baseline. Meta non riesce a raggiungere l'URL. Cause comuni: l'URL richiede l'autenticazione, il certificato non è valido, il server è lento a rispondere (timeout) o l'URL restituisce un reindirizzamento invece del file. Correzione: testare l'URL con `curl -I` per verificare che restituisca 200 con il tipo di contenuto corretto e che il certificato sia valido. Quindi riprovare. La sorgente è a bassa risoluzione o è stata upscalata. WhatsApp non esegue una rielaborazione della nitidezza; ciò che viene caricato è ciò che viene visualizzato. Correzione: caricare almeno 800 px sul bordo lungo per un'immagine 1.91:1 e non scalare una sorgente piccola. ## Guide correlate * [Template reference](/it/app/template-reference) - la struttura completa dei template in cui questo media si inserisce * [Templates](/it/app/templates) - creazione passo-passo dei template in Flowella * [Azioni flusso di lavoro](/it/hubspot/workflow-actions) - passaggio degli URL dei media per destinatario attraverso i flussi di lavoro HubSpot