Inviare contenuti multimediali: immagini, video, audio e documenti
I contenuti multimediali si inviano caricando prima il file e indicando l'id restituito, oppure fornendo a Meta un link pubblico da cui scaricarlo. Il caricamento è più affidabile, ma i limiti cambiano in base al tipo e possono sorprendere.
Il limite di dimensione delle immagini sulla Cloud API.
Il limite per video e audio.
Il limite per i documenti.
I limiti per tipo
Sono diversi per ciascun tipo e superarne uno restituisce il codice di errore 131053, senza una descrizione utile.
- Immagini: 5 MB. JPEG e PNG.
- Video: 16 MB. MP4 e 3GPP, con video H.264 e audio AAC.
- Audio: 16 MB. AAC, AMR, MP3, audio MP4 e OGG con Opus.
- Documenti: 100 MB. I tipi di documento più comuni, inclusi PDF e formati Office.
- Sticker: 100 KB animati, 500 KB statici, solo WebP.
Caricare o usare un link
Due modi per inviare lo stesso file, con modalità di errore diverse.
Il caricamento invia prima il file a Meta e restituisce un media id da indicare durante l'invio. Usare un link fornisce a Meta un URL da recuperare al momento dell'invio. Il link sembra più semplice, ma introduce un errore invisibile: un URL che si apre nel tuo browser potrebbe non essere raggiungibile dall'infrastruttura di Meta per motivi geografici, a causa di una regola del firewall o di un cookie di sessione già presente nel browser.
Carica il file. È una richiesta in più, ma elimina un'intera categoria di errori.
Ricevere contenuti multimediali
I contenuti multimediali in ingresso arrivano come media id, non come byte. Il tuo gestore recupera il file separatamente usando quell'id.
- Recuperalo subito. Gli id non restano validi per sempre.
- Un recupero non riuscito restituisce il codice di errore 131052, che di solito indica che il caricamento del mittente era incompleto.
- Conserva il file nel tuo sistema se ti servirà in seguito. Meta non è un archivio.
- Registra il messaggio anche quando il recupero del contenuto multimediale fallisce, così testo e contesto non vanno persi.
Cosa cambia con Coexistence
I contenuti multimediali su un numero Coexistence funzionano esattamente come su qualsiasi altro numero Cloud API, con gli stessi limiti.
L'unica differenza importante riguarda la cronologia. Quando un numero si connette per la prima volta, Meta sincronizza i messaggi recenti dall'app WhatsApp Business, ma questa sincronizzazione comprende il testo dei messaggi e non è un archivio completo dei contenuti multimediali. I contenuti precedenti alla connessione restano sul telefono, come sempre.
Errori comuni
- Inviare un link perché sembra più semplice. La rete di Meta non è il tuo browser.
- Recuperare i contenuti multimediali in ingresso ore dopo. I media id scadono.
- Esportare un video senza controllare il codec. Le impostazioni predefinite dei software di montaggio spesso non sono supportate.
EasyCoexistence invia gli eventi dei messaggi in ingresso direttamente da Meta al tuo endpoint, così i media id arrivano subito nel tuo sistema e puoi recuperarli finché sono validi.
Domande frequenti
Qual è il file più grande che posso inviare?
100 MB, ma solo per i documenti. Video e audio hanno un limite di 16 MB, mentre le immagini di 5 MB.
Devo caricare il file o inviare un URL?
Caricalo. Elimina la raggiungibilità come causa di errore.
Per quanto tempo è valido un media id?
Non per sempre: per questo i contenuti multimediali in ingresso vanno recuperati appena arriva l'evento.
I vecchi contenuti multimediali vengono sincronizzati quando mi connetto?
No. La sincronizzazione della cronologia comprende i contenuti recenti dei messaggi; quelli precedenti alla connessione restano sul telefono.
Continua a leggere
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuitaVerificato il