# Obter detalhes do chat

`POST /chat/details`

Pasta: **Contatos**

## Autenticação

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

## Descrição

# Obter detalhes do chat

Busca o registro do chat no banco da instância e as 50 mensagens mais recentes. Use ao abrir a ficha de um contato ou grupo no CRM.

## Endpoint

`POST {{baseUrl}}/chat/details`

## Autenticação

Envie o token da instância no header `token: {{token}}`.

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `number` | string | Condicional | Telefone do chat. Informe `number`, `chatid` ou `id`. |
| `chatid` | string | Condicional | JID do chat (`5511...@s.whatsapp.net` ou `...@g.us`). |
| `id` | string | Condicional | ID interno do registro de chat. |

## Exemplo de Requisição

```bash
curl --request POST '{{baseUrl}}/chat/details' \
  --header 'token: {{token}}' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "number": "5511999999999"
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "chat": {
    "id": "abc123",
    "wa_chatid": "5511999999999@s.whatsapp.net",
    "phone": "5511999999999",
    "name": "João Silva",
    "wa_name": "João Silva",
    "wa_contactName": "João",
    "wa_archived": false,
    "wa_isBlocked": false,
    "wa_isPinned": false,
    "wa_unreadCount": 2,
    "wa_label": ["10", "20"],
    "wa_notes": "Cliente VIP",
    "lead_status": "cliente"
  },
  "messages": []
}
```

## Erros comuns

- `401 Unauthorized`: token inválido.
- `500 Internal Server Error`: chat não encontrado pelos identificadores enviados.

## Observações

- O corpo é opcional na validação HTTP, mas sem `number`/`chatid`/`id` a busca falha.
- Não existe campo `preview` nesta rota.

## Corpo (exemplo)

```json
{
  "number": "5511999999999"
}
```

## cURL

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

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=contatos/obter-detalhes-do-chat)