Skip to main content
POST
Marcar Mensagens como Lidas
Use este endpoint para marcar até 100 mensagens recebidas como lidas em uma única requisição. As mensagens podem pertencer a conversas diferentes, incluindo grupos, sem custo adicional. Os 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.
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 uma única mensagem, use o endpoint de leitura unitária.
Se a conta do WhatsApp conectada estiver com a confirmação de leitura desativada nas configurações de privacidade, as mensagens são marcadas como lidas 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.

Corpo

application/json
instance_id
string
obrigatório

ID da instância que recebeu as mensagens.

Exemplo:

"ozj35qv418rpmlrb"

ids
string[]
obrigatório

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.

Required array length: 1 - 100 elements
Exemplo:

Resposta

Resultado por mensagem

results
object[]