Marcar Mensagens como Lidas (Lote)
Marca até 100 mensagens recebidas como lidas em uma única requisição. As mensagens podem pertencer a conversas diferentes.
O resultado é discriminado por mensagem: read (lida), ignored (mensagem enviada pela própria instância, sem leitura a confirmar) ou not_found (mensagem fora do prazo de leitura ou nunca processada pela instância).
ids são os mesmos recebidos nos webhooks de mensagem, como o campo data.id do evento message.received. Requisições com mais de 100 IDs retornam erro de validação.
A resposta discrimina o resultado por mensagem no campo results, nunca um sucesso genérico:
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 uma única mensagem, use o endpoint de leitura unitária.
Autorizações
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Corpo
ID da instância que recebeu as mensagens.
"ozj35qv418rpmlrb"
IDs das mensagens a marcar como lidas. É o mesmo id recebido nos webhooks de mensagem (por exemplo, no evento message.received). Limite de 100 por requisição.
1 - 100 elementsResposta
Resultado por mensagem