# Marcar mensagens como lidas

`POST /message/markread`

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

## Autenticação

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

## Descrição

# Marcar mensagens como lidas

Envia recibimento de leitura (ticks azuis) para uma ou mais mensagens de um chat. Use após processar mensagens recebidas no seu sistema.

## Endpoint

`POST {{baseUrl}}/message/markread`

## Autenticação

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

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| chatid | string | Sim* | JID do chat |
| sender | string | Não | Remetente (útil em grupos / LID) |
| messageid | string | Não* | ID único; é acrescentado à lista `ids` |
| ids | array[string] | Não* | Lista de IDs de mensagem |

* Se `messageid` e `ids` estiverem vazios, a API responde `{"success":true}` sem chamar o WhatsApp.

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/message/markread" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
    "chatid": "5511999999999@s.whatsapp.net",
    "ids": ["3EB01234567890ABCDEF", "3EB0FEDCBA0987654321"]
  }'
```

## Resposta de Sucesso

```json
{
  "success": true
}
```

## Erros comuns

- `401` — token ausente ou inválido
- `400` — JSON inválido
- `500` — instância desconectada ou falha no MarkRead

## Observações

- Diferente de `POST /chat/read`, que marca o **chat** como lido/não lido no app state; este endpoint marca **mensagens** específicas.

## Corpo (exemplo)

```json
{
  "chatid": "5511999999999@s.whatsapp.net",
  "ids": [
    "3EB01234567890ABCDEF"
  ]
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/message/markread" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "chatid": "5511999999999@s.whatsapp.net",
  "ids": [
    "3EB01234567890ABCDEF"
  ]
}'
```

---

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