# Marcar como lida

> Marque uma mensagem recebida como lida com POST /v1/messages/{id}/read e, se quiser, mostre o indicador de digitação.

`POST /v1/messages/{id}/read` marca como lida uma mensagem que o contato mandou. Com `typing: true`, mostra também o indicador de "digitando".

## Antes de começar

- Uma chave de API com a permissão `send`.
- O `id` (`msg_…`) da mensagem **recebida**, que vem no evento `message.received`.

## Marcar como lida

**cURL**

```bash
curl -X POST https://api.messajo.com/v1/messages/msg_.../read \
  -H "Authorization: Bearer $MESSAJO_API_KEY"
```

Com o indicador de digitação:

```bash
curl -X POST https://api.messajo.com/v1/messages/msg_.../read \
  -H "Authorization: Bearer $MESSAJO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "typing": true }'
```

**TypeScript**

```ts
import { Messajo } from "@messajo/sdk";

const messajo = new Messajo({ apiKey: process.env.MESSAJO_API_KEY! });

await messajo.messages.markRead("msg_...");
```

O método do SDK não recebe `typing`. Para mostrar "digitando", chame a API REST (aba cURL) ou mande `typing: true` no próximo envio.

**n8n**

n8n HTTP Request: POST https://api.messajo.com/v1/messages/msg_.../read

```json
{ "typing": true }
```

A resposta traz o id e a confirmação:

```json
{ "id": "msg_...", "read": true }
```

## Campos

| Campo | Descrição |
|---|---|
| `id` (caminho) | Id `msg_…` da mensagem recebida. |
| `typing` (corpo, opcional) | `true` mostra "digitando". Padrão `false`. |

## Por canal

- **WhatsApp:** o indicador de digitação sempre marca a mensagem como lida.
- **Instagram:** `typing: true` mostra "digitando" antes do envio e `POST /v1/messages/{id}/read` marca a conversa como vista.
- **Messenger:** usa o mesmo motor do Instagram, veja [Mensagens](/connect/messenger/#mensagens).

O `typing` gasta uma ficha do balde do número (veja [Limites](/api/limits/)).

## Erros comuns

- [`not_found`](/errors#not_found) (404): o `id` não existe.
- [`connection_rate_limited`](/errors#connection_rate_limited) (429): sem ficha no balde. Espere o `Retry-After` e repita.
