Vai al contenuto principale
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

FormatoEstensioneTipo MIMEDimensione massima
JPEG.jpeg / .jpgimage/jpeg5 MB
PNG.pngimage/png5 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

FormatoEstensioneTipo di MIMEDimensione massima
3GPP.3gpvideo/3gpp16 MB
MP4.mp4video/mp416 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

FormatoEstensioneTipo MIMEDimensione massima
PDF.pdfapplication/pdf100 MB
Microsoft Word.doc / .docxapplication/msword / application/vnd.openxmlformats-officedocument.wordprocessingml.document100 MB
Microsoft Excel.xls / .xlsxapplication/vnd.ms-excel / application/vnd.openxmlformats-officedocument.spreadsheetml.sheet100 MB
Microsoft PowerPoint.ppt / .pptxapplication/vnd.ms-powerpoint / application/vnd.openxmlformats-officedocument.presentationml.presentation100 MB
Testo normale.txttext/plain100 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:
1

Aggiungere un file multimediale di intestazione durante la creazione del modello

In Template → Create, scegliere Image, Video o Document come tipo di intestazione, quindi trascinare il file nell’area di caricamento.
2

Flowella convalida il file

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.
3

Flowella carica su Meta e memorizza l'handle

Il file viene caricato tramite l’API Media di Meta. L’handle restituito viene salvato rispetto al modello.
4

L'invio del modello include la maniglia

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.
5

Invia il riutilizzo della stessa maniglia

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.

​
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 - la struttura completa dei template in cui questo media si inserisce
  • Templates - creazione passo-passo dei template in Flowella
  • Azioni flusso di lavoro - passaggio degli URL dei media per destinatario attraverso i flussi di lavoro HubSpot