Perguntas

Q&A das publicações da sua loja. Canal direto entre comprador e seller no detalhe do produto, com moderação antes da publicação.

Conceitos

Status do Q&A:PENDING (em moderação), APPROVED (público) ou REJECTED.

Moderação: toda pergunta nasce PENDING e só fica visível publicamente quando vira APPROVED. O mesmo vale para as respostas da loja: padrão é PENDING, exceto se a loja tem a feature trusted_answers (publica direto como APPROVED).

Escopos:store_questions_read para listar e contar; store_questions_answer para responder.

Listar perguntas

GET/api/seller/interactions/questions

Ordenadas da mais recente para a mais antiga. Retorna perguntas em qualquer status; filtre na UI pelo campo status.

Cada item traz:

• customer: nome e avatar de quem perguntou.
• publication: item_id, título, thumbnail e frontend_url.
• answers[]: respostas já cadastradas com o status de moderação.

Filtros:

Responder

POST/api/seller/interactions/questions/{question_id}/answer

{
  "content": "Sim, este produto é compatível com a versão 2024 e acompanha cabo USB-C."
}

content é obrigatório, mínimo 2 caracteres.

Moderação:

Contador de não respondidas

GET/api/seller/interactions/unanswered-count

{
  "data": {
    "count": 2,
    "oldest_age_hours": 14,
    "deep_link": "/portal/interacoes/perguntas?status=unanswered"
  }
}

Conta apenas perguntas APPROVED que não têm nenhuma resposta APPROVED. Repare que responder não é o suficiente para sair da conta: enquanto sua resposta estiver PENDING (em moderação) ou tiver sido REJECTED, a pergunta segue contando como pendente. Afinal, do ponto de vista do comprador ela ainda está sem resposta visível. O contador zera quando a resposta de fato fica pública.

Erros