Marcar Mensagem como Lida
Marca uma mensagem recebida como lida sob demanda. Útil quando a leitura automática está desligada e o seu fluxo decide o momento certo de confirmar a leitura (por exemplo, depois que um atendente responde).
A instância pode ser informada pelo campo instance_id no corpo da requisição ou pelo cabeçalho X-Instance-Id.
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.
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.
Autorizações
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Cabeçalhos
ID da instância que recebeu a mensagem. Alternativa ao campo instance_id do corpo da requisição.
Parâmetros de caminho
ID da mensagem a marcar como lida. É o mesmo id recebido nos webhooks de mensagem (por exemplo, no evento message.received).
Corpo
ID da instância que recebeu a mensagem. Pode ser omitido quando o cabeçalho X-Instance-Id for informado.
"ozj35qv418rpmlrb"
Resposta
Resultado da leitura
ID da mensagem processada.
"3EB0538DA65A59F6D3A926"
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.
read, ignored, not_found "read"