Cómo Añadir Respuestas de Voz a tus Encuestas en QuestionPro

Por qué poner voz en una abierta de QuestionPro

La pregunta abierta es donde un estudio en QuestionPro se justifica, y también la que más cuesta responder bien. Escribir un párrafo pensado en el teclado del móvil da trabajo, así que la mayoría pone lo más corto que le permita seguir.

En siete estudios con clientes que medimos, las respuestas escritas promediaron 10 palabras y las habladas a esas mismas preguntas, 23: aproximadamente el doble de palabras con el cuestionario sin tocar (cómo lo medimos). El diseño del estudio no cambia. El encuestado simplemente encuentra un botón de micrófono junto al cuadro de texto, y quien prefiera escribir sigue escribiendo.

Voice Capture se ocupa de la grabación y de la transcripción. QuestionPro sigue siendo tu plataforma, tu muestra, tu lógica y tus reportes.

Antes de nada, revisa tu edición de QuestionPro

Esto conviene confirmarlo antes de invertir un solo minuto: JavaScript Logic es una funcionalidad de las ediciones Research y Team. No está expuesta en Essentials ni en Advanced, y tampoco los webhooks que la acompañan. En esas ediciones el bloque de más abajo se verá perfectamente correcto en el editor y no se ejecutará nunca; es un fallo desconcertante, porque no da error, no avisa, y la encuesta sale a campo sin micrófono.

Si estás en Essentials o Advanced no hay atajo soportado. Lo que sí puedes hacer es correr el piloto en una plataforma que permita JavaScript personalizado, o usar el embed genérico sobre un formulario web propio, y así decidir la subida de edición con datos en la mano y no sobre el papel.

Qué necesitas

• Una cuenta de Voice Capture. La Prueba Gratuita trae 250 créditos — un crédito es una respuesta transcrita — y no pide tarjeta, suficiente para salir a campo con una abierta real y no con una demo.
• Una encuesta en QuestionPro edición Research o Team, con permisos de edición y acceso a Logic → JavaScript Logic.
• Una pregunta abierta de texto en la página donde quieres la voz.
• Unos cinco minutos. No se instala nada en los servidores de QuestionPro: el widget corre en el navegador del encuestado.

Paso 1 — Crea el proyecto en Voice Capture

Entra al panel y pulsa Nuevo Proyecto. Ponle el nombre del estudio para reconocerlo dentro de seis meses ("Tracker de Marca Q3 — QuestionPro") y fija el idioma de transcripción al idioma real del campo. Al guardar, la página del proyecto te muestra una clave con la forma proj_XXXXXXXX. Esa clave es lo único que ata las grabaciones a tu cuenta, así que cópiala exacta: una copia cortada es la causa número uno de una instalación que se queda muda.

Aprovecha para fijar la duración máxima de grabación. Noventa segundos van bien para casi cualquier abierta; la Prueba Gratuita tope 90 segundos, Essential 180 y Professional 300.

Paso 2 — Pega un bloque en Pre JavaScript Logic

En el editor de la encuesta ve a Logic → JavaScript Logic → Pre JS y pega el bloque de abajo. Sustituye proj_XXXXXXXX por tu clave de proyecto y ajusta data-lang al idioma del campo.

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','es');
    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) {}

Esa es toda la instalación. No hay un segundo snippet, ni etiqueta de script en la cabecera, ni nada que añadir al texto de la pregunta. A diferencia del montaje en Alchemer —que necesita un script en la cabecera de la encuesta más una JavaScript Action por pregunta— el hueco de Pre JS de QuestionPro permite que un solo bloque haga las dos cosas.

Paso 3 — Entiende a qué se enganchó el bloque

Con leer la primera línea ya conoces la única restricción real de esta integración. El bloque busca el campo de respuesta abierta visible de la página e inserta el micrófono justo encima.

De ahí salen dos consecuencias. La buena: nunca tocas el texto de la pregunta, así que la integración sobrevive a que alguien reescriba el enunciado, cambie el tamaño del campo o reordene la página. La incómoda: una página con dos abiertas es ambigua, y una página cuya abierta está oculta por lógica de visualización hasta que se conteste otra pregunta no ofrece nada donde engancharse en el instante en que corre el código. Deja cada abierta con voz en su propia página y visible desde el principio.

Paso 4 — Decide cómo van a cruzar las transcripciones con tus datos

Este es el paso que la gente se salta y luego lamenta. Alchemer le pasa al widget un session id por merge code, así que las transcripciones cuadran solas con las respuestas. QuestionPro no entrega nada equivalente a Pre JS, lo que significa que por defecto tus transcripciones llegan con la clave de proyecto y el identificador del campo al que se engancharon, y sin ningún id de respuesta de QuestionPro.

Si tu análisis necesita la respuesta hablada en la misma fila que el resto de la entrevista, conecta un merge field de QuestionPro a un atributo data-session del contenedor, junto a los otros setAttribute, antes de salir a campo:

// añade esta línea junto a los demás setAttribute,
// sustituyendo por el merge field que lleve tu id de respuesta
wrap.setAttribute('data-session', miIdDeRespuestaQuestionPro);

Hazlo antes del campo. Cruzar después por marca de tiempo funciona con un puñado de entrevistas de prueba y es francamente ingrato con una muestra real.

Paso 5 — Prueba con una grabación de verdad

Abre el enlace de prueba de la encuesta y graba diez o quince segundos. Después mira el panel de Voice Capture: la transcripción debería aparecer en menos de medio minuto, ya transcrita, mostrando el valor de sesión si lo configuraste.

Si no llega nada, repasa esto en orden; cubre casi todos los casos:

1. La clave de proyecto. Compárala carácter por carácter con el panel. Una clave equivocada falla en silencio por diseño.
2. La edición. Confirma Research o Team. Un bloque en un campo de JavaScript Logic de una edición sin la funcionalidad está inerte.
3. La abierta. ¿Hay una pregunta abierta de texto visible en esa página en el momento en que carga?
4. El hueco. Confirma que el código quedó en Pre JS, que es donde está escrito para correr.

Prueba también desde el móvil, no solo desde el portátil. El móvil es donde estará la mayor parte de tu muestra y donde la voz rinde más.

Paso 6 — Sal a campo y exporta

Publica la encuesta como siempre. Las grabaciones se suben y se transcriben en el momento, así que puedes leer cómo se llena la abierta con el campo todavía vivo, que es la forma de detectar una instrucción mal redactada el primer día en lugar de en la tabulación. Exporta las transcripciones a CSV en cualquier plan, o a Excel con un paquete de pago, y crúzalas con tu exporte de QuestionPro.

Qué ve realmente el encuestado

Un único botón de micrófono encima del campo de texto, con tu instrucción. La grabación usa la propia API de audio del navegador, así que no se instala nada y el único diálogo de permiso es el de micrófono de siempre. El encuestado puede grabar, escucharse y volver a grabar antes de avanzar.

Si el navegador deniega el micrófono —un equipo antiguo, un portátil corporativo bloqueado, un permiso rechazado— el widget no llega a montarse y el campo de texto de QuestionPro queda exactamente igual. Nadie se queda sin poder responder porque la voz no estuviera disponible para él, lo cual importa tanto para la calidad del dato como para quien tenga que firmar la accesibilidad.

Preguntas frecuentes

¿Funciona en QuestionPro Essentials?

No. JavaScript Logic es una funcionalidad de las ediciones Research y Team. Esa puerta es de QuestionPro, no nuestra, y no hay forma soportada de rodearla.

¿Los encuestados tienen que instalar algo?

No. Es la API de audio del navegador, la misma que usa una videollamada en una pestaña. Sin app, sin plugin, sin descargas.

¿Se guarda el audio?

No. El audio se transcribe y la grabación no se conserva: solo queda el texto, que viaja por conexión cifrada. Los detalles están en la Política de Privacidad.

¿Puedo poner voz en más de una pregunta?

Sí, una abierta con voz por página. El bloque se engancha al campo de respuesta que encuentra en la página donde corre.

¿La transcripción aparece dentro de mi respuesta de QuestionPro?

No. Las transcripciones viven en Voice Capture y se cruzan con los datos de QuestionPro al exportar, por el valor de sesión que configuraste en el paso 4. Es un cruce de análisis, no un campo vivo dentro de QuestionPro.

¿Qué tan precisas son las transcripciones?

Lo bastante para leerlas y codificarlas directamente, y no infalibles. Las salas ruidosas, las conversaciones cruzadas y las respuestas de una palabra dan texto más flojo, así que el panel te deja editar cualquier transcripción antes de exportar y marca las de baja confianza en lugar de esconderlas.

Conseguir mejores respuestas, no solo más largas

• Redacta la instrucción para ser hablada. "Describa su experiencia" produce una frase que suena escrita. "Cuéntanos qué pasó, con tus palabras, como si se lo contaras a un amigo" produce algo citable.
• Mantén el tope corto. Noventa segundos dan respuestas enfocadas; tres minutos dan divagación que nadie del lado del análisis te va a agradecer.
• Pon la abierta con voz al principio. Las ganas de hablar se desgastan a lo largo de un cuestionario largo igual que todo lo demás.
• Pilota con una sola pregunta. Corre una ola con voz en una única abierta y compárala con esa misma pregunta en tu ola anterior. Esa comparación convence más puertas adentro que cualquier número de proveedor, incluido el nuestro.

Móntalo

La referencia completa de configuración, con el bloque para copiar, los requisitos previos y la lista de fallos habituales, está en la página de integración con QuestionPro. Si además haces estudios en Alchemer, la guía equivalente es Cómo añadir respuestas de voz a tus encuestas en Alchemer, y para la metodología de fondo está la guía completa de encuestas de voz en investigación de mercados.

La Prueba Gratuita incluye 250 créditos y no pide tarjeta, que alcanza para poner voz en una abierta real y ver las transcripciones con tus propios ojos.

Empieza Gratis — 250 Créditos, Sin Tarjeta →