Skip to main content
O módulo Avaliações mostra micro-pesquisas no seu site, num card pequeno que abre na hora em que a pessoa está navegando: ao entrar numa página, ao clicar num botão ou quando ela está de saída. Você monta as perguntas no painel, escolhe onde e quando o card aparece e acompanha as respostas numa tela de resultados, com NPS, médias, distribuição por opção, filtro por perfil de quem respondeu e uma leitura das respostas feita por IA.
Módulo opcional — fale com a OctaSend para ativar. Sem ele, o item Avaliações não aparece no menu e o endereço da tela mostra “Módulo não liberado”.
Não confunda com as Avaliações de produtos, que são as notas e comentários dos seus clientes sobre os produtos da loja. Aqui são pesquisas que você faz com quem visita o site.

Antes de começar

  • Tag instalada. O card aparece no site pela tag do OctaSend, a mesma que carrega os Tours e os outros módulos. Para as Avaliações, a tag basta: não há nenhum outro código para colar. Veja OctaTag ou Configurações → Instalação.
  • Domínios autorizados. Se a conta tem uma lista de domínios autorizados, o card só aparece nos domínios dela. Com a lista vazia, aparece em qualquer site. A lista é a mesma de todos os widgets e fica em Configurações → Instalação.
  • Onde fica. Menu lateral Avaliações. A tela se chama Pesquisas.
  • Quem pode usar. Qualquer usuário com acesso ao painel da conta pode criar, editar, publicar e analisar pesquisas.

Do rascunho ao site

1

Criar a pesquisa

Em Avaliações, clique em Nova pesquisa, dê um título, diga em quais páginas ela aparece e quando o card abre. A pesquisa nasce como Rascunho.
2

Montar as perguntas

Na aba Perguntas do editor, adicione as perguntas, escolha o tipo de cada uma e clique em Salvar.
3

Ajustar o gatilho

Na aba Gatilho, refine as páginas, a espera, a frequência, a posição do card e, se quiser, os campos de contexto.
4

Marcar como publicada

Em Dados da pesquisa, mude a Situação para Publicada e clique em Salvar.
5

Publicar

Volte para a lista e clique em Publicar. Só a partir daqui a pesquisa vai para o site.
6

Acompanhar

Abra a aba Resultados da pesquisa para ver os números, as respostas e a análise por IA.

A lista de pesquisas

O topo da tela mostra o que está no ar: “No ar: versão N, publicada em …”, ou “Nada no ar ainda” se a conta nunca publicou. Cada linha da tabela abre o editor da pesquisa.

Criar uma pesquisa

Em Avaliações → Nova pesquisa:
  • Título — obrigatório. Identifica a pesquisa no painel. No card, quem responde vê o título de cada pergunta.
  • Páginas onde aparece — caminho da página, sem o domínio. Vem preenchido com *, que vale para o site inteiro. As regras estão em Páginas, mais abaixo.
  • Quando o card abre — Ao abrir a página, Ao clicar em um elemento ou Ao sair da página.
  • Elemento que abre a pesquisa — só no gatilho por clique, e aí é obrigatório: o seletor CSS do botão ou link do seu site (ex.: #finalizar-compra).
O botão Criar pesquisa só fica ativo com título preenchido, padrão de páginas válido e, no gatilho por clique, o elemento informado. Ao criar, o editor abre para você montar as perguntas.

O editor

No topo ficam o botão Salvar e o bloco Dados da pesquisa, com o Título e a Situação. Abaixo, três abas: Perguntas, Gatilho e Resultados. Salvar grava tudo de uma vez — dados da pesquisa, gatilho, campos de contexto e todas as perguntas. Ou grava tudo, ou não grava nada e a tela avisa; não existe pesquisa salva pela metade. Enquanto você edita, o quadro Corrija antes de publicar lista o que impediria a publicação (título vazio, opção faltando, número fora da faixa etc.). Você pode salvar com a maioria dos avisos pendentes, e a publicação recusa a pesquisa até que eles sejam resolvidos. Duas exceções: no gatilho por clique, o Salvar só funciona com o elemento que dispara preenchido; e uma espera ou um intervalo fora da faixa não é gravado (fica valendo o valor anterior) até ser corrigido.

Perguntas

Na aba Perguntas, a coluna da esquerda lista as perguntas na ordem em que aparecem no card, com botões para subir, descer e remover. Clique numa pergunta para editá-la à direita. Adicionar pergunta cria uma nova no fim da lista, do tipo Nota por estrelas, com o título “Nova pergunta” e marcada como obrigatória.
Adicionar, remover e reordenar perguntas é gravado na hora e recarrega a lista — edições ainda não salvas nas perguntas se perdem. Salve antes. Remover uma pergunta é imediato, sem confirmação, e apaga também as respostas que ela já recebeu.
Toda pergunta tem:
  • Tipo — veja a tabela abaixo.
  • Título — obrigatório, até 500 caracteres. É o texto em destaque no card.
  • Descrição (opcional) — até 500 caracteres, aparece abaixo do título.
  • Resposta obrigatória — o botão de avançar só libera depois que a pessoa responde.
Título e descrição aceitam **negrito** e *itálico*.

Tipos de pergunta

A escala de estrelas e de NPS aceita valores inteiros de 0 a 100, e o menor valor precisa ser menor que o maior.
Mantenha a escala padrão de 0 a 10 nas perguntas de NPS. O score da tela de resultados usa sempre as faixas clássicas — detratores de 0 a 6, neutros 7 e 8, promotores 9 e 10 — e deixa de fazer sentido numa escala diferente.
Cada resposta guarda o valor escolhido naquele momento — no caso das escolhas, o texto da opção. Se você renomear uma opção depois que a pesquisa já recebeu respostas, as antigas continuam contadas com o nome antigo.

Gatilho: onde e quando o card aparece

A aba Gatilho tem dois blocos: Onde e quando aparece e Campos de contexto.

Páginas

Páginas onde aparece compara só o caminho da página — sem domínio, sem parâmetros (?…) e sem âncora (#…). A barra no fim é ignorada. O padrão aceita no máximo 5 asteriscos e 200 caracteres.

Nome da rota (opcional)

Se preenchido, tem prioridade sobre as páginas: a pesquisa só aparece quando o seu site avisar esse nome exato, com window.octasendTours.setRoute('nome'). É o mesmo recurso usado nos Tours, útil quando a tela muda sem o endereço mudar. Até 200 caracteres. Em branco, vale o padrão de páginas.

Quando o card abre

Espera antes de aparecer (ms) atrasa a abertura em qualquer gatilho, de 0 a 60.000 milissegundos (até 1 minuto). Ao fim da espera, a pesquisa confere de novo se ainda pode aparecer — se a pessoa mudou de página ou um tour abriu nesse meio-tempo, o card não abre.
No gatilho por clique, prefira elementos que não levam para outra página. Se o clique navegar para um endereço fora do padrão da pesquisa, o card fecha junto com a navegação.

Frequência

Em Com que frequência: Conta como fechar sem responder: clicar no X do card; em sites de página única (SPA), trocar para uma rota fora do padrão da pesquisa com o card aberto; ou clicar em Enviar sem ter respondido nenhuma pergunta (quando todas são opcionais).
A frequência é controlada no navegador de quem visita. A mesma pessoa em outro aparelho, em outro navegador ou depois de limpar os dados de navegação pode ver a pesquisa de novo.

Posição e convivência com os Tours

Onde o card abre: canto inferior direito (padrão), inferior esquerdo, superior direito, superior esquerdo ou centro da tela.
  • Só um card de pesquisa fica na tela por vez.
  • O card não abre enquanto um tour nos formatos Passo a passo, Destaque único ou Boas-vindas estiver aberto na página, e esses tours não abrem sozinhos enquanto o card estiver na tela.

Campos de contexto

Campos de contexto anexam a cada resposta informações sobre quem respondeu — plano, tipo de conta, e-mail, SKU do produto. O valor aparece junto de cada resposta e vira filtro na tela de resultados. Na aba Gatilho → Campos de contexto, clique em Adicionar campo de contexto e preencha:
  • Nome — letras, números e _, começando por letra ou _ (ex.: plano, tipo_conta). Sem repetição na mesma pesquisa.
  • Seletor (opcional) — define de onde vem o valor:
    • Sem seletor: o valor é lido do objeto window.OCTASEND_CONTEXT, que o seu site declara, no momento em que o card abre.
    • Com seletor: o valor é lido da própria tela — o texto do elemento, ou o conteúdo dele, se for um campo de formulário. O valor lido fica guardado enquanto a pessoa navega, então um dado que aparece numa página pode ir junto com a resposta dada em outra. Entre carregamentos completos de página, isso só acontece quando o site identifica quem está navegando (veja Identificar quem está navegando em Tours); sem identificação, o valor se perde a cada carregamento completo de página. Se o elemento não for encontrado, vale o que estiver em window.OCTASEND_CONTEXT com o mesmo nome.
Exemplo de como o site declara o objeto, antes de a pesquisa abrir:
Regras:
  • No máximo 20 campos por pesquisa.
  • Só entram textos e números; valores vazios, verdadeiro/falso, listas e objetos são ignorados. Cada valor é cortado em 500 caracteres.
  • Só os nomes configurados na pesquisa são gravados — o resto do objeto é descartado.
Campos de contexto podem conter dados pessoais de quem responde (como e-mail). Eles ficam guardados com a resposta e aparecem para quem tem acesso ao painel, mas nunca são enviados para a análise por IA. Colete só o que você realmente vai usar para segmentar.

Descobrir os campos sem sair do editor

Cada linha de campo tem dois botões que buscam a informação direto no seu site:
  • Descobrir chaves — traz os nomes dos campos que o seu site declara em window.OCTASEND_CONTEXT (até 50). Só os nomes voltam para o painel, nunca os valores. Você escolhe qual nome vai naquela linha.
  • Escolher na tela — você clica no elemento que mostra o valor e o seletor dele volta para o campo Seletor. Precisa do Nome preenchido antes.
1

Gerar o link

Clique no botão e informe o Endereço do seu site — uma página onde a pesquisa aparece (ex.: minhaloja.com.br/checkout). O painel monta o link; use Copiar link.
2

Abrir no seu site

Abra o link numa aba. Em Descobrir chaves, os nomes são enviados sozinhos; em Escolher na tela, clique no elemento desejado.
3

Aplicar e salvar

Volte ao painel: o resultado aparece na linha. Escolha a chave ou clique em Usar este seletor e depois em Salvar — o campo só é gravado quando você salva a pesquisa.
  • O link vale por 15 minutos e funciona uma única vez. Expirou ou não trouxe nada? Use Gerar novo link.
  • Só uma busca por vez na tela; Cancelar captura encerra a que está em andamento.
  • A tag do OctaSend precisa estar instalada na página que você abrir. Se nada voltar, ou a tag não está naquela página, ou o objeto window.OCTASEND_CONTEXT está vazio, ou — em Escolher na tela — não foi possível montar um seletor estável para o elemento (prefira um que tenha identificador próprio).

Situação e publicação

Salvar a pesquisa não muda o site. O que vai ao ar é definido pelo botão Publicar, na lista de pesquisas:
  • Cada publicação gera uma versão numerada (“Versão N publicada”), e o site passa a receber a mais recente.
  • Publicar leva ao site todas as pesquisas com Situação Publicada e, se a conta também usa o módulo, todos os tours publicados — juntos, numa versão só.
  • A publicação é tudo ou nada: se uma pesquisa ou um tour tiver problema, nada é publicado e a lista aparece na tela em Corrija antes de publicar. Um tour com erro também segura a publicação das pesquisas.
  • Rascunhos e arquivadas não são conferidos nem publicados.
  • Padrão de páginas vazio, com mais de 5 asteriscos ou com mais de 200 caracteres.
  • Nome da rota com mais de 200 caracteres.
  • Gatilho por clique sem o elemento que dispara.
  • Espera fora de 0 a 60.000 ms, ou intervalo entre convites fora de 1 a 3.650 dias.
  • Campo de contexto sem nome, com nome inválido ou repetido, ou mais de 20 campos.
  • Pesquisa sem nenhuma pergunta.
  • Pergunta sem título, ou com título ou descrição acima de 500 caracteres.
  • Opção, rótulo da escala ou texto de ajuda acima de 200 caracteres.
  • Pergunta de escolha sem nenhuma opção preenchida, ou com mais de 50 opções.
  • Escala com valor que não é inteiro entre 0 e 100, ou com o menor valor igual ou maior que o maior.
  • Tudo o que é publicado (tours e pesquisas da conta) acima de 300 KB.
  • Há itens a corrigir antes de publicar — a lista aparece na tela, em Corrija antes de publicar.
  • Outra publicação aconteceu ao mesmo tempo. Publique de novo. — duas publicações simultâneas; basta publicar outra vez.
  • Esta conta não tem acesso às Avaliações. — o módulo não está ativo na conta.
  • Não foi possível publicar. Tente novamente. — falha temporária.

Tirar uma pesquisa do ar

Mude a Situação para Rascunho ou Arquivada, clique em Salvar e depois em Publicar na lista. Só salvar não tira a pesquisa do site. O painel não tem botão de excluir pesquisa — use Arquivada para as que não vai mais usar. As respostas já recebidas continuam na aba Resultados.

O que o visitante vê

  • Um card com uma pergunta por vez, o título e a descrição da pergunta e, quando há mais de uma, o contador (“1 de 3”).
  • O botão Avançar entre as perguntas e Enviar na última. Em pergunta obrigatória, o botão só libera depois da resposta.
  • Um X para fechar sem responder.
  • Ao enviar, o card fecha. Perguntas opcionais que a pessoa pulou ficam sem resposta.

Aparência

O card tem visual próprio, que não interfere no do seu site. Se a sua conta também tem o módulo Tours, ele herda parte da aparência definida em Tours → Configuração → Aparência padrão: A aparência entra no site na próxima publicação: depois de mudá-la, clique em Publicar.

Resultados

Abra pelo ícone Resultados na lista ou pela aba Resultados do editor.

Números do topo

Filtrar por contexto

Se a pesquisa tem campos de contexto, aparece Filtrar respostas por contexto: escolha o campo, digite o valor exato e clique em Filtrar. O filtro vale para a página inteira — números do topo, distribuição de cada pergunta e lista de respostas. Limpar filtro volta a mostrar tudo. Com filtro ativo, Visualizações continua mostrando o total (visualização não tem contexto) e a Taxa de resposta sai da tela, porque não haveria como calculá-la só para o segmento.

Por pergunta

Pergunta que ninguém respondeu mostra “Ninguém respondeu esta pergunta ainda.”

Lista de respostas

A seção Respostas mostra cada resposta individual, da mais recente para a mais antiga, 50 por vez (Carregar mais respostas traz as seguintes). Cada uma traz:
  • data e hora do envio e o idioma detectado para quem respondeu (pt, en ou es);
  • os campos de contexto e o endereço da página onde a pessoa respondeu;
  • a resposta de cada pergunta — ”—” quando ela pulou a pergunta ou quando a pergunta foi criada depois daquela resposta.
Sem nenhuma resposta, a tela avisa: com a pesquisa publicada, que os números aparecem assim que alguém responder; nas demais situações, que é preciso publicá-la.

Análise por IA

O bloco Análise lê as respostas da pesquisa e escreve, em português, o que elas estão dizendo: um resumo geral e uma Leitura da IA curta embaixo de cada pergunta.
  • Clique em Analisar com IA. A análise leva alguns segundos; a tela mostra “Lendo as respostas e escrevendo a análise”.
  • A análise consome tokens de IA da conta. O limite de tokens é conferido antes de chamar a IA.
  • Há uma análise por pesquisa. Analisar de novo substitui a anterior.
  • O cabeçalho mostra o modelo usado, a data e quantas respostas foram lidas. Se chegaram respostas depois, a tela avisa “Chegaram N respostas depois desta análise”.
  • A análise lê todas as respostas da pesquisa, mesmo com filtro ativo na tela.
  • Entram na análise as contagens de cada pergunta e, nas perguntas de texto livre, até os 300 textos mais recentes. Campos de contexto, endereço da página e identificação do visitante não são enviados.
  • O bloco aparece quando a pesquisa já tem respostas ou uma análise anterior.

Como as respostas são registradas

  • Só são aceitas respostas de pesquisas que estão na versão publicada atual. Depois que uma pesquisa sai do ar, respostas de visitantes com a página antiga aberta são descartadas.
  • Cada resposta é conferida contra a pesquisa publicada: nota fora da escala, opção que não existe e texto vazio são descartados; o resto da resposta é gravado. Um envio sem nenhuma resposta válida não é registrado.
  • Texto livre é gravado com até 2.000 caracteres; o excedente é cortado. Na múltipla escolha, valem até 20 marcações.
  • A mesma pessoa pode responder mais de uma vez quando a frequência permite — cada envio conta como uma resposta.
  • Há um limite de envios por minuto, como proteção contra abuso. Envios acima dele são descartados sem aviso para o visitante.
  • Se o módulo for desativado na conta, as pesquisas deixam de aparecer no site e novas respostas não são registradas.

Limites

Problemas comuns

  • Confira se a Situação é Publicada e se a coluna No ar mostra Em dia. Se mostra Alterações não publicadas, clique em Publicar.
  • Confira Páginas onde aparece: o padrão compara só o caminho, sem domínio. Se há Nome da rota, a pesquisa só aparece quando o site chamar setRoute com esse nome.
  • Com Uma vez por pessoa, quem já viu o card não o vê de novo naquele navegador — teste numa janela anônima.
  • Um tour Passo a passo, Destaque único ou Boas-vindas aberto na página segura o card até terminar.
  • Confira se a tag do OctaSend está instalada naquela página e se o domínio está na lista de domínios autorizados (ou se a lista está vazia).
O seletor em Elemento que dispara precisa corresponder ao elemento clicado ou a um que o contenha. Um seletor inválido não quebra o site: a pesquisa apenas nunca dispara.
Sem seletor, o site precisa declarar window.OCTASEND_CONTEXT com aquele nome antes de o card abrir. Com seletor, o elemento precisa existir e ter texto em alguma página visitada. Valores que não são texto nem número são ignorados.
Adicionar, remover ou reordenar perguntas recarrega a lista e descarta o que não foi salvo. Clique em Salvar antes de mexer na lista.