API atual/Referência completa/WhatsApp: histórico e ligações

Mídia da mensagem

Devolve o arquivo (imagem, áudio, vídeo ou documento) que veio em uma mensagem do WhatsApp.

Quando o cliente manda uma foto, um áudio ou um PDF, a mensagem só guarda uma referência. Esta rota entrega o arquivo de verdade: ele vem do cache da plataforma ou é buscado na Meta na hora (até 16 MB). Use o id numérico da mensagem, obtido em Mensagens e CSV.

GET/api/v1/admin/whatsapp-confluence/media/{messageID}Admin

Devolve os bytes da mídia de uma mensagem

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um administrador da loja. Veja Tokens.

Parâmetros de caminho

messageIDintegerobrigatório

Id numérico da mensagem (id em Mensagens e CSV). Deve ser maior que 0.

Exemplo de requisição

bash

curl -o media.bin "$BASE_URL/api/v1/admin/whatsapp-confluence/media/28" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Bytes da mídia

http

HTTP/1.1 200 OK
Content-Type: image/jpeg
Content-Disposition: inline; filename="foto.jpg"
Cache-Control: private, no-store
X-Content-Type-Options: nosniff

<bytes do arquivo>

Campos da resposta

corpobinary

O arquivo. Content-Type é o tipo real; tipos fora da lista segura (imagens jpeg, png, webp, gif; áudios ogg, mpeg, mp4, aac, amr, webm; vídeos mp4, 3gpp, webm; pdf) vêm como application/octet-stream com Content-Disposition: attachment. O nome do arquivo é a legenda ou o texto da mensagem, ou media.

Erros

Status	Quando	Corpo de exemplo
401	Token ausente, inválido ou expirado.	`{"error":"missing authorization header"}`
403	O token não é de um administrador.	`{"error":"insufficient permissions"}`
400	`messageID` é 0 ou negativo.	`{"error":"invalid id parameter"}`
400	`messageID` não é um número.	`{"error":"invalid message id"}`
404	Mensagem sem mídia, inexistente, ou sem referência de arquivo.	`{"error":"media not found"}`
502	A Meta não devolveu a mídia (o corpo traz o motivo), ou veio vazia.	`{"error":"empty media"}`

Veja também