# Enviar álbum de imagens

`POST /send/album`

Pasta: **Enviar Mensagem**

## Autenticação

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

## Descrição

# Enviar álbum de imagens

Envia várias imagens em sequência para o mesmo chat. O WhatsApp agrupa automaticamente em um álbum (máx. 20 itens).

## Endpoint

```http
POST {{baseUrl}}/send/album
```

## Autenticação

Envie o token da instância no header:

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

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| jid | string | Sim | Destinatário |
| caption | string | Não | Legenda aplicada ao primeiro item se ele não tiver caption |
| items | array | Sim | Itens do álbum (1–20) |
| items[].type | string | Não | Apenas `image` (outros tipos são ignorados) |
| items[].url | string | Sim | URL da imagem |
| items[].caption | string | Não | Legenda do item |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/send/album" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{"jid": "{{remoteJid}}", "caption": "Fotos do produto", "items": [{"type": "image", "url": "https://exemplo.com/1.jpg", "caption": "Frente"}, {"type": "image", "url": "https://exemplo.com/2.jpg"}, {"type": "image", "url": "https://exemplo.com/3.jpg"}]}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "result": {
    "results": [
      {
        "id": "3EB0AAA111",
        "timestamp": "2026-07-17T12:34:56Z"
      },
      {
        "id": "3EB0BBB222",
        "timestamp": "2026-07-17T12:34:57Z"
      }
    ],
    "sent": 2,
    "failed": 0
  }
}
```

## Erros comuns

- `album must have at least 1 item`
- `album exceeds max 20 items`
- `jid` ausente

## Observações

- Somente imagens. Itens com type diferente de image (ou vazio tratado como image) são contados como failed.

## Corpo (exemplo)

```json
{
  "jid": "{{remoteJid}}",
  "caption": "Fotos do produto",
  "items": [
    {
      "type": "image",
      "url": "https://exemplo.com/1.jpg",
      "caption": "Frente"
    },
    {
      "type": "image",
      "url": "https://exemplo.com/2.jpg"
    },
    {
      "type": "image",
      "url": "https://exemplo.com/3.jpg"
    }
  ]
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/send/album" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "jid": "{{remoteJid}}",
  "caption": "Fotos do produto",
  "items": [
    {
      "type": "image",
      "url": "https://exemplo.com/1.jpg",
      "caption": "Frente"
    },
    {
      "type": "image",
      "url": "https://exemplo.com/2.jpg"
    },
    {
      "type": "image",
      "url": "https://exemplo.com/3.jpg"
    }
  ]
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=enviar-mensagem/enviar-album-de-imagens)