Vai al contenuto
OmniChannels.ai
Menu

WhatsApp Business API

Quali sono i limiti di dimensione dei file multimediali dell’API di WhatsApp?

Aggiornato

Risposta breve

La documentazione di Meta elenca, al momento della stesura, queste dimensioni massime per i file multimediali 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 suo ID multimediale anziché un link, e verificate che il tipo MIME corrisponda al file.

Limiti di dimensione per tipo di file

Il tetto della Cloud API per qualsiasi file multimediale è 100 MB. Un file può rispettare il limite di dimensione ed essere comunque rifiutato per il formato, ad esempio un video che non è H.264 con audio AAC o un’immagine che non è RGB o RGBA a 8 bit.

Tipo di fileDimensione massimaNote
Immagine5 MBSolo RGB o RGBA a 8 bit
Video16 MBVideo H.264, audio AAC
Audio16 MBAAC, AMR, MP3, M4A, OGG con codifica Opus
Documento100 MBFile Office, PDF e di testo
Sticker (animato)500 KBSolo WebP
Sticker (statico)100 KBSolo WebP

Caricamento o link, e quanto durano gli ID

Meta consiglia di caricare il file e inviare il suo ID multimediale per prestazioni migliori. Gli ID restituiti da un caricamento restano validi 30 giorni, quelli ricevuti nei webhook in entrata 7 giorni, quindi scaricate subito i file dei clienti. Un URL di download scade dopo 5 minuti.

Le didascalie di immagini, video e documenti possono arrivare a 1.024 caratteri. I messaggi audio e gli sticker non hanno didascalia.

Errori comuni

  • Giudicare solo dalla dimensione e ignorare codec o formato colore.
  • Servire un file con un tipo MIME non corrispondente, causa abituale dell’errore 131053.
  • Fare affidamento su un ID multimediale più vecchio di 30 giorni.
  • Inviare come immagine un WebP animato, che viene rifiutato.

Fonti ufficiali