Módulo opcional. Fale com a OctaSend para ativar. Enquanto o módulo estiver desligado, o item não aparece no menu, as telas mostram Módulo não liberado e a loja não exibe nem recebe avaliações.
Onde fica
De onde vêm as avaliações
Só a avaliação que chega pelo link do pedido recebe o selo Compra verificada, porque ela está ligada a uma compra real.
Configuração
Em E-commerce → Avaliações de produtos → Configuração você define como o módulo funciona. As mudanças só valem depois de clicar em Salvar, e a mensagem Configuração salva confirma. Enquanto você não salvar a configuração nenhuma vez, valem os padrões: nota em estrelas, moderação manual, mídia, resposta e SEO ligados, correspondência por SKU e nenhum site na lista.Nota
Como a nota aparece na loja, no formulário e na página de avaliação do pedido. A tela mostra uma prévia de cada estilo.Moderação
O modo vale para o formulário da loja e para o link pós-compra. Avaliação cadastrada pelo painel entra sempre aprovada.
Recursos
A opção Mostrar aba Dúvidas também fica nesta lista: ligada por padrão, mostra a aba Dúvidas no bloco da loja e aceita perguntas; desligada, a aba some, as perguntas novas deixam de ser aceitas e as já respondidas saem do público (a lista no painel continua). Veja Dúvidas de produtos.
As opções vêm ligadas. Desligar a mídia ou a resposta não apaga nada: ao ligar de novo, as fotos, os vídeos e as respostas voltam a aparecer na loja.
Correspondência de produto
O campo do seu catálogo que identifica o produto: SKU (padrão) ou ID externo. É o valor que você coloca no código da página do produto, e é por ele que a avaliação é associada ao produto certo, que o link pós-compra encontra os itens do pedido e que a aba Avaliações da ficha do produto busca o resumo.Sites que podem ler as respostas do widget
Uma lista de domínios. O navegador só entrega a resposta das avaliações às páginas desses sites.- Os domínios autorizados da instalação (em Configurações → Instalação, a lista que vale para todos os widgets da tag) também valem aqui: as duas listas se somam. Com as duas vazias, qualquer site pode ler.
- Com alguma das listas preenchida, o bloco de avaliações e o selo de nota só carregam nos domínios de uma delas. Veja OctaTag.
- Digite o domínio e adicione. Endereços como
https://www.minhaloja.com.br/produtoeminhaloja.com.brviram a mesma entrada:minhaloja.com.br. - Enquanto houver um domínio inválido no campo, o botão Salvar fica desabilitado.
A lista não é uma trava de envio. Uma avaliação enviada de fora da lista continua sendo gravada. Quem barra envio indevido é a validação, o limite de tentativas e a moderação.
Instalar na loja
As avaliações aparecem na loja pela OctaTag, a mesma tag única que você cola uma vez no site. Com o módulo ativo, a tag já traz as avaliações. Na página do produto, falta só marcar onde elas devem aparecer. Os trechos prontos, já com o campo que a sua conta usa, ficam em E-commerce → Avaliações de produtos → Instalação.1
Instale a OctaTag
Em Configurações → Instalação, copie a tag e cole no
<head> de todas as páginas. Veja OctaTag.2
Marque o lugar do bloco de avaliações
Na página do produto, no ponto onde as avaliações devem aparecer, cole o bloco trocando o valor de exemplo pelo SKU (ou ID externo) daquele produto.
3
Coloque o selo de nota onde quiser
Na vitrine, numa lista de produtos ou perto do preço, use o selo para mostrar só a nota média.
4
Identifique o cliente logado
Depois do login no seu site, chame o
identify. Sem identificação, o formulário de avaliar não aparece (veja Formulário de avaliar abaixo).userIdé o identificador do cliente no seu sistema, nunca um valor gerado pelo OctaSend.namepré-preenche o nome no formulário.- Quem já usa
window.OctaReviews.identifynão precisa mudar: continua funcionando. - O valor do produto não diferencia maiúsculas de minúsculas (
SKU-123esku-123são o mesmo produto) e aceita até 200 caracteres. - Variações. Quando o valor colado é o SKU (ou ID externo) de uma variação (cor, tamanho) e ele está cadastrado em E-commerce → Produtos só com letras minúsculas, números e símbolos, as avaliações enviadas pelo site são somadas ao produto principal. Nos outros casos, as avaliações ficam no próprio valor colado. As avaliações recebidas pelo link pós-compra ficam no produto do item do pedido e não sobem para o produto principal.
- Em sites que trocam de página sem recarregar, a tag encontra sozinha os blocos e selos que aparecem depois.
O que o visitante vê na loja
Só avaliações aprovadas aparecem. O e-mail de quem avaliou nunca é exibido.Bloco de avaliações
- Resumo: nota média, total de avaliações e uma barra por nota (de 5 a 1) com o percentual de cada uma. Sem avaliação aprovada, aparece Ainda não há avaliações.
- Ordenação: Mais recentes (padrão), Maior nota, Menor nota e Com fotos e vídeos. Com Permitir mídia nas avaliações desligado, Com fotos e vídeos ordena como Mais recentes.
- Lista: 10 avaliações por vez. Ver mais avaliações carrega as próximas, sem apagar as que já estão na tela.
- Cada avaliação mostra a nota, o selo Compra verificada quando houver, o título, o texto, o nome de quem avaliou, a data, as miniaturas de fotos e vídeos (clicar abre a mídia em tela cheia por cima da página) e, se você respondeu, a Resposta do lojista com a data. Fotos, vídeos e respostas só aparecem com as opções correspondentes ligadas em Recursos.
- Formulário de avaliar, no fim do bloco.
Selo de nota
- Com avaliações, o selo mostra a média com uma casa decimal e o total, por exemplo
4,7 ★ (128). No estilo Emoji a estrela vira a carinha da nota, e no estilo Número aparece4,7/5 (128). - Sem avaliação aprovada, o selo mostra Seja o primeiro a avaliar.
- Clicar no selo (ou apertar Enter nele) abre a janela Avaliações com o mesmo conteúdo do bloco: resumo, ordenação, lista e formulário.
- Uma vitrine com vários selos busca todas as notas de uma vez.
Formulário de avaliar
Só cliente identificado avalia. Sem oidentify, o lugar do formulário mostra Entre na sua conta para avaliar este produto. Se o login acontecer depois que a página abriu, o formulário aparece sozinho.
Depois de Enviar avaliação:
Uma avaliação por cliente por produto. O mesmo
userId não avalia o mesmo produto duas vezes. Se a avaliação dele for rejeitada, ele pode enviar outra.
Estrelas no Google
Com Incluir avaliações nos dados estruturados (SEO) ligado, o bloco de avaliações publica na página do produto a nota média e o total no formato que o Google usa para mostrar estrelas no resultado da busca. Para não gerar informação duplicada, que o Google penaliza, a publicação só acontece quando:- o produto tem pelo menos uma avaliação aprovada;
- a página ainda não tem uma nota publicada pela própria loja ou pela plataforma de e-commerce.
@id); sem identificador, nada é publicado. Se a página não descreve o produto, a tag publica uma descrição completa com a nota.
O selo de nota sozinho não publica nada para buscadores. Só o bloco de avaliações publica.
A loja pode levar cerca de 1 minuto para refletir uma avaliação aprovada, rejeitada ou respondida. Mudanças na configuração podem levar alguns minutos.
Fotos e vídeos
- Arquivo vazio, com formato não aceito ou acima do limite é recusado antes do envio, com o nome do arquivo na mensagem.
- Os arquivos ficam privados. Na loja, só aparecem os das avaliações aprovadas, e só enquanto Permitir mídia nas avaliações estiver ligado. No painel, você vê a mídia para moderar.
- No painel, se um arquivo não puder ser exibido, o lugar dele mostra Mídia indisponível, para você saber que havia mídia ali.
Pedir avaliação depois da compra
Você pode mandar ao cliente, depois da compra, um link para ele avaliar os produtos do pedido. O link é a variável{{link_avaliacao}}, usada numa comunicação disparada por uma automação com o gatilho Chegou um pedido.
O jeito mais rápido é usar o modelo pronto:
1
Crie a automação pelo modelo
Em Automações, clique em Usar um modelo e escolha Pedir avaliação após a entrega. O OctaSend cria a automação e a comunicação Pedir avaliação após a entrega, com versões de e-mail e WhatsApp que já trazem o
{{link_avaliacao}}.2
Ajuste a situação do pedido
O gatilho vem com a situação
entregue. Troque pela situação que a sua loja usa de verdade para pedido entregue. Sem situação preenchida, o gatilho dispara na primeira vez que o pedido é visto, não na entrega.3
Ajuste a espera
O modelo espera 3 dias depois do gatilho antes de enviar. Mude o passo de espera se quiser dar mais ou menos tempo para o produto chegar e ser usado.
4
Ative
Revise o texto da comunicação e ative a automação.
Os pedidos chegam pela integração da sua loja, como a Nuvem Shop, ou por importação. Veja E-commerce.
Regras do link
- Qualquer canal da comunicação pode levar o link: e-mail, WhatsApp ou outro canal ativo nela. O destinatário é o cliente do pedido.
- O link só é gerado quando alguma mensagem que a automação vai enviar cita
{{link_avaliacao}}: no assunto, no corpo, no título ou no link de clique da notificação. - Um link por pedido, em toda automação do pedido. Se o pedido já tem um link válido e ainda não usado, as outras automações do mesmo pedido reenviam esse mesmo link. Por exemplo, uma automação em “pago” e outra em “entregue” mandam o mesmo
{{link_avaliacao}}. Quando não há link para reaproveitar (ele já foi usado por completo, venceu ou nunca foi enviado), um link novo é gerado na hora. - Validade: por padrão, 30 dias, contados a partir do momento em que o pedido dispara a automação que gerou o link (antes do passo de espera). Um link reenviado por outra automação mantém a validade original.
- Com o módulo desligado, a variável fica vazia e a mensagem sai sem o link, sem erro.
A página de avaliação do pedido
O cliente abre o link no navegador, sem login. A página mostra o nome e o logo da sua conta, a saudação Olá, nome do cliente! e um card para cada produto do pedido.- Aparecem os produtos do pedido que estão no seu catálogo em E-commerce → Produtos. Item que não é encontrado no catálogo fica de fora. Se nenhum for encontrado, a página mostra Nenhum item disponível para avaliação.
- Cada produto tem nota, Título (opcional), Conte como foi sua experiência (opcional) e, com mídia permitida, Adicionar fotos ou vídeos. Os limites de texto e de arquivo são os mesmos do formulário da loja.
- Não há campo de nome: a avaliação é assinada com o nome do cliente do pedido (ou Cliente, se o pedido não tiver nome).
- Enviar avaliações envia de uma vez todos os produtos que receberam nota. É preciso dar nota a pelo menos um.
- O cliente pode avaliar parte dos produtos hoje e voltar depois pelo mesmo link. Produto já avaliado mostra Avaliação enviada. Obrigado!
- Quando todos os produtos do pedido estão avaliados, a página mostra Você já avaliou todos os itens deste pedido. Obrigado! e o link deixa de funcionar.
- Link vencido, já usado por completo ou incompleto mostra Este link não funciona mais.
Moderar
A tela E-commerce → Avaliações de produtos é a fila de moderação.Fila
- Totais: Pendentes, Aprovadas e Rejeitadas.
- Filtros: status (Pendentes, o padrão, Aprovadas, Rejeitadas ou Todas), Produto (SKU) (valor exato do produto, sem diferenciar maiúsculas), nota (Todas as notas ou de 1 a 5 estrelas), Com mídia e busca por título, texto ou autor.
- Colunas: Produto, Autor, Comentário (título e texto), Nota, Mídia (quantidade de arquivos), Status e Recebida em. A mais recente vem primeiro.
- Paginação: 50 avaliações por página, com Anterior e Próxima.
- Em lote: marque as avaliações (ou todas da página pelo cabeçalho) e use Aprovar selecionadas ou Rejeitar selecionadas. Trocar de página ou de filtro desmarca tudo, para você nunca agir sobre avaliações que não está vendo.
Detalhe
Clique no comentário para abrir a avaliação. A tela mostra a nota, o status, a data, o título, o texto, o nome de quem avaliou, o selo Compra verificada quando houver e as fotos e vídeos. Os botões Aprovar e Rejeitar mudam o status. O botão do status atual fica desabilitado.Status
- Você pode mudar de ideia: uma avaliação rejeitada pode ser aprovada depois, e uma aprovada pode ser rejeitada. A nota média do produto é recalculada na hora.
- Não há exclusão. Para tirar uma avaliação da loja, rejeite-a.
- A nota, o título, o texto e o nome escritos pelo cliente não podem ser editados pela sua conta. Se precisar corrigir um dado, fale com a OctaSend.
Responder
Com Permitir resposta pública do lojista ligado, o detalhe da avaliação tem o card Resposta pública: Aparece junto com a avaliação para quem visita a página do produto.- Escreva e clique em Salvar resposta. A mensagem Resposta publicada confirma, e o card passa a mostrar Respondida em com a data.
- Na loja, a resposta aparece embaixo da avaliação como Resposta do lojista, com a data. Ela só fica visível se a avaliação estiver aprovada e enquanto Permitir resposta pública do lojista estiver ligado.
- A resposta não pode ficar vazia. Para mudar, edite o texto e salve de novo: a nova versão substitui a anterior.
Cadastrar avaliação pelo painel
Para registrar uma avaliação que chegou por outro canal (telefone, e-mail, loja física), abra E-commerce → Produtos, entre no produto, vá à aba Avaliações e clique em Nova avaliação.- Clique em Salvar avaliação. A mensagem Avaliação cadastrada confirma.
- A avaliação entra Aprovada na hora, qualquer que seja o modo de moderação, e não recebe o selo Compra verificada.
- O produto é identificado pelo campo da Correspondência de produto. Se o produto não tiver SKU (ou ID externo, conforme a configuração), o botão Nova avaliação fica desabilitado.
Resumo na ficha do produto
A aba Avaliações de cada produto em E-commerce → Produtos mostra a Média, o total de Avaliações e uma barra por nota com o percentual. Contam só as avaliações aprovadas. Sem nenhuma, aparece Nenhuma avaliação ainda. A aba é só de consulta e cadastro: aprovar, rejeitar e responder ficam na fila de moderação. Na lista de E-commerce → Produtos, as visualizações Lista e Grade mostram a nota média ao lado de cada produto que tem avaliações aprovadas. Veja E-commerce. No Dashboard, os gráficos personalizados também podem usar os dados das avaliações de produtos, por exemplo a nota média por mês.Quem pode fazer o quê
Problemas comuns
Aprovei a avaliação, mas ela não aparece na loja
Aprovei a avaliação, mas ela não aparece na loja
Espere cerca de 1 minuto e recarregue a página. Confira também se o valor em
data-octa-reviews é o mesmo SKU (ou ID externo) do produto avaliado, se a loja não tem o script antigo de avaliações e se o domínio da loja está numa das listas de domínios (a da instalação ou a desta tela), quando alguma delas está preenchida.O selo mostra 'Seja o primeiro a avaliar', mas o produto tem avaliações
O selo mostra 'Seja o primeiro a avaliar', mas o produto tem avaliações
O valor em
data-octa-reviews-badge não bate com o produto das avaliações. Confira o campo escolhido em Correspondência de produto e o valor colado no código. Lembre que só avaliações aprovadas contam.O formulário de avaliar não aparece
O formulário de avaliar não aparece
O formulário só aparece para cliente identificado. Sem o
identify com userId, a loja mostra Entre na sua conta para avaliar este produto.A mensagem pós-compra saiu sem o link
A mensagem pós-compra saiu sem o link
O módulo estava desligado ou nenhuma mensagem da automação citava
{{link_avaliacao}}. Um link já enviado por outra automação do mesmo pedido não impede o envio: enquanto ele vale, é reaproveitado.O cliente abriu o link e viu 'Nenhum item disponível para avaliação'
O cliente abriu o link e viu 'Nenhum item disponível para avaliação'
Os produtos do pedido não foram encontrados no catálogo em E-commerce → Produtos, ou o campo de Correspondência de produto está vazio nesses produtos.