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

# Marcar como lida

> Exiba os dois tiques azuis para o cliente na mensagem que ele enviou.

Marca uma mensagem recebida como lida, exibindo os **dois tiques azuis** para o cliente. Use quando o seu sistema ou o seu atendente realmente abriu a mensagem, para o cliente saber que ela foi vista.

A chamada usa o mesmo endpoint de envio, mas o corpo não tem `to` nem `type`: ele leva o `status` e o `message_id`.

```json theme={null}
{
  "messaging_product": "whatsapp",
  "status": "read",
  "message_id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjJBQjE="
}
```

A resposta é `{ "success": true }`.

## De onde vem o `message_id`

O `message_id` é o `wamid` da mensagem do cliente, que chega no [webhook](https://developers.datafyapi.com.br/api-reference/whatsapp/webhooks/eventos/mensagens.md) em `messages[].id`.

> [!NOTE]
>
> Ao marcar uma mensagem como lida, **as mensagens anteriores da mesma conversa também ficam como lidas**. Não é preciso marcar uma por uma.

> [!WARNING]
>
> A mensagem precisa ter sido recebida nos **últimos 30 dias**. Com um `wamid` inválido ou fora do prazo, a Meta responde com o erro `131009` ("Parameter value is not valid").

## Junto com o "digitando"

Para mostrar o aviso de digitação na mesma ação, acrescente o objeto `typing_indicator` a esta chamada. Veja em [Indicador de digitação](https://developers.datafyapi.com.br/api-reference/whatsapp/recursos/indicador-de-digitacao.md).

Veja mais detalhes na [documentação da Meta sobre marcar como lida](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/mark-message-as-read).


## OpenAPI

````yaml api-reference/whatsapp/specs/marcar-como-lida.json POST /v1/{phone_number_id}/messages
openapi: 3.1.0
info:
  title: Datafy API — Marcar como lida
  version: 1.0.0
servers:
  - url: https://cloud.datafyapi.com.br
    description: Produção
security:
  - bearerAuth: []
paths:
  /v1/{phone_number_id}/messages:
    post:
      summary: Marcar como lida
      description: >-
        Marca uma mensagem recebida como lida, exibindo os dois tiques azuis
        para o cliente.
      operationId: marcarComoLida
      parameters:
        - name: phone_number_id
          in: path
          required: true
          schema:
            type: string
          description: ID do número que recebeu a mensagem. Descubra com `GET /me`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MarcarComoLida'
            example:
              messaging_product: whatsapp
              status: read
              message_id: wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjJBQjE=
      responses:
        '200':
          description: Mensagem marcada como lida.
          content:
            application/json:
              example:
                success: true
        '400':
          description: ID de mensagem inválido ou fora do prazo de 30 dias.
          content:
            application/json:
              example:
                error:
                  message: (#131009) Parameter value is not valid
                  type: OAuthException
                  code: 131009
                  fbtrace_id: AbCdEfGhIjK
        '401':
          description: Token ausente ou inválido.
          content:
            application/json:
              example:
                statusCode: 401
                message: Token inválido ou não encontrado.
components:
  schemas:
    MarcarComoLida:
      type: object
      required:
        - messaging_product
        - status
        - message_id
      properties:
        messaging_product:
          type: string
          enum:
            - whatsapp
          default: whatsapp
          example: whatsapp
          description: Sempre `whatsapp`.
        status:
          type: string
          enum:
            - read
          default: read
          example: read
          description: Sempre `read`.
        message_id:
          type: string
          example: wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjJBQjE=
          description: >-
            ID (`wamid`) da mensagem recebida, encontrado no webhook em
            `messages[].id`.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Token gerado no painel da Datafy ao criar o canal. Formato:
        `sk_live_xxx`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.