Marcar Mensagens como Lidas

POST https://pilotstatus.com.br/v1/messages/read

Envia um recibo de leitura (tique azul duplo) para a última mensagem recebida da conversa com to — marcando essa e todas as anteriores como lidas sem enviar mensagem.

Melhor-esforço: a requisição é aceita (200) mesmo quando não há o que confirmar — verifique o campo acked na resposta.

Cabeçalhos

Content-Type: application/json
x-api-key: ps_... (ou x-api-key-id: <api_key_id>) — uma chave com escopo de número

Corpo

string

obrigatório

Telefone do contato em E.164 ou só dígitos (ex.: +5511999999999 ou 5511999999999) — cujas mensagens recebidas marcar como lidas.

Exemplo

curl -X POST "https://pilotstatus.com.br/v1/messages/read" \
  -H "Content-Type: application/json" \
  -H "x-api-key: ps_sua_chave_aqui" \
  -d '{ "to": "5511999999999" }'

Resposta (200)

{ "ok": true, "acked": true }

boolean

Sempre true quando a requisição foi aceita.

boolean

true quando um recibo de leitura foi despachado ao provedor; false quando não havia o que confirmar — veja reason.

string

Presente apenas quando acked é false:

NO_INBOUND_MESSAGE — a conversa não tem mensagem recebida para confirmar.
PII_RELAY_ONLY — o modo de privacidade do número é RELAY_ONLY, então nenhum id de entrada é armazenado.

Comportamento por provedor

Provedor	Como funciona
Meta Cloud API	`status:"read"` da Cloud API na última mensagem recebida (marca essa e todas as anteriores).
Evolution (Pilot Status web / GO)	`POST /message/markread` nativo por uma instância conectada. Evolution V2 não tem endpoint de recibo → `acked:false`.

Erros comuns

Status	Significado
`400`	JSON inválido, `to` ausente, ou a chave não está vinculada a um número (`code: NUMBER_NOT_FOUND`)
`401`	Header de API key ausente/inválido (`x-api-key` / `x-api-key-id`)
`403`	Chave com escopo de tenant usada em endpoint por número
`404`	Nenhuma conversa com `to` (`code: CONVERSATION_NOT_FOUND`)

Visão Geral

Mensagens

Modelos

Números

Conversas & Dados

Webhooks

Chamadas de Voz

Camada de Compatibilidade

Conta & Cobrança

Marca & Incorporação

POST /v1/messages/read — Marcar Mensagens como Lidas

Marcar Mensagens como Lidas

Cabeçalhos

Corpo

Exemplo

Resposta (200)

Comportamento por provedor

Erros comuns

​Marcar Mensagens como Lidas

​Cabeçalhos

​Corpo

​Exemplo

​Resposta (200)

​Comportamento por provedor

​Erros comuns

Marcar Mensagens como Lidas

Cabeçalhos

Corpo

Exemplo

Resposta (200)

Comportamento por provedor

Erros comuns