# Listar chats recentes

`POST /chat/find`

Pasta: **Chats**

## Autenticação

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

## Descrição

# Listar chats recentes

Retorna chats ordenados pela última mensagem. O handler **não** aplica filtros de CRM (`lead_status`, `wa_label`, etc.) — apenas o parâmetro de query `limit`.

## Endpoint

`POST {{baseUrl}}/chat/find?limit=50`

## Autenticação

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

## Parâmetros

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| limit | query integer | Não | Quantidade máxima (padrão `100`; valores ≤0 ou >500 viram `100`) |

Corpo JSON é ignorado pelo handler atual (pode ser omitido).

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/chat/find?limit=50" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json"
```

## Resposta de Sucesso

```json
{
  "success": true,
  "chats": [
    {
      "id": "c1a2b3",
      "wa_chatid": "5511999999999@s.whatsapp.net",
      "phone": "5511999999999",
      "wa_name": "Cliente",
      "wa_unreadCount": 0,
      "wa_archived": false,
      "wa_isPinned": false
    }
  ]
}
```

## Erros comuns

- `401` — token ausente ou inválido
- `500` — falha ao listar chats

## Observações

- Se a tabela de chats estiver vazia, a API pode derivar chats a partir do histórico de mensagens.

## Query

- `limit` = `50`

## Corpo (exemplo)

```json
{}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/chat/find" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=chats/listar-chats-recentes)