ID contenuto multimediale

/v1/media/{media-id}

Dato un ID specifico, utilizza questo endpoint per recuperare o eliminare il tuo contenuto multimediale.

Prima di iniziare

Prima di recuperare l'eliminazione, devi caricare il contenuto multimediale tramite /v1/media.

Recupero

Dopo aver caricato correttamente il contenuto multimediale, riceverai una risposta contenente un ID contenuto multimediale. Usa quell'ID nella richiesta di recupero dei contenuti multimediali memorizzati nel client dell'API di WhatsApp Business.

Questo processo di recupero dei contenuti multimediali è utile anche quando un utente ti invia un'immagine che è stata ricevuta dal tuo webhook. Quando viene ricevuto un messaggio multimediale, il client dell'API di WhatsApp Business scarica il contenuto multimediale. Al termine del download del contenuto multimediale, riceverai una notifica attraverso il tuo webhook. Utilizza l'ID del contenuto multimediale fornito in quella notifica per recuperare il relativo contenuto multimediale.

Puoi abilitare il client dell'API di WhatsApp Business per il download automatico dei contenuti multimediali dalle Impostazioni di download automatico dei contenuti multimediali.

Esempio

GET /v1/media/media-id

Utilizza l'immagine di esempio caricata nella sezione precedente:

curl -X GET \
  https://your-webapp-hostname:your-webapp-port/v1/media/4b5bf27b-8672-4d55-bc21-d096dc200d0f \
  -H 'Authorization: Bearer your-auth-token' 

Per inviare questo esempio di contenuto multimediale a un file, utilizza il parametro -o come mostrato di seguito:

curl -X GET \
  https://your-webapp-hostname:your-webapp-port/v1/media/4b5bf27b-8672-4d55-bc21-d096dc200d0f \
  -H 'Authorization: Bearer your-auth-token' \
  -o path/filename

Se la chiamata viene eseguita correttamente, visualizzerai una risposta contenente lo stato 200 OK e i dati binari del contenuto multimediale.

Content-Type: image/jpeg or other appropriate media type
Content-Length: content-size

binary-media-data

Utilizzando uno strumento come Postman, visualizzerai l'immagine. Se utilizzi uno strumento da riga di comando, visualizzerai i dati binari. Se invii i dati a un file, visualizzerai l'immagine nella tua unità di selezione file.

Se il contenuto multimediale non viene trovato, viene restituito un codice di risposta 404 Not Found senza corpo.

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

Eliminazione

Per eliminare i contenuti multimediali nel client dell'API di WhatsApp Business, invia una richiesta DELETE al nodo media con l'ID del contenuto multimediale che desideri eliminare. Usa l'ID indicato nella risposta al caricamento del contenuto multimediale o al messaggio multimediale da un webhook.

Esempio

Richiesta:

DELETE /v1/media/media-id

Una risposta positiva mostrerà 200 OK e null o {}. Se il contenuto multimediale non viene trovato, la risposta mostrerà 404 Not Found e non conterrà alcun corpo. Se ricevi un messaggio di errore diverso, consulta Messaggi di errore e di stato per ulteriori informazioni.