# Baixar mídia de uma mensagem

`POST /message/download`

Pasta: **Ações na mensagem e Buscar**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Baixar mídia de uma mensagem

Baixa o arquivo (imagem, vídeo, áudio, documento, sticker etc.) associado a uma mensagem já registrada no histórico da instância. Use quando precisar da URL pública temporária ou do binário da mídia.

## Endpoint

`POST {{baseUrl}}/message/download`

## Autenticação

Header obrigatório: `token: {{token}}` (token da instância).

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| chatid | string | Não* | JID do chat (`5511...@s.whatsapp.net` ou grupo `@g.us`) |
| messageid | string | Não* | ID da mensagem no histórico |

* Informe `chatid`, `messageid` ou ambos. Pelo menos um é obrigatório.

Query opcional: `?download=1` — em vez de JSON, a API responde com o arquivo binário (`Content-Disposition: attachment`).

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/message/download" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
    "chatid": "5511999999999@s.whatsapp.net",
    "messageid": "7EB0F01D7244B421048F0706368376E0"
  }'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "mimetype": "image/jpeg",
  "media_url": "https://develop.gozap.dev/media/r183e2ef9597845/7EB0F01D7244B421048F0706368376E0.jpg",
  "media_url_expires_at": "2026-07-17T12:00:00Z"
}
```

## Erros comuns

- `400` — nenhum de `chatid`/`messageid` informado
- `401` — token ausente ou inválido
- `404` — mídia expirada (`media expired`)
- `500` — falha ao recuperar a mídia no storage/WhatsApp

## Observações

- A mensagem precisa existir no histórico da instância.
- `media_url` é um link público temporário (sem token) servido por `GET /media/:instanceID/:messageID`.

## Corpo (exemplo)

```json
{
  "chatid": "5511999999999@s.whatsapp.net",
  "messageid": "7EB0F01D7244B421048F0706368376E0"
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/message/download" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "chatid": "5511999999999@s.whatsapp.net",
  "messageid": "7EB0F01D7244B421048F0706368376E0"
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=acoes-na-mensagem-e-buscar/baixar-midia-de-uma-mensagem)