O widget é a pesquisa rodando dentro do seu próprio site, sem depender de o cliente abrir um e-mail. Você cola um trecho de código uma única vez e o WiseData NPS cuida do resto: quando aparecer, para quem, quantas vezes e o que fazer depois da resposta.
Este artigo usa um exemplo do começo ao fim: a Sanches Contabilidade quer medir a satisfação de quem usa o portal dela, em app.sanches.com.br.
Antes de começar
Três coisas precisam estar prontas, nesta ordem:
- Uma pesquisa criada com o canal Site / Embed marcado na etapa de canais. O código só é gerado depois que a pesquisa é salva — antes disso o painel avisa que é preciso salvar primeiro para gerar o código com o ID correto.
- O domínio do site autorizado (o passo 1 abaixo). Sem isso o widget simplesmente não carrega, e sem mensagem de erro na tela.
- Acesso ao HTML do site, ou a um gerenciador de tags. Se outra pessoa cuida do site, o que você precisa entregar a ela é o código do passo 2.
O embed não funciona para pesquisas de eNPS nem de Concorrência — a primeira é interna, a segunda é direcionada, e nenhuma das duas faz sentido aberta a qualquer visitante.
Passo 1 — Autorize o domínio do seu site
Vá em Canais › Configurações do Embed › Domínios Autorizados e cadastre o endereço do site — no nosso exemplo, sanches.com.br. Digite só o domínio: se você colar a URL inteira, com https:// ou com uma barra no fim, o campo limpa sozinho.
Um domínio cadastrado vale também para www e para os subdomínios. Ou seja, sanches.com.br já autoriza www.sanches.com.br e app.sanches.com.br — a Sanches não precisa cadastrar os três. É por isso que vale cadastrar o domínio raiz, e não o subdomínio específico.
Enquanto a lista estiver vazia, nada funciona. Isso é proposital: uma pesquisa aberta à internet inteira receberia resposta de qualquer página que copiasse o seu código, e a base ficaria contaminada sem ninguém perceber.
Passo 2 — Copie o código da pesquisa
O código está em dois lugares, com o mesmo conteúdo: na etapa Configuração de Site / Embed ao criar ou editar a pesquisa (campo Código de integração), e no detalhe da pesquisa já salva, no cartão Código do widget. Ele tem esta cara:
<script src="https://cdn.wisedatanps.com/embed/widget.min.js" data-survey="SEU_ID_DA_PESQUISA" async></script>O data-survey é o que amarra o código àquela pesquisa específica. Cada pesquisa tem o seu — não reaproveite o código de uma pesquisa antiga achando que é o mesmo.
Passo 3 — Cole no site
Cole dentro do <head> ou logo antes do </body>, em todas as páginas onde a pesquisa pode aparecer. O async garante que ele não segura o carregamento da sua página.
Não tente limitar as páginas escolhendo onde colar o código: para isso existe a Segmentação por página na configuração da pesquisa, que aceita curingas (/checkout/*) e tem regra de bloqueio com precedência sobre a de permissão. Colar em todo lugar e filtrar no painel é o caminho que você consegue mudar depois sem mexer no site.
Diga quem está respondendo
Este é o passo que mais muda o valor da pesquisa, e o único que o código copiado do painel não traz pronto. Do jeito que ele vem, toda resposta chega anônima: você fica com a nota, mas não sabe de quem.
Se o seu site tem área logada — como o portal da Sanches —, acrescente os dados da pessoa na própria tag:
<script src="https://cdn.wisedatanps.com/embed/widget.min.js" data-survey="SEU_ID_DA_PESQUISA" data-user-id="8421" data-user-email="maria@empresa.com.br" data-user-name="Maria Andrade" data-user-traits='{"plano":"Pro","cidade":"Goiânia"}' async></script>Você ganha três coisas com isso:
- O nome de quem respondeu aparece no cartão do feedback e no detalhe do cliente, em vez de "respondente anônimo".
- Uma pessoa responde uma vez só, mesmo trocando de navegador ou de computador — a checagem passa a ser pelo
data-user-id, não pelo aparelho. - Os traits viram recorte de análise: com
planopreenchido, a Sanches consegue olhar a nota de quem está no plano Pro separada da de quem está no básico. Se um trait se chamarphone, o valor entra como telefone de contato do respondente.
Os traits têm teto: até 10 atributos, e valores simples (texto, número ou sim/não). O que passar disso é descartado em silêncio, então não use o campo como despejo de dados do usuário — use os poucos rótulos pelos quais você realmente vai querer segmentar.
Em pesquisas anônimas, nada disso aparece no painel: nome, e-mail e traits ficam ocultos mesmo tendo sido enviados. A promessa de anonimato vale acima da identificação.
Sites de página única (React, Vue, Angular)
Em sites que trocam de tela sem recarregar, o código roda uma vez só, na primeira carga. Isso tem três consequências práticas.
A identificação chega depois. Na primeira carga o visitante costuma nem estar logado ainda. Para esse caso, avise o widget assim que souber quem é a pessoa:
window.WiseDataNPS.identify({ id: '8421', email: 'maria@empresa.com.br', name: 'Maria Andrade', traits: { plano: 'Pro' } });Pode chamar antes do widget terminar de carregar — a chamada fica na fila e é aproveitada. E chame de novo quando o usuário trocar (sair e entrar com outra conta), senão a resposta do segundo sai no nome do primeiro.
Quando alguém apenas sai da conta, avise também:
window.WiseDataNPS.reset();Sem isso, a identificação do último usuário continua na memória do widget até a página ser recarregada — e uma resposta dada depois da saída chega no nome de quem já foi embora. O reset() só esquece quem estava identificado: ele não fecha uma pesquisa que já esteja aberta na tela. Para isso, veja o item abaixo.
A pesquisa aberta não sai da tela sozinha. Ela só desaparece quando o visitante responde ou fecha — até lá, atravessa as trocas de tela do seu site. Se a pesquisa é para quem está logado, monte o widget dentro da área logada, e não na raiz do aplicativo: na raiz, ele continua de pé quando a pessoa é levada para telas públicas como o login ou a redefinição de senha. E, ao sair da área logada, tire a pesquisa junto:
document.querySelectorAll('.wdnps-container') .forEach(function (el) { el.remove(); }); window.WiseDataNPS.reset();Vale um cuidado extra com os gatilhos Após tempo na página e Intenção de saída: eles podem disparar depois que a pessoa já mudou de tela, e a pesquisa nasce onde você não queria.
Segmentação por página e "após N páginas" enxergam só a primeira tela. Como não há recarga, a URL avaliada é a da entrada e a contagem de páginas não avança. Nesses sites, prefira os gatilhos Imediato, Após tempo na página ou Intenção de saída, e evite depender de regras por URL. Repare que a URL gravada na resposta segue outra lógica: é a da tela em que a pessoa estava no instante do envio, e é ela que aparece em Origem da Resposta no painel.
Escolhendo onde a pesquisa aparece
O modo de exibição — Popup, Slide-in ou Inline — é definido na configuração da pesquisa e não precisa ser repetido no código. O popup abre centralizado após alguns segundos; o slide-in desliza no canto inferior direito; o inline nasce dentro da própria página, sem botão de fechar.
No modo inline, por padrão a pesquisa aparece exatamente onde você colou o código — não é preciso criar nenhuma caixa em volta. Se quiser mandá-la para outro ponto da página, indique o elemento:
<script src="https://cdn.wisedatanps.com/embed/widget.min.js" data-survey="SEU_ID_DA_PESQUISA" data-target="#area-da-pesquisa" async></script>Existe também data-mode, que força um modo diferente do configurado no painel. Use com parcimônia: o dia em que alguém mudar o modo na pesquisa e nada mudar no site, a resposta estará nesse atributo esquecido no HTML.
Quando o widget não aparece
O widget falha em silêncio de propósito — ele nunca quebra a sua página nem mostra erro para o visitante. Confira nesta ordem, que é a da frequência:
- O domínio está autorizado? É a causa número um. Lembre que subdomínio é coberto pelo domínio raiz, mas o contrário não vale para domínios diferentes.
- A pesquisa está em execução? Pesquisa em rascunho, pausada, encerrada ou fora da janela de datas não exibe nada.
- Você já respondeu ou já fechou? Quem responde não vê de novo, e quem fecha o widget entra nos dias de descanso configurados. Para testar como um visitante novo, use uma janela anônima.
- A taxa de amostragem está baixa? Em 20%, quatro de cada cinco visitantes não veem nada — e isso inclui você.
- A segmentação por página bate com a URL atual? A lista de páginas bloqueadas tem precedência sobre a de permitidas.
- O gatilho já disparou? Em "intenção de saída" no computador, o widget só aparece quando o cursor sai pelo topo da tela; no celular, ele espera dez segundos.
O que cada plano libera
O widget em si está disponível em todos os planos, e os envios por ele são ilimitados — não consomem cota de e-mail nem de WhatsApp. O que muda com o plano é:
- Quantos domínios você pode autorizar: um no Free, dois no Pro, sem limite a partir do Business. A tela deixa você digitar mais, mas o servidor recusa acima do que o seu plano permite.
- Frequência de exibição (não repetir a pesquisa para a mesma pessoa por N dias) está disponível a partir do Pro.
Para onde ir depois
- Canais de envio — como o embed se compara ao e-mail e ao WhatsApp, e as métricas de cada um.
- Criando e enviando pesquisas — as regras de exibição, os gatilhos e as ações pós-resposta, passo a passo.
- Resultados e relatórios — onde ler as respostas, incluindo o NPS por página do site.
- Alertas — como ser avisado na hora em que um detrator responde.
Resumindo: autorize o domínio em Canais, cole o código da pesquisa em todas as páginas do site, acrescente os dados de quem está logado para não receber respostas anônimas, e resolva o resto — quando aparecer, para quem e com que frequência — pelas regras de exibição no painel, sem voltar a mexer no HTML.