Central de Ajuda Ir para o site da Olist Meus chamados

Integração com a Trustvox (RA Reviews)

A confiança é um dos fatores mais determinantes na decisão de compra. Exibir avaliações e opiniões reais de consumidores na sua loja virtual aumenta a credibilidade da marca, melhora a taxa de conversão e traz insumos valiosos para aprimorar a experiência do seu e-commerce.

A Trustvox (RA Reviews) é uma ferramenta de feedback que exibe a nota média do Reclame AQUI, coleta opiniões de produtos e disponibiliza campos de perguntas e respostas diretamente na sua página de produto.

Neste artigo, você aprende como contratar e configurar a integração no painel administrativo do Ecommerce Olist, além do procedimento para mapear e migrar o histórico de avaliações dos seus produtos.

Pré-requisitos para integração

Antes de iniciar a configuração no seu painel, certifique-se de cumprir os seguintes requisitos:

  1. Assinatura da Trustvox: possuir um plano ativo na Trustvox / RA Reviews.
  2. Credenciais de acesso: ter em mãos o ID da Loja e o Token API gerados no painel da Trustvox (localizados em Configurações > Integração/API).
  3. Definição de layout: escolher o modelo de exibição dos widgets desejado dentro das opções oferecidas pelo seu plano Trustvox.

Como configurar a integração no painel do Ecommerce Olist

A ativação do serviço exige a configuração das credenciais no painel administrativo e a implementação do layout realizada pela equipe ou agência de front-end responsável pelo seu e-commerce.

Passo 1: Inserção das credenciais no painel

  1. Acesse o painel administrativo do seu Ecommerce Olist.
  2. No menu lateral, navegue até Configurações > Soluções / Aplicações > Avaliações.
  3. Localize o card da Trustvox (RA Reviews) e clique em Configurar ou Ativar.
  4. Insira os dados solicitados:
  • ID da Loja (Trustvox Store ID)
  • Token de Integração (API Token)
  1. Selecione o status de disparo de pedidos (exemplo: Enviado ou Entregue) no qual o e-mail automático da Trustvox deve ser acionado para solicitar a avaliação.
  2. Clique em Salvar Alterações.
 
 

Passo 2: Solicitação de instalação e homologação de layout 

Para garantir que os blocos de estrelas, widgets e selos da Trustvox sejam exibidos corretamente no layout do seu e-commerce, a implementação técnica no código do site deve ser realizada diretamente pela sua agência de sustentação de front-end ou desenvolvedor responsável.

  1. Encaminhamento dos scripts: envie os códigos de integração gerados no painel da Trustvox e a documentação técnica para a equipe/agência de front-end responsável pela sua loja.
  2. Definição dos locais de exibição: oriente o desenvolvedor sobre onde os componentes devem ser posicionados:
  • Página do Produto (PDP): bloco de avaliações completo e widget de estrelas próximo ao título/preço.
  • Vitrine (Listagem de Produtos): módulo resumido de estrelas nos cards dos produtos.
  • Rodapé (Footer): selo de reputação e garantia de loja auditada.
  1. Validação e homologação: após a inserção do código pela agência, navegue pela loja para homologar o carregamento e alinhamento visual dos blocos.

Atenção: ajustes e edições no código de front-end do e-commerce não são realizados internamente pelo nosso time de suporte, devendo ser contratados ou executados pela sua agência parceira. 

 
 
 

Processo de mapeamento de IDs de produtos (Migração de avaliações)

Se você está mudando de plataforma e deseja manter o histórico de avaliações da Trustvox, é necessário realizar o mapeamento DE > PARA dos IDs de produtos. Esse processo garante que as avaliações antigas sejam vinculadas aos novos produtos cadastrados no Olist.

Passo 1: Gerar a planilha no painel da Trustvox (Ação do cliente)

 Antes ou durante a migração, exporte o relatório de produtos:

  1. Acesse o painel RA Reviews / Trustvox.
  2. No menu lateral esquerdo, clique em Exportar dados.
  3. Clique no botão Novo Relatório.
  4. Configure os filtros:
  • Tipo de relatório: Todos os produtos da empresa
  • Período: Todo o período
  1. Clique em Gerar relatório.
  2. Faça o download da planilha enviada para o seu e-mail ou disponível na aba de relatórios.
 
 

Passo 2: Envio da planilha para mapeamento Olist (Ação do cliente + Olist)

  1. Envie o arquivo baixado (.xlsx) para ajuda.ecommerce@olist.com solicitando o mapeamento dos novos IDs.
  2. Nossa equipe preencherá a coluna correspondente (Coluna C - Novo código do produto) com os IDs oficiais gerados no Olist.
  3. Assim que concluído, nossa equipe responderá ao chamado devolvendo a planilha preenchida.
 
 

Passo 3: Atualização final dos IDs na Trustvox (Ação do cliente)

Com a planilha DE > PARA preenchida e devolvida pelo Olist:

  1. Acesse o painel da Trustvox e vá em Dúvidas e Suporte > Ajuda > Fale com a gente.
  2. Abra um chamado no chat solicitando a Atualização de IDs de Produtos por Migração.
  3. Anexe a planilha (.xlsx) atualizada pela equipe Olist.
  4. A equipe Trustvox executará a migração das avaliações para os novos IDs.
 
 

Regras e recomendações para a planilha DE > PARA

Durante o preenchimento da planilha:

  • Utilização de ID de Produto: o mapeamento utiliza obrigatoriamente o ID do produto, e não o SKU.
  • Preservação da estrutura: não altere a ordem das colunas, fontes, cores ou formato original da planilha (mantenha o formato .xlsx).
  • Descontinuação de produtos: caso algum produto não vá para a nova loja, a linha do novo ID pode ser deixada em branco para que seja arquivado.
  • Mesclagem de variações: caso queira consolidar avaliações de variações (como cores ou tamanhos) em um único produto principal, repita o mesmo ID novo nas linhas correspondentes.

Elementos visuais exibidos na loja

 Após a conclusão da integração e da migração, os seguintes componentes ficarão disponíveis para os visitantes da sua loja:

  • Estrelas de Avaliação: exibe a pontuação média do produto em estrelas. Recomendado abaixo ou ao lado do título do produto na página de produto e na vitrine.
  • Widget de Opiniões: bloco completo contendo comentários, notas e fotos enviadas por compradores reais. Recomendado abaixo da descrição detalhada do produto.
  • Perguntas e Respostas: campo para dúvidas diretas dos clientes sobre o item. Recomendado junto ao bloco de avaliações do produto.
  • Selo / Nota Reclame AQUI: selo de reputação e autenticidade emitido pela RA Reviews. Recomendado no rodapé (footer) ou na página do carrinho/checkout.

Suporte e canais de atendimento

  • Dúvidas sobre o Ecommerce Olist ou mapeamento de IDs: entre em contato com a equipe de suporte através do e-mail ajuda.ecommerce@olist.com.
  • Dúvidas sobre a plataforma Trustvox / RA Reviews: acesse o painel da ferramenta, clique no ícone (?) no canto superior direito e selecione Fale com a gente (atendimento de segunda a sexta, das 9h às 18h).

Sua dúvida foi esclarecida?