Entregue e lida
Marca as mensagens recebidas como entregues ou lidas, para o outro lado ver os tiques de confirmação.
Quando a tela do cliente carrega as mensagens, ela deve avisar a plataforma duas coisas: que as mensagens chegaram (entregues) e, quando o cliente de fato as vê, que foram lidas. A plataforma grava o horário e avisa quem enviou por WebSocket, para o app dele trocar um tique por dois e depois pintar de azul.
/api/v1/storefront/messages/threads/{id}/deliveredClienteMarcar mensagens como entregues
Parâmetros de caminho
iduuidobrigatórioId da thread.
Exemplo de requisição
bash
curl -X PATCH "$BASE_URL/api/v1/storefront/messages/threads/$THREAD_ID/delivered" \
-H "Authorization: Bearer $TOKEN"Resposta
200Entregas registradas
json
{ "message": "marked as delivered", "count": 2 }Campos da resposta
messagestringTexto fixo
marked as delivered (em inglês, como o servidor devolve).countintegerQuantas mensagens passaram a entregues nesta chamada.
/api/v1/storefront/messages/threads/{id}/readClienteMarcar mensagens como lidas
Parâmetros de caminho
iduuidobrigatórioId da thread.
bash
curl -X PATCH "$BASE_URL/api/v1/storefront/messages/threads/$THREAD_ID/read" \
-H "Authorization: Bearer $TOKEN"200Leituras registradas
json
{ "message": "marked as read", "count": 2 }Campos da resposta
messagestringTexto fixo
marked as read (em inglês, como o servidor devolve).countintegerQuantas mensagens passaram a lidas nesta chamada.
Erros
As duas rotas têm os mesmos erros.
| Status | Quando | Corpo |
|---|---|---|
| 400 | id não é UUID. | {"error":"invalid id","detail":"id must be a valid UUID"} |
| 401 | Sem token, ou token inválido. | {"error":"missing authorization header"} |
| 403 | A thread não é do cliente (ou não existe). | {"error":"you are not a participant of this thread"} |
| 500 | Falha ao gravar. | {"error":"failed to mark read","detail":"..."} (ou failed to mark delivered) |