Como receber mídia a partir da Cloud Api da Meta

Para as mensagens do usuário recebidas no Webhook do tipo Mídia, é informado o id da mídia que deverá ser utilizado para o download.

Para solicitar o download de mídia para a Meta deve-se fazer uma requisição HTTP GET para o endpoint https://api.whatsapp.serpro.gov.br/client/{fromPhoneNumberId}/v2/media/{id}, substituindo o ID_MEDIA pelo id correspondente à mídia.

URI

URI: https://api.whatsapp.serpro.gov.br/client/{fromPhoneNumberId}/v2/media/{id}
Método: GET

FROM_PHONE_NUMBER_ID

Este campo deve ser o mesmo informado no client_id na geração do token.

ID_MEDIA

Este campo corresponde ao ID da mídia a ser baixado.

Exemplo de download de mídia usando curl

curl --request GET \
  --url https://api.whatsapp.serpro.gov.br/client/{fromPhoneNumberId}/v2/media/{id} \
  --header 'Authorization: Bearer VALOR_TOKEN' \
  --header 'Content-Type: multipart/form-data' \
  --header 'accept: application/json'

Interpretando resultado do download de mídia

Em caso de sucesso, o código retornado é igual a 200 e o arquivo de mídia.

Tipos de mídia suportados

Importante

Todos os tipos de mídia suportados pela Meta podem ser baixados. No geral, as mídias de saída podem ser removidas depois de 30 dias.