Perguntas de produto
A fila de perguntas públicas feitas na página de um produto, que a equipe da loja responde, rejeita ou arquiva.
Esta seção cobre a fila de trabalho humano das perguntas públicas: visitantes perguntam na página de um produto ("serve no modelo X?") e a equipe responde, rejeita ou arquiva.
Como funciona
Pergunta pública
pending→answered→archived
status | Significado |
|---|---|
pending | Recebida, ainda sem resposta. Aparece na fila. |
answered | Respondida pela equipe ou pelo seller. A resposta fica pública na página do produto. |
rejected | Moderada como spam ou ofensa. Não aparece ao público. |
archived | Escondida da página do produto. Pode ser respondida depois. |
Quando a loja tem a resposta provisória por IA ligada, o visitante pode ver um rascunho marcado como provisório até a equipe responder (nas rotas de moderação o rascunho aparece no campo ai_draft, separado da resposta oficial answer_text).
Endpoints
| Método e caminho | Para que serve | Autenticação | Página |
|---|---|---|---|
GET /api/v1/admin/product-questions | Lista perguntas | administrador | Perguntas de produto |
PUT /api/v1/admin/product-questions/{id}/answer | Responde | administrador | Perguntas de produto |
PUT /api/v1/admin/product-questions/{id}/reject | Rejeita como spam | administrador | Perguntas de produto |
PUT /api/v1/admin/product-questions/{id}/archive | Arquiva | administrador | Perguntas de produto |
Erros comuns
- Tentar responder uma pergunta já respondida ou rejeitada. Não dá erro: a rota devolve o estado atual sem mudar nada.
- Achar que
rejectearchiveconferem o id. Eles não verificam se a pergunta existe e respondem200mesmo assim.