Skip to main content
POST
Marcar Mensagem como Lida
Use este endpoint para marcar uma mensagem recebida como lida sob demanda. Ele é o complemento ideal da leitura automática desligada: seu sistema decide o momento certo de confirmar a leitura, por exemplo depois que um atendente responde ao cliente. O id da mensagem é o mesmo recebido nos webhooks de mensagem, como o campo data.id do evento message.received. A instância pode ser informada pelo campo instance_id no corpo ou pelo cabeçalho X-Instance-Id. A resposta traz o resultado da operação no campo status:
  • read: a mensagem foi marcada como lida.
  • ignored: a mensagem foi enviada pela própria instância, então não há leitura a confirmar.
  • not_found: a mensagem está fora do prazo de leitura (veja abaixo) ou nunca foi processada pela instância.

Prazo para marcar como lida

Cada mensagem fica disponível para leitura por um período limitado depois que chega na instância:
  • Conversas individuais e grupos: até 3 dias após o recebimento da mensagem.
  • Status: até 24 horas após a publicação, o mesmo período em que o status fica visível no WhatsApp.
Depois desse prazo o retorno para aquele ID é not_found. Isso não indica uma falha na instância: a janela de leitura expirou e a confirmação não pode mais ser enviada. Para marcar várias mensagens de uma vez, use o endpoint de leitura em lote.
Se a conta do WhatsApp conectada estiver com a confirmação de leitura desativada nas configurações de privacidade, a mensagem é marcada como lida apenas localmente e o remetente não vê o tique azul.
Este endpoint está disponível apenas para instâncias não oficiais. Instâncias com API oficial (WABA) retornam erro por enquanto.

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Cabeçalhos

X-Instance-Id
string

ID da instância que recebeu a mensagem. Alternativa ao campo instance_id do corpo da requisição.

Parâmetros de caminho

id
string
obrigatório

ID da mensagem a marcar como lida. É o mesmo id recebido nos webhooks de mensagem (por exemplo, no evento message.received).

Corpo

application/json
instance_id
string

ID da instância que recebeu a mensagem. Pode ser omitido quando o cabeçalho X-Instance-Id for informado.

Exemplo:

"ozj35qv418rpmlrb"

Resposta

Resultado da leitura

id
string

ID da mensagem processada.

Exemplo:

"3EB0538DA65A59F6D3A926"

status
enum<string>

Resultado da operação:

  • read - A mensagem foi marcada como lida.
  • ignored - A mensagem foi enviada pela própria instância e não possui leitura a confirmar.
  • not_found - A mensagem está fora do prazo de leitura (até 3 dias para conversas e grupos, até 24 horas para status) ou nunca foi processada pela instância.
Opções disponíveis:
read,
ignored,
not_found
Exemplo:

"read"