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”.
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 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. 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.
**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.
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, comwindow.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.
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_CONTEXTcom o mesmo nome.
- Sem seletor: o valor é lido do objeto
- 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.
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_CONTEXTestá 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.
O que impede a publicação de uma pesquisa
O que impede a publicação de uma pesquisa
- 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.
Mensagens de erro ao publicar
Mensagens de erro ao publicar
- 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.
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
A pesquisa não aparece no site
A pesquisa não aparece no site
- 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
setRoutecom 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 gatilho por clique não dispara
O gatilho por clique não dispara
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.
Os campos de contexto chegam vazios
Os campos de contexto chegam vazios
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.Perdi as edições de uma pergunta
Perdi as edições de uma pergunta
Adicionar, remover ou reordenar perguntas recarrega a lista e descarta o que não foi salvo. Clique em Salvar antes de mexer na lista.