# Avaliações

As avaliações dos clientes permitem que os compradores classifiquem produtos e compartilhem sua experiência. Cada página de produto exibe uma classificação média em estrelas, o número total de avaliações e a lista de todas as avaliações deixadas por compradores verificados. Os administradores da loja podem navegar e moderar todas as avaliações em um painel dedicado.

## Como funcionam as avaliações

- Apenas clientes que **compraram** o produto podem deixar uma avaliação. O pedido deve estar com status **Paid**, **Shipped** ou **Delivered**.
- Cada cliente pode deixar **uma avaliação por produto**. Eles podem editar ou excluir sua própria avaliação a qualquer momento.
- Uma avaliação consiste em uma **classificação de 1 a 5 estrelas**, um **título** (até 200 caracteres) e um **corpo** (até 2000 caracteres).
- A **classificação média** e a **contagem de avaliações** do produto são recalculadas automaticamente toda vez que uma avaliação é criada, atualizada ou excluída.

> **Dica:** A própria avaliação do cliente fica sempre fixada no topo da lista de avaliações na página do produto, para que ele possa encontrá-la facilmente.

## O que os clientes veem

![Avaliações na página do produto](/features/reviews/storefront-product-reviews.png)

Em cada página de produto, a seção **Customer Reviews** exibe:

- A classificação média em estrelas e o número total de avaliações do produto
- Uma lista de avaliações (5 por página) com o nome do autor, classificação, título, conteúdo e data
- Um rótulo **edited** ao lado de qualquer avaliação que o autor tenha atualizado
- Botões **Edit** e **Delete** ao lado da própria avaliação do cliente
- Um formulário **Write a Review**, mas apenas para clientes autenticados que compraram o produto e ainda não o avaliaram

Clientes que tentam avaliar um produto que não compraram veem a mensagem **"You must purchase this product to leave a review."** Visitantes não autenticados veem **"Sign in to write a review."**

## Moderando avaliações

Abra **Reviews** na barra lateral do admin para ver todas as avaliações deixadas pelos seus clientes.

![Lista de avaliações no admin](/features/reviews/admin-reviews-list.png)

A tabela exibe o produto, título, cliente, classificação e data de cada avaliação. Clique no **nome do produto** para abrir a página do produto em uma nova aba.

| Coluna  | Descrição                                                              |
| ------- | ---------------------------------------------------------------------- |
| Product | O produto avaliado (link para a página da loja)                        |
| Title   | O título que o cliente deu à sua avaliação                             |
| User    | O cliente que deixou a avaliação                                       |
| Rating  | Classificação de 1 a 5 estrelas (ordenável)                            |
| Date    | Quando a avaliação foi criada (ordenável)                              |
| Actions | Menu suspenso com as opções **View Detail** e **Delete**               |

Você pode ordenar por **Rating** ou **Date** clicando no cabeçalho da coluna.

### Filtrando

Clique em **Filter** acima da tabela para filtrar a lista por classificação ou por produto.

![Filtrar avaliações](/features/reviews/admin-reviews-filter.png)

| Filtro  | Opções                                          |
| ------- | ----------------------------------------------- |
| Rating  | 1 ★, 2 ★, 3 ★, 4 ★ ou 5 ★                       |
| Product | Qualquer produto que tenha pelo menos uma avaliação |

Clique em **Save changes** para aplicar os filtros, ou **Clear filters** para redefinir.

### Vendo a avaliação completa

Abra o menu de ações em qualquer linha e escolha **View Detail** para ler a avaliação completa em um diálogo. Isso é útil quando o título ou o corpo é mais longo do que a prévia da tabela.

![Detalhe da avaliação](/features/reviews/admin-reviews-detail.png)

O diálogo mostra a classificação em estrelas, o nome do cliente, o corpo completo da avaliação e a data de criação.

### Excluindo uma avaliação

Para remover uma única avaliação, abra o menu de ações na linha e selecione **Delete**. Um diálogo de confirmação aparecerá antes da exclusão definitiva.

Para remover várias de uma vez, marque as caixas de seleção à esquerda de cada linha para revelar a barra de ações em massa e clique em **Delete Selected**.

![Exclusão em massa de avaliações](/features/reviews/admin-reviews-bulk.png)

> **Importante:** A exclusão de uma avaliação é permanente. Após a exclusão, a classificação média e a contagem de avaliações do produto são recalculadas automaticamente.

## E-mails de solicitação de avaliação

Uma semana após um pedido ser marcado como **Delivered**, o Capyshop envia automaticamente um e-mail ao cliente pedindo que ele avalie os produtos que comprou. O e-mail leva diretamente à página do produto, onde ele pode deixar uma classificação.

Isso dá ao cliente tempo suficiente para realmente usar o produto antes de ser solicitado um retorno e elimina a necessidade de você cobrar avaliações manualmente.

## Dicas

- Filtre regularmente por **1 ★** para identificar problemas de qualidade ou de entrega que os clientes estão sinalizando.
- A classificação em estrelas é armazenada no próprio produto, então aparece instantaneamente em qualquer lugar onde a sua loja exibir produtos — sem necessidade de recálculo manual.
- As avaliações estão vinculadas a compras verificadas, portanto você não precisa moderar spam de visitantes aleatórios.