Por que colocar voz em uma pergunta aberta do QuestionPro

A pergunta aberta é onde um estudo no QuestionPro mostra o seu valor, e também é onde os respondentes desistem primeiro. Digitar um parágrafo bem pensado no teclado do celular dá trabalho, então a maioria escreve a coisa mais curta que permita seguir em frente.

Em sete estudos de clientes que medimos, as respostas digitadas tiveram em média 10 palavras e as faladas, para as mesmas perguntas, 23 — cerca de duas vezes mais palavras, com o questionário inalterado (como medimos isso). Nada no desenho da pesquisa muda. O respondente simplesmente ganha um botão de microfone ao lado da caixa de texto, e quem prefere digitar continua digitando.

O Voice Capture cuida da gravação e da transcrição. Você mantém o QuestionPro como plataforma de pesquisa, com sua amostra, sua lógica e seus relatórios.

Confira primeiro a sua edição do QuestionPro

Esta é a única coisa que vale confirmar antes de gastar qualquer tempo: o JavaScript Logic é um recurso das edições Research e Team. Ele não está disponível no Essentials nem no Advanced, e os webhooks que o acompanham também não. Nessas edições, o bloco abaixo vai parecer perfeitamente correto no editor e nunca vai ser executado — uma falha confusa, porque nada dá erro, nada avisa, e a pesquisa simplesmente aparece sem microfone.

Se você está no Essentials ou no Advanced, não há alternativa suportada. O que dá para fazer é rodar o piloto em uma plataforma de pesquisa que permita JavaScript próprio, ou usar o embed genérico em um formulário web que você controla, e tomar a decisão de mudar de edição com dados em mãos, e não no escuro.

O que você precisa

Uma conta no Voice Capture. O teste gratuito inclui 250 créditos — um crédito é uma resposta transcrita — e não pede cartão de crédito, o que basta para colocar em campo uma pergunta aberta real, e não uma demonstração.
Uma pesquisa em uma edição Research ou Team do QuestionPro, com permissão de edição e acesso a Logic → JavaScript Logic.
Uma pergunta aberta de texto na página em que você quer a voz.
Uns cinco minutos. Nada é instalado nos servidores do QuestionPro — o widget roda no navegador do respondente.

Passo 1 — Crie o projeto no Voice Capture

Entre na sua conta e clique em New Project. Dê ao projeto o nome do estudo para encontrá-lo daqui a seis meses (“Tracking de Marca T3 — QuestionPro”) e defina o idioma de transcrição como o idioma em que o campo realmente acontece — português, se a pesquisa roda no Brasil. Salve, e a página do projeto mostra uma chave parecida com proj_XXXXXXXX. Essa chave é a única coisa que liga as gravações à sua conta, então copie-a exatamente: colar a chave incompleta é o motivo mais comum de a integração não funcionar.

Aproveite e defina a duração máxima da gravação. Noventa segundos servem para a maioria das perguntas abertas; o teste gratuito vai até 90 segundos, o Essential até 180 e o Professional até 300.

Passo 2 — Cole um bloco no Pre JavaScript Logic

No editor de pesquisas do QuestionPro, vá em Logic → JavaScript Logic → Pre JS e cole o bloco abaixo. Substitua proj_XXXXXXXX pela chave do seu projeto e ajuste data-lang para o idioma do campo (pt para português).

window.__VC_PRELOADED=true; try {
  var ta = document.querySelector('textarea.form-input:not(.hidden-text)');
  if (ta && !document.getElementById('gv-container')) {
    var wrap = document.createElement('div');
    wrap.id = 'gv-container';
    wrap.setAttribute('data-project','proj_XXXXXXXX');
    wrap.setAttribute('data-target','textarea[id="'+ta.id+'"]');
    wrap.setAttribute('data-lang','pt');
    ta.parentNode.insertBefore(wrap, ta);
    if (!document.getElementById('gv-script')) {
      var s = document.createElement('script');
      s.id = 'gv-script';
      s.src = 'https://api.voicecapture.ai/voice.js';
      s.onload = function(){ try { if (window.GeniusVoice && GeniusVoice.init) GeniusVoice.init(wrap); } catch(e){} };
      document.body.appendChild(s);
    }
  }
} catch(e) {}

A instalação é só isso. Não há segundo trecho, nem tag de script no cabeçalho, nem nada para adicionar ao texto da pergunta. Diferente da configuração no Alchemer — que precisa de um script no cabeçalho da pesquisa mais uma JavaScript Action por pergunta — o espaço de Pre JS do QuestionPro permite que um único bloco faça as duas coisas.

Passo 3 — Entenda onde o bloco é inserido

Leia a primeira linha e você sabe tudo sobre a única restrição real desta integração. O bloco encontra o campo de resposta aberta visível na página e insere o microfone logo acima dele.

Daí saem duas consequências. A boa: você nunca edita o texto da pergunta, então a integração sobrevive a alguém reescrever o enunciado, mudar o tamanho do campo de resposta ou reordenar a página. A incômoda: uma página com duas perguntas abertas é ambígua, e uma página cuja pergunta aberta fica escondida por lógica de exibição até que outra resposta seja dada não tem onde se prender no momento em que o código roda. Dê a cada pergunta aberta com voz a sua própria página, visível desde o início.

Passo 4 — Opcional: marque os registros do Voice Capture com o seu ID da resposta

Você não precisa deste passo para ter as respostas: a transcrição é inserida no campo de resposta do QuestionPro, então ela já fica na mesma linha que o resto da entrevista na sua exportação do QuestionPro. O Voice Capture também guarda a própria cópia de cada transcrição e, por padrão, essa cópia leva a chave do projeto e o campo ao qual foi vinculada, mas não o ID da resposta do QuestionPro.

Se você também quiser cruzar os registros do Voice Capture com as linhas do QuestionPro — por exemplo, para auditar uma resposta específica — ligue um campo de mesclagem do QuestionPro a um atributo data-session no contêiner, junto das outras chamadas a setAttribute, antes de ir a campo:

// adicione esta linha junto das outras chamadas setAttribute,
// usando o campo de mesclagem que carrega o seu ID da resposta
wrap.setAttribute('data-session', myQuestionProResponseId);

Se quiser, faça isso antes do campo: casar por horário depois funciona para um punhado de entrevistas de teste e é bem desagradável em uma amostra real.

Passo 5 — Teste com uma gravação de verdade

Abra o link de teste da pesquisa e grave dez ou quinze segundos. Depois acompanhe o painel do Voice Capture: a transcrição deve chegar em cerca de meio minuto, já transcrita, mostrando o valor de sessão se você definiu um.

Se nada chegar, confira nesta ordem — isso cobre quase todos os casos:

Chave do projeto. Compare caractere por caractere com o painel. Chaves erradas falham em silêncio, de propósito.
Edição. Confirme que é Research ou Team. Um bloco em um campo de JavaScript Logic de uma edição sem o recurso não faz nada.
A pergunta aberta. Existe uma pergunta aberta de texto visível nessa página no momento em que ela carrega?
O espaço. Confirme que o código foi para o Pre JS, que é onde ele foi escrito para rodar.

Teste pelo celular e também pelo notebook. O celular é onde vai estar a maior parte da sua amostra, e é onde a voz mais faz diferença.

Passo 6 — Vá a campo e depois exporte

Publique a pesquisa normalmente. As gravações são enviadas e transcritas à medida que acontecem, então você pode acompanhar as respostas da pergunta aberta chegando enquanto o campo ainda está no ar — útil para pegar um enunciado mal escrito no primeiro dia, e não na tabulação. As transcrições ficam no campo de resposta do QuestionPro, então saem na sua exportação normal; você também pode exportá-las do Voice Capture em CSV em qualquer plano, ou em Excel em um pacote de créditos pago.

O que os seus respondentes veem

Um único botão de microfone acima do campo de texto, com a sua instrução. A gravação usa a API de áudio do próprio navegador, então nada é instalado e o único aviso de permissão é o pedido de microfone padrão que qualquer site mostraria. Os respondentes podem gravar, ouvir a resposta e gravar de novo antes de seguir.

Se um navegador recusa o acesso ao microfone — um aparelho antigo, um notebook corporativo bloqueado, uma permissão negada — o widget não aparece e o campo de texto do QuestionPro fica exatamente como estava. Ninguém fica impedido de responder porque a voz não estava disponível, o que importa tanto para a qualidade dos dados quanto para quem precisa aprovar a acessibilidade.

Perguntas frequentes

Funciona no QuestionPro Essentials?

Não. O JavaScript Logic é um recurso das edições Research e Team. Essa barreira é do QuestionPro, não nossa, e não há forma suportada de contorná-la.

Os respondentes precisam instalar alguma coisa?

Não. É a API de áudio do navegador, a mesma que uma chamada de vídeo usa em uma aba. Sem aplicativo, sem plugin, sem download.

O áudio é armazenado?

Não. O áudio é transcrito e a gravação não é guardada — só o texto resultante, que trafega por uma conexão criptografada. Veja a Política de Privacidade para o quadro completo.

Posso ter voz em mais de uma pergunta?

Sim, uma pergunta aberta com voz por página. O bloco se vincula ao campo de resposta que encontra na página em que roda.

A transcrição aparece dentro da minha resposta no QuestionPro?

Sim. A transcrição é inserida no campo de resposta da própria pergunta, então o QuestionPro a salva como uma resposta digitada e ela sai na sua exportação normal do QuestionPro. O Voice Capture também guarda uma cópia que você pode exportar separadamente; o valor de sessão do passo 4 só importa se você quiser cruzar esses registros com as linhas do QuestionPro.

As transcrições são precisas?

Boas o suficiente para ler e codificar diretamente, mas não perfeitas. Ambientes barulhentos, vozes sobrepostas e respostas de uma palavra geram textos mais fracos, então o painel permite editar qualquer transcrição antes de exportar e sinaliza as de baixa confiança em vez de escondê-las.

Respostas melhores, não só mais longas

Escreva a instrução para ser falada. “Descreva sua experiência” produz uma frase com cara de texto escrito. “Conte o que aconteceu, com suas palavras, como se estivesse contando para um amigo” produz algo que você pode citar.
Mantenha o limite curto. Noventa segundos rendem respostas focadas; três minutos rendem divagações que ninguém na análise vai agradecer.
Coloque a pergunta com voz no começo. A disposição para falar cai ao longo de um questionário longo, como todo o resto.
Faça um piloto em uma pergunta. Rode uma onda com voz em uma única pergunta aberta e compare com a mesma pergunta na onda anterior. Essa comparação convence mais internamente do que o número de qualquer fornecedor, inclusive o nosso.

Configure agora

A referência completa de configuração, com o bloco para copiar, os pré-requisitos e a lista de solução de problemas, está na página da integração com o QuestionPro. Se você também roda estudos no Alchemer, o guia equivalente é How to add voice responses to your Alchemer surveys (em inglês), e para a metodologia mais ampla há o guia completo de pesquisas com voz em pesquisa de mercado.

O teste gratuito inclui 250 créditos e não pede cartão, o que basta para colocar voz em uma pergunta aberta real e ver as transcrições com seus próprios olhos.

Comece grátis — 250 créditos, sem cartão →

Como adicionar respostas de voz às suas pesquisas no QuestionPro