> ## Documentation Index > Fetch the complete documentation index at: https://docs.octasend.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Avaliações de produtos > Colete avaliações dos seus produtos na loja e depois da compra, modere, responda e mostre nota, fotos e vídeos na página do produto A **Avaliação de Produtos** coloca na sua loja o que os clientes acharam de cada produto: nota de 1 a 5, título, texto, fotos e vídeos. As avaliações chegam pelo formulário da própria loja, pelo link enviado depois da compra ou pelo cadastro da sua equipe no painel. Você modera e responde tudo no OctaSend, e só o que foi aprovado aparece para quem visita a loja. O mesmo bloco da loja traz também a aba **Dúvidas**, onde o cliente pergunta e você responde: veja [Dúvidas de produtos](https://docs.octasend.com.br/plataforma/duvidas-de-produto.md). > [!NOTE] > > **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. > [!TIP] > > Não confunda com [Avaliações](https://docs.octasend.com.br/plataforma/avaliacoes.md), que são pesquisas exibidas no seu site. Por isso o item deste módulo no menu se chama **Avaliações de produtos**. ## Onde fica | Onde | O que você faz | | - | - | | **E-commerce → Avaliações de produtos** | Fila de moderação, com os botões **Instalação** e **Configuração** no topo. | | **E-commerce → Avaliações de produtos → Configuração** | Estilo da nota, moderação, recursos, correspondência de produto e sites autorizados. | | **E-commerce → Avaliações de produtos → Instalação** | Os trechos de código para mostrar as avaliações na loja. | | **E-commerce → Produtos →** um produto **→ aba Avaliações** | Resumo das avaliações do produto e o botão **Nova avaliação**. | | **E-commerce → Dúvidas de produtos** | Lista de perguntas dos clientes (pendentes, respondidas e ocultas) e tela para responder. | ## De onde vêm as avaliações | Origem | Quem avalia | Como entra | Selo **Compra verificada** | | - | - | - | - | | **Formulário na loja** | Cliente identificado no seu site | Conforme o modo de moderação | Não | | **Link de avaliação pós-compra** | Cliente que recebeu o link do pedido | Conforme o modo de moderação | Sim | | **Cadastro pelo painel** | Sua equipe | Sempre **Aprovada** | Não | 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. | Estilo | Como aparece | | - | - | | **Estrelas** (padrão) | Cinco estrelas, cheias até a nota. | | **Emoji** | Uma carinha que vai de triste (nota 1) a feliz (nota 5). | | **Número** | A nota em número, seguida de `/5`. | ### Moderação | Modo | O que acontece com a avaliação nova | | - | - | | **Manual** (padrão) | Toda avaliação entra **Pendente** e só aparece na loja depois que alguém aprovar. | | **Automática** | A avaliação entra **Aprovada** e aparece na loja na hora. | | **Só com mídia** | Avaliação sem foto ou vídeo entra **Aprovada**. Avaliação com foto ou vídeo entra **Pendente**. | 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 | Opção | Ligada | Desligada | | - | - | - | | **Permitir mídia nas avaliações** | O formulário da loja e a página de avaliação do pedido aceitam fotos e vídeos. | O campo de arquivo some e as fotos e vídeos das avaliações deixam de aparecer na loja. A ordenação **Com fotos e vídeos** passa a mostrar as avaliações como **Mais recentes**. | | **Permitir resposta pública do lojista** | O card **Resposta pública** aparece no detalhe de cada avaliação. | O card some do painel e as respostas já publicadas deixam de aparecer na loja. | | **Incluir avaliações nos dados estruturados (SEO)** | A página do produto recebe a nota média no formato que o Google lê para mostrar estrelas na busca. Veja *Estrelas no Google* abaixo. | Nada é publicado para buscadores. | 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](https://docs.octasend.com.br/plataforma/duvidas-de-produto.md). 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. > [!WARNING] > > Trocar o campo depois de já ter avaliações não converte as antigas: elas continuam guardadas com o valor do campo anterior. Escolha o campo antes de instalar na loja. ### 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](https://docs.octasend.com.br/plataforma/octatag.md). * Digite o domínio e adicione. Endereços como `https://www.minhaloja.com.br/produto` e `minhaloja.com.br` viram a mesma entrada: `minhaloja.com.br`. * Enquanto houver um domínio inválido no campo, o botão **Salvar** fica desabilitado. > [!NOTE] > > 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](https://docs.octasend.com.br/plataforma/octatag.md), 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 `` de todas as páginas. Veja [OctaTag](https://docs.octasend.com.br/plataforma/octatag.md). **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). ```html Bloco de avaliações theme={null}
``` ```html Selo de nota theme={null}
``` ```html Identificar o cliente theme={null} ``` * `userId` é o identificador do cliente no **seu** sistema, nunca um valor gerado pelo OctaSend. `name` pré-preenche o nome no formulário. * Quem já usa `window.OctaReviews.identify` não precisa mudar: continua funcionando. * O valor do produto não diferencia maiúsculas de minúsculas (`SKU-123` e `sku-123` sã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. > [!WARNING] > > Se a sua loja ainda tem o script antigo de avaliações, retire-o depois de instalar a tag. Enquanto ele estiver na página, é ele que mostra as avaliações e a tag não desenha nada ali. Com os dois na página, nada aparece em dobro. ## 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. Se as avaliações não carregarem, o bloco mostra **Não foi possível carregar as avaliações agora.** com o botão **Tentar novamente**, e tenta sozinho de novo algumas vezes. Uma falha nunca aparece como "0 avaliações". ### 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** aparece `4,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 o `identify`, 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. | Campo | Regra | | - | - | | Nota | Obrigatória, de 1 a 5, no estilo da configuração. | | **Seu nome** | Obrigatório, até 80 caracteres. Vem preenchido com o `name` do `identify`, e o cliente pode editar. | | **Título (opcional)** | Até 120 caracteres. | | **Conte como foi sua experiência (opcional)** | Até 4.000 caracteres. | | **Fotos ou vídeos (opcional)** | Só aparece com **Permitir mídia nas avaliações** ligado. Veja os limites em *Fotos e vídeos*. | Depois de **Enviar avaliação**: | Situação | Mensagem para o cliente | | - | - | | Entrou pendente | **Avaliação enviada! Ela será publicada assim que for revisada.** | | Entrou aprovada | **Avaliação publicada. Obrigado por avaliar!** | | Já avaliou este produto | **Você já avaliou este produto.** | | Muitos envios em pouco tempo | **Muitas tentativas em pouco tempo. Aguarde um instante e tente novamente.** | | Não deu para confirmar o envio | **Não conseguimos confirmar se sua avaliação foi enviada. Recarregue a página antes de tentar de novo.** | **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. Se a página já descreve o produto para buscadores, a nota é somada a essa descrição quando ela tem um identificador (`@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. > [!NOTE] > > 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 | Regra | Limite | | - | - | | Arquivos por avaliação | Até 5 | | Imagens | JPEG, PNG ou WebP, até 10 MB cada | | Vídeos | MP4, WebM ou MOV (QuickTime), até 50 MB cada | * 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](https://docs.octasend.com.br/plataforma/automacoes.md) 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. > [!NOTE] > > Os pedidos chegam pela integração da sua loja, como a [Nuvem Shop](https://docs.octasend.com.br/integracoes/nuvemshop.md), ou por importação. Veja [E-commerce](https://docs.octasend.com.br/plataforma/ecommerce.md). ### 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**. As avaliações feitas pelo link seguem o modo de moderação, recebem o selo **Compra verificada** e valem uma por produto por pedido. ## 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 | Status | Na loja | Conta na nota média | | - | - | - | | **Pendente** | Não aparece | Não | | **Aprovada** | Aparece | Sim | | **Rejeitada** | Não aparece | Não | * 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**. | Campo | Regra | | - | - | | **Nota** | Obrigatória, de 1 a 5. | | **Nome do avaliador** | Obrigatório, até 80 caracteres. Um nome maior é recusado com o aviso **O nome do avaliador pode ter até 80 caracteres.** | | **E-mail (opcional)** | Não aparece na loja. | | **Comentário** | Opcional, até 4.000 caracteres. | | **Fotos ou vídeos (opcional)** | Mesmos limites de *Fotos e vídeos*. Só funciona com **Permitir mídia nas avaliações** ligado. | * 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](https://docs.octasend.com.br/plataforma/ecommerce.md#produtos). No [Dashboard](https://docs.octasend.com.br/plataforma/dashboard.md), 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ê | Ação | Quem | | - | - | | Ativar o módulo | A OctaSend, a pedido da sua conta | | Moderar, responder, cadastrar pelo painel e alterar a configuração (responder, ocultar e mostrar dúvidas exige a permissão **Moderar** da página no perfil de acesso) | Usuários da sua conta com a permissão correspondente | | Enviar avaliação pelo formulário da loja | Cliente identificado no seu site | | Enviar avaliação pelo link do pedido | Quem tem o link | | Corrigir nota, título, texto ou nome de uma avaliação | Só a equipe da OctaSend | ## Problemas comuns > [accordion] 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. > [accordion] 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. > [accordion] 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.** > [accordion] 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. > [accordion] 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.