> ## Documentation Index
> Fetch the complete documentation index at: https://docs.messagefy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Marcar como Lido

> Marca mensagens específicas como lidas em uma conversa

# Marcar como Lido

O comando **Marcar como Lido** marca uma ou mais mensagens como lidas em uma conversa.
Isso atualiza o status de leitura no WhatsApp, incluindo os ticks azuis para o remetente.

## Requisição

```
POST /api/v1/message/SendCommand
```

```json theme={null}
{
  "channelId": "uuid-do-canal",
  "content": {
    "type": "MARK_READ",
    "commandType": "MARK_READ",
    "messageIds": [
      "3EB0A1B2C3D4E5F6",
      "3EB0F6E5D4C3B2A1"
    ],
    "chatId": "5511999887766@s.whatsapp.net"
  }
}
```

### Campos

| Campo        | Tipo       | Obrigatório | Descrição                                      |
| ------------ | ---------- | ----------- | ---------------------------------------------- |
| `messageIds` | `string[]` | **Sim**     | Lista de IDs das mensagens a marcar como lidas |
| `chatId`     | `string`   | **Sim**     | JID da conversa (contato ou grupo)             |

## Resposta da API

```json theme={null}
{
  "packageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
```

## Webhook de resposta

O resultado é entregue via webhook do tipo `MARK_READ_RESPONSE`:

```json theme={null}
{
  "packageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "channelId": "uuid-do-canal",
  "content": {
    "type": "MARK_READ_RESPONSE",
    "commandType": "MARK_READ",
    "success": true
  }
}
```

### Campos da resposta

| Campo     | Tipo      | Descrição                                                                |
| --------- | --------- | ------------------------------------------------------------------------ |
| `success` | `boolean` | Indica se a marcação foi concluída com sucesso                           |
| `error`   | `string`  | Mensagem de erro quando `success` é `false` (omitido em caso de sucesso) |

<Note>
  Quando a marcação é bem-sucedida, o remetente vê os ticks azuis na conversa.
</Note>

## Exemplo completo

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api-dev.messagefy.io/api/v1/message/SendCommand \
    -H "Content-Type: application/json" \
    -H "X-API-KEY: sua-api-key" \
    -d '{
      "channelId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "content": {
        "type": "MARK_READ",
        "commandType": "MARK_READ",
        "messageIds": ["3EB0A1B2C3D4E5F6", "3EB0F6E5D4C3B2A1"],
        "chatId": "5511999887766@s.whatsapp.net"
      }
    }'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api-dev.messagefy.io/api/v1/message/SendCommand",
      headers={
          "Content-Type": "application/json",
          "X-API-KEY": "sua-api-key"
      },
      json={
          "channelId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "content": {
              "type": "MARK_READ",
              "commandType": "MARK_READ",
              "messageIds": ["3EB0A1B2C3D4E5F6", "3EB0F6E5D4C3B2A1"],
              "chatId": "5511999887766@s.whatsapp.net"
          }
      }
  )

  print(response.json())
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api-dev.messagefy.io/api/v1/message/SendCommand",
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "X-API-KEY": "sua-api-key",
      },
      body: JSON.stringify({
        channelId: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        content: {
          type: "MARK_READ",
          commandType: "MARK_READ",
          messageIds: ["3EB0A1B2C3D4E5F6", "3EB0F6E5D4C3B2A1"],
          chatId: "5511999887766@s.whatsapp.net",
        },
      }),
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

<Tip>
  Você pode obter os `messageIds` dos webhooks de [mensagem recebida](/mensagens/visao-geral)
  ou do comando [Últimas Mensagens](/comandos/ultimas-mensagens).
  Para marcar toda a conversa como lida, envie o ID da última mensagem recebida.
</Tip>