Contenuto multimediale

/v1/media

Utilizza il nodo media per caricare, recuperare o eliminare il contenuto multimediale.

Segmenti

A questo nodo sono collegati i segmenti di seguito:

Prima di iniziare

Quando si invia un messaggio multimediale, il contenuto multimediale viene conservato nei server di WhatsApp per 14 giorni. Se un utente effettua una richiesta di download di quel contenuto multimediale dopo 14 giorni, i server di WhatsApp richiederanno quello stesso file multimediale al client on-premises di WhatsApp Business. Se il contenuto multimediale è stato rimosso, l'utente riceverà una notifica che il contenuto multimediale non è disponibile.

Non si può presupporre che il contenuto multimediale sia stato scaricato solo sulla base delle ricevute di consegna e delle conferme di lettura. I contenuti multimediali in uscita possono generalmente essere rimossi dopo 30 giorni, ma è consigliabile che sia l'utente a determinare la strategia più idonea per la propria azienda.

Limitazioni

• Se utilizzi il processo di caricamento dei contenuti multimediali anziché il collegamento di un URL del contenuto multimediale, il file deve essere caricato sul volume del contenuto multimediale. Una volta completato il caricamento, puoi inviare un messaggio utilizzando l'ID del contenuto multimediale.
• L'app elaborerà il contenuto multimediale caricato prima che venga inviato al server. Sebbene la dimensione massima dei file per i contenuti multimediali che possono essere caricati sul nodo media sia 100 MB, esistono limiti di post-elaborazione per i vari tipi di contenuti multimediali indicati nella Tabella delle dimensioni dei contenuti multimediali in post-elaborazione di seguito.
• Lo spazio di archiviazione dei contenuti multimediali deve essere gestito dall'azienda. Se il volume dei contenuti multimediali raggiunge il limite massimo, la funzionalità di invio di messaggi inizierà a generare errori.
• Non è previsto alcun supporto per:

  • invio di contenuti multimediali tramite flussi di byte;
  • invio di messaggi con sticker animati.

Caricamento

Effettua una richiesta POST a /v1/media per caricare il contenuto multimediale. Il corpo della richiesta on-premises deve contenere i dati binari del contenuto multimediale e l'intestazione Content-Type deve essere impostata sul tipo di contenuto multimediale da caricare. Per le opzioni supportate, consulta la sezione Tipi di contenuto supportati.

L'invio di dati binari in una richiesta POST HTTP costituisce la modalità di caricamento standard di dati binari. Se desideri caricare un'immagine, ad esempio, puoi inviare una richiesta POST con i byte effettivi dell'immagine nel payload. In alternativa, puoi utilizzare --data-binary se desideri che cURL legga e utilizzi quel dato file in codice binario esattamente come indicato.

Esempio

Caricamento di contenuti multimediali:

POST /v1/media
Content-Type: image/jpeg or other appropriate media type

your-binary-media-data

Caricamento di contenuti multimediali con cURL:

curl -X POST \
https://your-webapp-hostname:your-webapp-port/v1/media \
-H 'Authorization: Bearer your-auth-token' \ 
-H 'Content-Type: image/jpeg'  \ # or other appropriate media type
--data-binary @your-file-path

In entrambi i casi, una risposta positiva restituisce il campo id contenente le informazioni necessarie per recuperare contenuti multimediali e inviare un messaggio multimediale ai tuoi clienti.

{
    "media": [
        {
            "id": "f043afd0-f0ae-4b9c-ab3d-696fb4c8cd68"
        }
    ]
}

Se ricevi un messaggio di errore, consulta Messaggi di errore e di stato per maggiori informazioni.

Tipi di contenuto supportati

Dimensioni dei contenuti multimediali in post-elaborazione

Questa è la dimensione massima consentita del file multimediale dopo compressione e crittografia.

FAQ

docker volume inspect whatsappMedia

[
    {
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/whatsappMedia/_data",
        "Name": "whatsappMedia",
        "Options": {},
        "Scope": "local"
    }
]

ls /var/lib/docker/volumes/whatsappMedia/_data/

Ulteriori informazioni

• Best practice
• Messaggi
• Riferimento