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

# Marcar como Leída

> Marca todos los mensajes de una conversación como leídos

## Parámetros

<ParamField path="id" type="string" required>
  UUID de la conversación
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH "https://api.whaapy.com/conversations/v1/uuid/mark-read" \
    -H "Authorization: Bearer wha_xxxxx"
  ```

  ```javascript Node.js theme={null}
  const conversationId = 'uuid';
  await fetch(
    `https://api.whaapy.com/conversations/v1/${conversationId}/mark-read`,
    {
      method: 'PATCH',
      headers: { 'Authorization': 'Bearer wha_xxxxx' }
    }
  );
  ```

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

  conversation_id = 'uuid'
  response = requests.patch(
      f'https://api.whaapy.com/conversations/v1/{conversation_id}/mark-read',
      headers={'Authorization': 'Bearer wha_xxxxx'}
  )
  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "message": "Conversación marcada como leída",
    "markedMessages": 5
  }
  ```
</ResponseExample>

## Campos de respuesta

| Campo            | Tipo   | Descripción                               |
| ---------------- | ------ | ----------------------------------------- |
| `message`        | string | Confirmación de la acción                 |
| `markedMessages` | number | Cantidad de mensajes marcados como leídos |

## Efectos

1. **Resetea `unreadCount`** a 0
2. **Marca todos los mensajes entrantes** como `status: 'read'`
3. **NO envía confirmación de lectura** a WhatsApp (esto es automático cuando el usuario ve el mensaje en la app)

<Info>
  Este endpoint solo actualiza el estado interno de Whaapy. Los "checks azules" de WhatsApp se envían automáticamente cuando el mensaje se visualiza en la interfaz del dashboard.
</Info>

## Casos de uso

<AccordionGroup>
  <Accordion title="Sincronizar estado con CRM">
    Cuando procesas una conversación en tu CRM, márcala como leída:

    ```javascript theme={null}
    async function processConversationInCRM(conversationId) {
      // ... procesar en CRM ...
      
      // Marcar como leída en Whaapy
      await fetch(
        `https://api.whaapy.com/conversations/v1/${conversationId}/mark-read`,
        {
          method: 'PATCH',
          headers: { 'Authorization': 'Bearer wha_xxxxx' }
        }
      );
    }
    ```
  </Accordion>
</AccordionGroup>