OneTrace.pro Central de ajuda

Pergunta sobre o produto — respostas da IA na página do produto

“Perguntar à IA sobre o produto” é um bloco na página do produto em que o cliente faz uma pergunta e recebe a resposta na hora: se o tamanho serve, se o pneu tem cravos, se o notebook cabe na mochila. A IA responde com base na descrição e nas características do produto e na base de conhecimento da loja, no idioma da pergunta, e não inventa nada: se a resposta não estiver nos dados, ela diz isso e sugere perguntar a um atendente. O relatório mostra o que os clientes perguntam, o que ficou sem resposta da IA e o que foi comprado depois da pergunta.

Para funcionar, são necessários o rastreador instalado (Conexão do site), o catálogo de produtos com descrições (Recomendações e catálogo de produtos) e um plano pago com saldo disponível; veja Cobrança.

Como a IA responde

A IA vê o produto da página em que a pergunta foi feita:

  • nome, descrição e categorias — no idioma do cliente, se o catálogo tiver tradução;
  • marca, preço, disponibilidade;
  • características do feed e características do setor da loja com seus rótulos; veja Setor da loja.

Sobre entrega, pagamento, devolução, garantia, tamanhos e cuidados, a IA busca a resposta nos artigos e páginas da base de conhecimento — a mesma da IA no chat. Os artigos usados na resposta aparecem como links abaixo dela, se tiverem endereço.

  • Idioma. A resposta vem no idioma da pergunta, mesmo que a descrição do produto esteja em outro idioma: em uma vitrine em alemão, é possível perguntar em inglês.
  • Sem inventar. Se a resposta não estiver no produto nem na base de conhecimento, a IA diz que a loja não informa isso e recomenda perguntar a um atendente. Essa pergunta entra no relatório como pergunta sem resposta.
  • Só sobre o produto e a loja. A perguntas fora do assunto, a IA responde com educação que ajuda apenas com este produto.
  • Repetições. A mesma pergunta sobre um produto que não mudou, no mesmo idioma, é respondida na hora por 24 horas, sem nova chamada ao modelo e sem débito.
  • Frequência. Um visitante pode fazer até 5 perguntas por minuto e até 50 por dia.

Ativação e modos

Abra Site → Pergunta sobre o produto, ative Mostrar o widget no site e escolha o modo:

Modo O que o cliente vê
Bloco na página do produto título, sugestões de perguntas, campo de pergunta e a resposta da IA direto na página do produto; se o chat do site estiver ativado, abaixo da resposta aparece o botão “Perguntar a um atendente”
Botão do chat o botão “Perguntar à IA sobre o produto”, que abre o chat do site: a pergunta vai para o bot ou para um operador, e o produto aparece na conversa; veja Produto no chat. Sem o chat ativado, aparece o bloco

Sugestões de perguntas são três perguntas curtas e típicas sobre os produtos da categoria, por exemplo “Serve para o inverno?”. A IA as cria uma vez por categoria e idioma e as guarda por 30 dias; um clique na sugestão faz a pergunta na hora.

Configurações de “Pergunta sobre o produto”: modo, sugestões, aparência e textos

Se a IA estiver indisponível no momento — sem saldo, com o limite de gastos atingido ou no plano de teste —, aparece um aviso no topo da página, e o bloco simplesmente não é mostrado no site, sem erros para o cliente.

Aparência e textos

Cor define os botões, a borda do campo e os links; Arredondamento dos cantos, os cantos do bloco e dos botões. Os textos padrão estão traduzidos para 10 idiomas e aparecem no idioma do visitante. Textos próprios — Título, Dica no campo, Botão do chat e Observação abaixo da resposta — são definidos separadamente para cada idioma do projeto; um campo vazio mantém o texto padrão.

A pré-visualização no fim da página é o mesmo bloco do site, com um exemplo de resposta: um clique na sugestão mostra como a resposta fica.

Pré-visualização do bloco com sugestões e um exemplo de resposta

Código no site

Insira o elemento no ponto da página do produto onde o bloco deve ficar — normalmente abaixo do botão “Adicionar ao carrinho”:

<div data-cdp-ask data-product-id="SKU-123"></div>

data-product-id é o id do produto no catálogo, o mesmo product_id dos eventos de visualização e de compra. O rastreador encontra o elemento sozinho — tanto no carregamento quanto quando ele aparece depois — e desenha o bloco só se o widget estiver ativado. Enquanto ele estiver desativado, o elemento fica vazio, então o código pode ser colocado com antecedência. Para desativar o bloco no site inteiro, use cdp.init(key, { ask: false }).

Os plugins para lojas colocam o bloco sozinhos:

Plataforma Como
WooCommerce WooCommerce → Settings → OneTrace.pro → Show "Ask AI about this product" on product pages (ativado): bloco após o formulário de compra em temas clássicos e de blocos; o shortcode [onetrace_ask] coloca o bloco em outro lugar
Magento 2 Stores → Configuration → OneTrace.pro → What to send: bloco após o formulário de compra
1C-Bitrix configuração do site Show “Ask AI about this product” on product pages: bloco abaixo dos botões de compra dos templates padrão catalog.element; o componente onetrace:product.ask serve para templates próprios
Laravel componente <x-onetrace::ask :product="$product->sku" />

Descrição do produto

Quanto mais detalhada a descrição, mais perguntas a IA responde. A descrição vem com o catálogo:

  • YML — <description>, Google Merchant — g:description, CSV e JSON — coluna description (também desc, описание);
  • API — campo items[].description, traduções — translations.{idioma}.description;
  • os plugins para lojas enviam a descrição do produto sozinhos.

O HTML é convertido em texto, e são considerados os primeiros 5000 caracteres. Uma boa descrição responde às perguntas frequentes: material e composição, medidas e caimento, compatibilidade, cuidados, itens inclusos. Quais perguntas ficam sem resposta, você vê no relatório.

Produto no chat

Quando o cliente abre o chat do site a partir do bloco — pelo botão do modo “Botão do chat” ou por “Perguntar a um atendente” abaixo da resposta —, o produto vai para a conversa junto com as mensagens, e a pergunta é colocada no campo de digitação.

  • O operador vê no topo da conversa o cartão do produto — imagem, nome, preço e a marcação “esgotado”, se o produto não estiver disponível; uma mensagem enviada da página de outro produto recebe a legenda: da página de “…”.
  • O bot e o rascunho da IA recebem o cartão atualizado do produto — preço e disponibilidade no momento — e respondem levando em conta o que está sendo perguntado.

Conversa com o produto no topo: pergunta da página do produto e resposta do bot

Relatório

No topo da página Pergunta sobre o produto fica o relatório de 7, 30 ou 90 dias:

  • Perguntas e Com resposta — quantas perguntas foram feitas e que parte recebeu resposta com base nos dados;
  • Visitantes e Produtos — quantas pessoas diferentes perguntaram e sobre quantos produtos;
  • Compras e Receita — o mesmo cliente comprou o produto sobre o qual perguntou em até 7 dias; a receita é calculada pelo preço do produto no catálogo. Aparecem se o evento de compra estiver definido nas configurações de recomendações;
  • Gasto — quanto foi debitado do saldo pelas respostas;
  • gráfico de perguntas e de perguntas sem resposta por dia.

Relatório: indicadores, gráfico por dia e produtos com perguntas

Tabelas abaixo do gráfico:

Tabela O que contém
Produtos produtos por número de perguntas, primeiro os que têm perguntas sem resposta: vale completar a descrição deles
Perguntas frequentes perguntas feitas pelo menos duas vezes, sem diferenciar maiúsculas e espaços — na maioria das vezes, são as sugestões de perguntas
Sem resposta as últimas 50 perguntas sem resposta, com o que a IA respondeu: uma pista de qual artigo adicionar à base de conhecimento

Dados pessoais no texto das perguntas — telefones, e-mails, números de cartão — são mascarados ao serem gravados.

Cobrança

As respostas são cobradas da mesma forma que a IA no chat: cada resposta custa de acordo com o volume de texto (tokens) processado pelo modelo, com a margem da plataforma, e é debitada do saldo do projeto. Respostas do cache a perguntas repetidas são gratuitas. Funciona em qualquer plano pago; no período de teste, sem saldo ou com o limite de gastos atingido, o bloco não é mostrado no site.

Eventos e segmentos

Evento Propriedades
$product_question product_id, answered — se a IA respondeu com base nos dados, language
$chat_message em uma mensagem da página de um produto, também product_id

Os eventos entram no perfil do cliente e ficam disponíveis em segmentos e jornadas: por exemplo, “perguntou sobre o produto, mas não comprou em 3 dias” é um bom motivo para lembrar do produto por e-mail.