--- title: "Media nell'API WhatsApp: tipi di file e limiti di dimensione" description: "Limiti di dimensione e tipi di file supportati dall'API WhatsApp per immagini, video, audio, documenti e sticker, con upload o link, ID media e didascalie." canonical: "https://omnichannels.ai/it/blog/whatsapp-media-messages-file-types-size-limits/" language: "it" updated: "2026-11-07" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" category: "whatsapp" primaryQuery: "whatsapp api media file size limit" keywords: ["limite dimensione file whatsapp api", "formati file supportati whatsapp api", "whatsapp cloud api media", "dimensione massima video whatsapp", "limite dimensione documenti whatsapp", "dimensione sticker whatsapp", "scadenza id media whatsapp", "immagine header template whatsapp", "errore 131053 whatsapp"] published: "2026-11-07" author: "OmniChannels.ai Editorial Team" reviewer: "BroadNet Messaging Solutions Team" readingMinutes: 9 answer: "La documentazione di Meta indica, al momento della stesura, queste dimensioni massime per i media della WhatsApp Cloud API: immagini 5 MB (JPEG, PNG, WebP statico), video 16 MB (MP4 o 3GPP con H.264 e AAC), audio 16 MB, documenti 100 MB, sticker animati 500 KB e sticker statici 100 KB. Caricate il file e inviate il relativo ID media anziché un link, verificando che il tipo MIME corrisponda al file." takeaways: ["Secondo la documentazione di Meta, al momento della stesura i limiti sono 5 MB per le immagini, 16 MB per video e audio, 100 MB per i documenti e 500 KB (animati) o 100 KB (statici) per gli sticker.", "Il video deve essere H.264 con audio AAC e le immagini devono essere RGB o RGBA a 8 bit; un file entro il limite di dimensione può comunque essere rifiutato per codec o formato colore.", "Meta consiglia di inviare i media caricati tramite ID anziché tramite link, per prestazioni migliori.", "Gli ID media restituiti da un upload scadono dopo 30 giorni, quelli ricevuti nei webhook in entrata dopo 7 giorni: scaricate subito i file dei clienti.", "Le didascalie di immagini, video e documenti sono limitate a 1.024 caratteri, e l'errore 131053 segnala di solito un tipo MIME non corrispondente al file."] faq: - q: "Qual è il limite di dimensione dei file nell'API WhatsApp?" a: "Dipende dal tipo. La documentazione di Meta indica 5 MB per le immagini, 16 MB per video e audio, 100 MB per i documenti e 500 KB per gli sticker animati o 100 KB per quelli statici. Il tetto della Cloud API per i media è 100 MB. I limiti possono cambiare: verificateli nel riferimento media aggiornato di Meta prima di costruire regole di validazione." - q: "Quali tipi di file supporta la WhatsApp Business API?" a: "Immagini: JPEG, PNG e WebP statico. Video: MP4 e 3GPP con video H.264 e audio AAC. Audio: AAC, AMR, MP3, M4A e OGG con codec Opus. Documenti: TXT, XLS, XLSX, DOC, DOCX, PPT, PPTX e PDF. Sticker: solo WebP. Tutto ciò che non rientra in questi elenchi viene rifiutato, quindi convertite il file prima dell'invio." - q: "Conviene inviare i media con un link o con un ID media?" a: "La documentazione di Meta consiglia l'ID media caricato, per prestazioni migliori. Un link deve puntare a un file su un server pubblico, quindi la piattaforma deve recuperarlo al momento dell'invio. Un ID si riferisce a un file già archiviato presso Meta. Gli ID ottenuti da un upload sono validi 30 giorni, poi bisogna ricaricare il file." - q: "Per quanto tempo è valido un ID media di WhatsApp?" a: "Meta indica 30 giorni per gli ID restituiti quando caricate un media e 7 giorni per gli ID media ricevuti nei webhook in entrata. I file caricati restano per 30 giorni, salvo cancellazione anticipata. L'URL di download ottenuto da un ID media scade dopo 5 minuti, quindi richiedetene uno nuovo ogni volta che vi serve il file." - q: "Posso aggiungere una didascalia a un'immagine o a un video WhatsApp?" a: "Sì. Il riferimento ai messaggi di Meta prevede una didascalia facoltativa fino a 1.024 caratteri per i messaggi con immagine, video e documento. I messaggi audio e gli sticker non hanno didascalia. Se vi serve del testo con uno sticker o un vocale, inviate dopo un messaggio di testo separato." - q: "Che cosa significa l'errore WhatsApp 131053?" a: "Meta lo descrive come l'impossibilità di caricare il media usato nel messaggio. La causa abituale è un tipo MIME che non corrisponde all'estensione del file, oppure un tipo non supportato. Controllate i dettagli dell'errore nel webhook collegato, verificate il formato rispetto ai tipi di media supportati da Meta e, se serve, ricodificate il file." sources: - title: "Media — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media" - title: "Image messages — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/image-messages" - title: "Video messages — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/video-messages" - title: "Document messages — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/document-messages" - title: "Error codes — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes" --- # Media nell'API WhatsApp: tipi di file e limiti di dimensione Canonical: https://omnichannels.ai/it/blog/whatsapp-media-messages-file-types-size-limits/ Language: it Publisher: OmniChannels.ai by BroadNet Technologies Questa guida è pensata per sviluppatori e marketer che inviano immagini, video, audio, documenti o sticker tramite la WhatsApp Business API e vogliono evitare invii falliti. Elenca i tipi di file e i limiti di dimensione documentati da Meta, spiega upload e link, ID media, didascalie e header dei template, e mostra come gestire i file che i clienti vi inviano. Tutti i numeri qui sotto sono i valori documentati da Meta al momento della stesura (7 novembre 2026). Meta può modificarli, quindi considerate il [riferimento media](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media) come fonte di riferimento. ## Quali sono i limiti di dimensione dei media nell'API WhatsApp? Ogni tipo di media ha un proprio tetto, e il limite massimo della Cloud API per qualsiasi media è 100 MB. I documenti hanno più margine, gli sticker meno. | Tipo di media | Dimensione massima | Note | |---|---|---| | Immagine | 5 MB | Solo RGB o RGBA a 8 bit | | Video | 16 MB | Video H.264, audio AAC | | Audio | 16 MB | Più formati, vedi sotto | | Documento | 100 MB | File Office, PDF e di testo | | Sticker (animato) | 500 KB | Solo WebP | | Sticker (statico) | 100 KB | Solo WebP | Un file può rispettare il limite di dimensione e fallire comunque per il formato. Le sezioni seguenti elencano i formati accettati per ciascun tipo. ## Quali formati di immagine e sticker sono supportati? Le immagini possono essere JPEG, PNG o WebP statico, fino a 5 MB, e devono essere RGB o RGBA a 8 bit. Gli sticker devono essere WebP. | Tipo | Estensione | Tipo MIME | |---|---|---| | JPEG | .jpeg | `image/jpeg` | | PNG | .png | `image/png` | | WebP statico | .webp | `image/webp` | Meta documenta altre tre regole per le immagini. Un WebP statico inviato in un messaggio immagine viene transcodificato in JPEG. I file WebP animati, i WebP non decodificabili e le immagini più grandi di 4.096 pixel su un lato vengono rifiutati. Per gli sticker usate WebP con `image/webp`: fino a 500 KB se animati e 100 KB se statici. Se le risorse del vostro brand sono grandi PNG esportati da uno strumento di design, esportate un JPEG di dimensioni web invece di inviare l'originale. ## Quali formati video e audio sono supportati? Il video è MP4 o 3GPP fino a 16 MB. L'audio può essere AAC, AMR, MP3, M4A oppure OGG con codec Opus, sempre fino a 16 MB. | Tipo | Estensione | Tipo MIME | |---|---|---| | Video MP4 | .mp4 | `video/mp4` | | Video 3GPP | .3gp | `video/3gpp` | | Audio AAC | .aac | `audio/aac` | | Audio AMR | .amr | `audio/amr` | | Audio MP3 | .mp3 | `audio/mpeg` | | Audio MP4 | .m4a | `audio/mp4` | | Audio OGG | .ogg | `audio/ogg` | Per il video Meta richiede il codec H.264 e l'audio AAC, con un solo flusso audio o nessuno. Meta sconsiglia inoltre il profilo H.264 "High" con B-frame, perché i client WhatsApp per Android non lo supportano; usate "Main" senza B-frame oppure "Baseline". Collocate i box `moov` prima dei box `mdat`, il che con ffmpeg significa usare l'opzione `-movflags faststart`. Per l'OGG è supportato solo il codec Opus, il tipo di base `audio/ogg` no, e l'input deve essere mono. ## Quali formati di documento sono supportati? I documenti possono essere PDF, Word, Excel, PowerPoint o testo semplice, fino a 100 MB. | Tipo | Estensione | Tipo MIME | |---|---|---| | PDF | .pdf | `application/pdf` | | Word | .doc, .docx | `application/msword`, `application/vnd.openxmlformats-officedocument.wordprocessingml.document` | | Excel | .xls, .xlsx | `application/vnd.ms-excel`, `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` | | PowerPoint | .ppt, .pptx | `application/vnd.ms-powerpoint`, `application/vnd.openxmlformats-officedocument.presentationml.presentation` | | Testo | .txt | `text/plain` | I messaggi documento accettano un nome file facoltativo con la sua estensione, e il client WhatsApp sceglie l'icona del file in base a quell'estensione. Scegliete un nome leggibile come `invoice-2026-1042.pdf`, perché il cliente lo vede. ## Conviene caricare il media o inviare un link? Meta consiglia di caricare il file e inviare il suo ID media. In alternativa potete inviare un link a un file su un server pubblico, ma i riferimenti di Meta per immagini, video e documenti indicano di preferire l'ID caricato per prestazioni migliori, e le sue indicazioni sul throughput dicono lo stesso per i volumi più alti. | | ID media | Link | |---|---|---| | Come funziona | Prima caricate, poi usate l'ID restituito | Puntate a un URL pubblico; il file viene recuperato al momento dell'invio | | Indicazione di Meta | Consigliato | Supportato, non consigliato | | Validità | 30 giorni dall'upload | Finché il vostro server serve il file | | Modalità di errore | ID scaduto o non valido | URL irraggiungibile, lento o con tipo errato | Con l'endpoint di Meta, un upload è una `POST` a `//media` con il file, il suo tipo MIME e `messaging_product=whatsapp`, e la risposta è `{"id": ""}`. I file caricati vengono cifrati e conservati per 30 giorni, salvo che li eliminiate prima. Sull'endpoint WhatsApp di OmniChannels.ai un messaggio media accetta `mediaUrl` (un URL HTTPS pubblico) oppure `mediaFile` (un file caricato con la richiesta), con la didascalia in `content`. Consultate la [documentazione dell'API WhatsApp](/developers/whatsapp/). Chiedete al nostro team come il vostro account gestisce l'archiviazione e il riutilizzo dei media per gli invii di grandi dimensioni. ## Per quanto tempo restano validi gli ID media? Meta indica 30 giorni per un ID restituito da un upload e 7 giorni per un ID ricevuto in un webhook in entrata. L'URL di download restituito per un ID scade dopo 5 minuti. Conseguenze pratiche: - Non conservate in cache un ID media per mesi. Tenete il file originale e ricaricatelo quando un ID viene rifiutato. - Scaricate i file in entrata non appena arriva l'evento e tenete una copia vostra. - Non salvate mai un URL di download ottenuto; chiedetene uno nuovo quando serve. ## Posso aggiungere didascalie ai messaggi media? Sì. I messaggi con immagine, video e documento accettano una didascalia facoltativa fino a 1.024 caratteri, secondo i riferimenti ai messaggi di Meta. Le didascalie sono testo semplice accanto al file. I messaggi audio e gli sticker non hanno didascalia in questo modello. Se vi servono parole insieme a un vocale, inviate accanto un breve messaggio di testo. All'interno della [finestra di assistenza clienti](/it/blog/whatsapp-24-hour-customer-service-window/) le didascalie sono libere; al di fuori, il media deve viaggiare in un template approvato. ## Come funzionano i media nei modelli di messaggio? Un template può avere un'immagine, un video o un documento nell'header, e quell'header viene fissato quando create il template. Quando inviate un template per l'approvazione fornite un file di esempio, e al momento dell'invio potete fornire il file effettivo. Nella nostra API, `headerFormat` può essere `IMAGE`, `VIDEO` o `DOCUMENT` alla creazione, `headerFile` contiene l'esempio e `mediaUrl` al momento dell'invio sostituisce il media dell'header. Per i requisiti dei file di esempio consultate la documentazione di Meta sui template. Vedi [categorie di template e approvazione](/it/blog/whatsapp-template-categories-approval/) ed [esempi di template](/it/blog/whatsapp-message-template-examples/). ## Come scarico i media che un cliente mi invia? I media in entrata arrivano come webhook con un ID media; lo risolvete in un URL e lo scaricate con autorizzazione. 1. Leggete l'ID media dall'evento del messaggio in entrata. 2. Richiedete l'URL del media per quell'ID. La risposta di Meta include `url`, `mime_type`, `sha256` e `file_size`. 3. Inviate una `GET` a quell'URL con l'header `Authorization: Bearer `. Senza il token la richiesta fallisce. 4. Controllate l'header `Content-Type` e il valore `sha256`, poi salvate il file. 5. In caso di `404`, richiedete un nuovo URL e riprovate; se fallisce ancora, rinnovate il token di accesso. La dimensione massima dei media in entrata di Meta sulla Cloud API è 100 MB. Un file più grande genera un webhook con il codice di errore `131052`; chiedete al cliente di inviare un file più piccolo o di condividerlo in un altro modo. Analizzate ogni file con un antivirus prima di aprirlo internamente. Vedi la [guida ai webhook](/it/blog/whatsapp-webhooks-guide/) e verificate con il vostro tecnico di attivazione come vengono consegnati i media in entrata sul vostro account. ## Esempio pratico: una clinica dentistica che invia referti "Nile Smile Clinic" (fittizia) al Cairo invia cartoncini di appuntamento e referti radiografici. 1. I cartoncini di appuntamento sono immagini PNG da 300 KB con una didascalia di due righe. Ben sotto i 5 MB. 2. I referti dei trattamenti sono PDF da 2 a 8 MB, chiamati `report-2026-0381.pdf`, inviati come documenti. 3. Un video di presentazione della clinica da 25 MB è troppo grande per il video. Il team lo ricodifica come MP4 H.264/AAC sotto i 16 MB con `faststart`. 4. I pazienti inviano foto delle prescrizioni. La casella scarica ogni file subito, perché l'ID in entrata scade dopo 7 giorni. 5. Un saluto vocale viene esportato come OGG Opus mono, perché le altre varianti di OGG vengono rifiutate. ## Quali sono gli errori più comuni? - **Giudicare solo dalla dimensione.** Un'immagine da 3 MB nel formato colore sbagliato o un video con il codec sbagliato fallisce comunque. - **Tipo MIME non corrispondente.** Un `.jpg` servito come `application/octet-stream` è una causa classica dell'errore 131053. - **Linkare un URL lento o privato**, come un link firmato scaduto o una pagina dietro login. - **Affidarsi a un vecchio ID media.** Gli ID scadono dopo 30 giorni. - **Ignorare la scadenza dei file in entrata.** I file dei clienti vanno salvati entro 7 giorni. - **WebP animato come immagine.** Viene rifiutato; usate uno sticker o un video. - **I limiti cambiano.** Ricontrollate il riferimento di Meta prima di codificare le validazioni. ## Come vi aiuta OmniChannels.ai OmniChannels.ai invia messaggi WhatsApp con immagini, video, audio, documenti e sticker tramite un'unica API, con un link pubblico o un file caricato e una didascalia, e mostra media e allegati nella casella condivisa. BroadNet è un Business Solution Provider ufficiale di Meta, quindi i template con header immagine, video o documento possono essere creati e monitorati con lo stato di approvazione. Leggete la [documentazione dell'API WhatsApp](/developers/whatsapp/) e [errori e limiti](/developers/errors-and-limits/), oppure scoprite il [canale WhatsApp](/it/channels/whatsapp-business-api/).