# Buscar mensagens no histórico

`POST /message/find`

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

## Autenticação

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

## Descrição

# Buscar mensagens no histórico

Consulta mensagens já persistidas no banco da instância (não pede histórico novo ao WhatsApp). Use para listar o histórico local de um chat, paginar ou buscar uma mensagem pelo ID.

## Endpoint

`POST {{baseUrl}}/message/find`

## Autenticação

Header obrigatório: `token: {{token}}`.

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| chatid | string | Não | Filtra por chat (JID canônico) |
| messageid | string | Não | Filtra por ID exato da mensagem |
| limit | integer | Não | Quantidade máxima (padrão/teto aplicados pela API; tipicamente até 500) |
| offset | integer | Não | Deslocamento para paginação (mínimo 0) |

Corpo JSON é opcional: sem filtros, retorna as mensagens mais recentes da instância.

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/message/find" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
    "chatid": "5511999999999@s.whatsapp.net",
    "limit": 20,
    "offset": 0
  }'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "messages": [
    {
      "messageid": "7EB0F01D7244B421048F0706368376E0",
      "chatid": "5511999999999@s.whatsapp.net",
      "fromMe": false,
      "messageTimestamp": 1721200000,
      "type": "conversation",
      "body": "Olá"
    }
  ]
}
```

## Erros comuns

- `401` — token ausente ou inválido
- `400` — JSON inválido
- `500` — erro ao consultar o histórico

## Observações

- Ordenação: `messageTimestamp` decrescente (mais recentes primeiro).
- Para pedir mensagens antigas que ainda não estão no banco, use `POST /message/history-sync`.

## Corpo (exemplo)

```json
{
  "chatid": "5511999999999@s.whatsapp.net",
  "limit": 20,
  "offset": 0
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/message/find" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "chatid": "5511999999999@s.whatsapp.net",
  "limit": 20,
  "offset": 0
}'
```

---

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