Instalando el widget en tu sitio

El widget es tu encuesta corriendo dentro de tu propio sitio, sin depender de que alguien abra un correo. Pegas un fragmento de código una sola vez y WiseData NPS se encarga del resto: cuándo aparece, a quién, con qué frecuencia y qué pasa después de la respuesta.

Este artículo usa un ejemplo de principio a fin: Sanches Contabilidad quiere medir la satisfacción de quienes usan su portal, en app.sanches.com.

Antes de empezar

Tres cosas deben estar listas:

1. Una encuesta con el canal Sitio web / Embed marcado en la etapa Canales. El código solo se genera después de guardar la encuesta — antes de eso la pantalla muestra "Guarda la encuesta para generar el código de instalación".
2. Acceso al DNS del dominio (el panel donde el dominio está registrado o alojado), para publicar el registro que prueba que el sitio es tuyo.
3. Acceso al HTML del sitio, o a un gestor de etiquetas. Si otra persona cuida el sitio y el DNS, lo que le entregas es el registro del paso 2 y el código del paso 3.

El embed no funciona para encuestas de eNPS ni de Competencia — la primera es interna, la segunda es dirigida, y ninguna tiene sentido abierta a cualquier visitante. Tampoco comparte la encuesta con correo o WhatsApp: el sitio solo puede ir junto con el canal Aplicación.

Los pasos de abajo aparecen numerados en la propia pantalla, en dos lugares: en la etapa de canales de la encuesta, dentro de Configuración de Sitio web / Embed, y en Canales › Configuración del Embed (ahí solo los pasos 1 y 2, porque no hay encuesta para generar código). Los dominios son de la cuenta, no de la encuesta: verificados una vez, valen para todas las encuestas.

Paso 1 — Indica el dominio de tu sitio

En Indica el dominio de tu sitio, escribe la dirección — en nuestro ejemplo, sanches.com — y haz clic en Agregar. Puedes pegar la URL entera: el sistema quita el https:// y la ruta por ti.

Un dominio vale también para www y para los subdominios. Es decir, sanches.com ya autoriza www.sanches.com y app.sanches.com — Sanches no necesita registrar los tres. Por eso conviene registrar el dominio raíz y no el subdominio específico.

Cuántos dominios caben depende del plan: uno en Free y en la prueba gratuita, dos en Pro y sin límite a partir de Business. Un dominio aún no verificado también cuenta.

Paso 2 — Comprueba que el dominio es tuyo

En cuanto el dominio entra en la lista, la pantalla muestra un registro TXT con tres campos — Tipo, Nombre y Valor —, cada uno con su botón de copiar. Crea ese registro en el panel de DNS del dominio, exactamente como aparece (el nombre empieza con _wisedata-nps, así que no toca tus registros de correo ni otras verificaciones que ya tengas). Después vuelve y haz clic en Verificar ahora.

La propagación del DNS tarda de algunos minutos a algunas horas. Mientras tanto el dominio aparece como Esperando publicación (aún no comprobamos) o Registro no encontrado (comprobamos y no estaba) — espera y verifica de nuevo. Cuando pasa a Verificado, el registro desaparece de la pantalla.

Mientras ningún dominio esté verificado, nada funciona. Es a propósito: sin esa prueba, cualquier cuenta podría registrar el dominio de otra empresa y poner una encuesta en su sitio, o cualquier página copiaría tu código y contaminaría tu base. Por lo mismo, un dominio ya verificado por otra cuenta no se puede registrar; y si dos cuentas registran el mismo dominio, se queda con él quien verifique primero — la otra recibe un aviso por correo.

No borres el registro después. La propiedad se vuelve a comprobar periódicamente. Si el TXT desaparece, el widget sigue funcionando, pero el dominio muestra un aviso en la pantalla y los administradores de la cuenta reciben un correo — vuelve a publicar el registro.

Paso 3 — Copia el código de la encuesta

El código aparece en Copia el código a tu sitio, en la etapa de canales de la encuesta, y solo se libera cuando al menos un dominio está verificado — antes de eso queda atenuado, sin el botón Copiar código, porque instalado antes no cargaría. En la encuesta ya guardada, el mismo código está en la tarjeta Código del widget, con la misma regla: sin dominio verificado, la tarjeta queda bloqueada y muestra el enlace Verificar dominio en Canales. Se ve así:

<script src="https://cdn.wisedatanps.com/embed/widget.min.js" data-survey="TU_ID_DE_ENCUESTA" async></script>

El data-survey es lo que ata el código a esa encuesta específica. Cada encuesta tiene el suyo — no reutilices el código de una encuesta anterior pensando que es el mismo.

Paso 4 — Pégalo en el sitio

Pégalo justo antes del cierre de la etiqueta </body>, en todas las páginas donde la encuesta deba aparecer — es la misma instrucción que la pantalla muestra junto al código. El async garantiza que no retenga la carga de tu página.

No intentes limitar las páginas eligiendo dónde pegar el código: para eso existe la Segmentación por página en la configuración de la encuesta, que acepta comodines (/checkout/*) y cuya lista de bloqueo tiene precedencia sobre la de permitidas. Pegar en todos lados y filtrar en el panel es el camino que puedes cambiar después sin tocar el sitio.

Di quién está respondiendo

Este es el paso que más cambia el valor de la encuesta, y el único que el código copiado del panel no trae listo. Tal como viene, cada respuesta llega anónima: te queda la nota, pero no sabes de quién.

Si tu sitio tiene área con sesión — como el portal de Sanches —, agrega los datos de la persona en la propia etiqueta:

<script src="https://cdn.wisedatanps.com/embed/widget.min.js" data-survey="TU_ID_DE_ENCUESTA" data-user-id="8421" data-user-email="maria@empresa.com" data-user-name="Maria Andrade" data-user-traits='{"plan":"Pro","ciudad":"Goiânia"}' async></script>

Ganas tres cosas con eso:

• El nombre de quien respondió aparece en la tarjeta del feedback y en el detalle del cliente, en lugar de "encuestado anónimo".
• Una persona responde una sola vez, aunque cambie de navegador o de computadora — la verificación pasa a ser por data-user-id, no por el aparato.
• Los traits se vuelven cortes de análisis: con plan completado, Sanches puede ver la nota de quien está en el plan Pro aparte de quien está en el básico. Si un trait se llama phone, el valor entra como teléfono de contacto del encuestado.

Los traits tienen tope: hasta 10 atributos, con valores simples (texto, número o sí/no). Lo que pase de ahí se descarta en silencio, así que no uses el campo como volcado de datos del usuario — usa las pocas etiquetas por las que realmente vas a segmentar.

En encuestas anónimas nada de esto aparece en el panel: nombre, correo y traits quedan ocultos aunque se hayan enviado. La promesa de anonimato está por encima de la identificación.

Sitios de una sola página (React, Vue, Angular)

En sitios que cambian de pantalla sin recargar, el código corre una sola vez, en la primera carga. Eso tiene tres consecuencias prácticas.

La identificación llega después. En la primera carga el visitante normalmente ni siquiera inició sesión. Para ese caso, avísale al widget en cuanto sepas quién es la persona:

window.WiseDataNPS.identify({ id: '8421', email: 'maria@empresa.com', name: 'Maria Andrade', traits: { plan: 'Pro' } });

Puedes llamarlo antes de que el widget termine de cargar — la llamada queda en cola y se aprovecha. Y vuelve a llamarlo cuando el usuario cambie (salir y entrar con otra cuenta), si no la respuesta del segundo sale a nombre del primero.

Cuando alguien solo cierra sesión, avísale también:

window.WiseDataNPS.reset();

Sin eso, la identificación del último usuario sigue en la memoria del widget hasta que la página se recargue — y una respuesta dada después de la salida llega a nombre de quien ya se fue. El reset() solo olvida a quién estaba identificado: no cierra una encuesta que ya esté abierta en la pantalla. Para eso, mira el punto siguiente.

La encuesta abierta no sale sola de la pantalla. Solo desaparece cuando el visitante responde o la cierra — hasta entonces, atraviesa los cambios de pantalla de tu sitio. Si la encuesta es para quien tiene sesión, monta el widget dentro del área con sesión, y no en la raíz de la aplicación: en la raíz sigue en pie cuando la persona es llevada a pantallas públicas como el inicio de sesión o el restablecimiento de contraseña. Y al salir de esa área, llévate la encuesta también:

document.querySelectorAll('.wdnps-container') .forEach(function (el) { el.remove(); }); window.WiseDataNPS.reset();

Cuidado especial con los disparadores Tras tiempo en la página e Intención de salida: pueden dispararse cuando la persona ya cambió de pantalla, y la encuesta nace donde no querías.

La segmentación por página y "Tras N páginas" solo ven la primera pantalla. Como no hay recarga, la URL evaluada es la de entrada y el conteo de páginas no avanza. En esos sitios prefiere los disparadores Inmediato, Tras tiempo en la página o Intención de salida, y evita depender de reglas por URL. Fíjate en que la URL registrada en la respuesta sigue otra lógica: es la de la pantalla en la que estaba la persona al momento de enviar, y es la que aparece en Origen de la Respuesta en el panel.

Eligiendo dónde aparece la encuesta

El modo de visualización — Popup, Slide-in o Inline — se define en la configuración de la encuesta y no hace falta repetirlo en el código. El popup abre centrado tras unos segundos; el slide-in se desliza en la esquina inferior derecha; el inline nace dentro de la propia página, sin botón de cerrar. Para popup y slide-in, la opción Cierre decide si el visitante Puede cerrar, Solo puede posponer o si la encuesta es Obligatoria.

En modo inline, por defecto la encuesta aparece exactamente donde pegaste el código — no hace falta crear ninguna caja alrededor. Si quieres llevarla a otro punto de la página, indica el elemento:

<script src="https://cdn.wisedatanps.com/embed/widget.min.js" data-survey="TU_ID_DE_ENCUESTA" data-target="#area-de-la-encuesta" async></script>

También existe data-mode, que fuerza un modo distinto al configurado en el panel. Úsalo con moderación: el día en que alguien cambie el modo en la encuesta y nada cambie en el sitio, la respuesta estará en ese atributo olvidado en el HTML.

Cuando el widget no aparece

El widget falla en silencio a propósito — nunca rompe tu página ni muestra error al visitante. Revisa en este orden, que es el de frecuencia:

• ¿El dominio está verificado? Es la causa número uno. En Canales › Configuración del Embed, el dominio tiene que estar como Verificado — registrado y Esperando publicación o Registro no encontrado todavía no carga. Recuerda que el subdominio queda cubierto por el dominio raíz, pero eso no vale entre dominios distintos.
• ¿La encuesta está en ejecución? Una encuesta en borrador, pausada, finalizada o fuera de la ventana de fechas no muestra nada.
• ¿Ya respondiste o ya lo cerraste? Quien responde no lo vuelve a ver, y quien lo cierra entra en los Días de descanso tras cerrar configurados. Para probar como visitante nuevo, usa una ventana privada.
• ¿La tasa de muestreo está baja? Al 20%, cuatro de cada cinco visitantes no ven nada — y eso te incluye.
• ¿La segmentación por página coincide con la URL actual? La lista de páginas bloqueadas tiene precedencia sobre la de permitidas.
• ¿Ya se disparó el gatillo? En "intención de salida" en computadora, el widget solo aparece cuando el cursor sale por arriba de la pantalla; en el celular espera diez segundos.

Qué desbloquea cada plan

El widget en sí está disponible en todos los planes, y los envíos por él son ilimitados — no consumen cuota de correo ni de WhatsApp. Lo que cambia con el plan es:

• Cuántos dominios puedes registrar: uno en Free y en la prueba gratuita, dos en Pro, sin límite a partir de Business. La pantalla te deja escribir más, pero el registro se rechaza por encima de lo que tu plan permite. Para cambiar de dominio en un plan con límite, elimina el anterior antes.
• Frecuencia de visualización (no repetir la encuesta a la misma persona por N días) está disponible a partir de Pro y en la prueba gratuita; en Free el campo aparece bloqueado.

Adónde ir después

• Canales de envío — cómo se compara el embed con el correo y WhatsApp, y las métricas de cada uno.
• Creando y enviando encuestas — las reglas de visualización, los gatillos y las acciones post-respuesta, paso a paso.
• Resultados e informes — dónde leer las respuestas, incluyendo el NPS por página del sitio.
• Alertas — cómo enterarte en el momento en que un detractor responde.

Resumiendo: registra el dominio, publica el registro TXT y verifícalo, pega el código de la encuesta en todas las páginas del sitio, agrega los datos de quien tiene sesión para no recibir respuestas anónimas, y resuelve el resto — cuándo aparece, a quién y con qué frecuencia — desde las reglas de visualización en el panel, sin volver a tocar el HTML.