Meus pedidos
O elemento Meus pedidos permite que o cliente avalie produtos diretamente na página de histórico de pedidos da loja, sem precisar acessar a página de detalhes do produto. A identidade do usuário é resolvida automaticamente pelo SDK, sem necessidade de expor dados sensíveis na URL.
Avaliação de pedido completo
Use este elemento quando quiser exibir um único botão de avaliação para o pedido inteiro. O modal abrirá o fluxo completo de avaliação, permitindo ao cliente avaliar todos os produtos do pedido.
<div
class="konfidency-rate-order"
data-order-id="{ORDER_ID}"
></div>
Enquanto a verificação de status é realizada, um spinner é exibido. Após a verificação:
- Se o pedido ainda não foi avaliado, exibe o botão "Quero avaliar"
- Se o pedido já foi avaliado na íntegra, exibe o badge "Já avaliado"
Avaliação por item (SKU)
Quando o data-sku é fornecido, o elemento passa a operar no modo de item específico, ideal para renderizar um elemento de avaliação por linha de produto na listagem de pedidos.
Neste modo, há dois estilos de exibição disponíveis através do atributo data-display:
Estrelas interativas (data-display="stars")
<div
class="konfidency-rate-order"
data-order-id="{ORDER_ID}"
data-sku="{SKU}"
data-display="stars"
></div>
Exibe 5 estrelas interativas. Ao clicar em uma estrela, o modal abre com a nota pré-selecionada. Se o item já foi avaliado, as estrelas são exibidas em modo somente leitura com a nota dada pelo cliente.
Botão (data-display="button")
<div
class="konfidency-rate-order"
data-order-id="{ORDER_ID}"
data-sku="{SKU}"
data-display="button"
></div>
Exibe o botão "Quero avaliar". Se o item já foi avaliado, exibe o badge "Já avaliado" no lugar do botão.
Atributos disponíveis
| Atributo | Obrigatório | Descrição |
|---|---|---|
data-order-id | Sim | ID do pedido na plataforma |
data-sku | Não | SKU do produto. Quando ausente, o elemento opera no modo de pedido completo |
data-display | Não | Estilo de exibição no modo SKU: stars (padrão) ou button |
Identificação do usuário
Para que o SDK consiga localizar o pedido, informe os dados do usuário via window._konfidency:
window._konfidency = window._konfidency || [];
window._konfidency.push(['setUser', { userId: '{USER_ID}', email: '{USER_EMAIL}' }]);
Você pode fornecer userId, email, ou ambos em setUser. Quanto mais informações, maior a confiabilidade na localização do pedido.
Substitua {ORDER_ID}, {SKU}, {USER_ID} e {USER_EMAIL} pelos valores reais da sua plataforma.