Por Qué el Código de VTURB No Funciona en Hotmart Club (y Cómo Arreglarlo)

El Problema: Hotmart Club Filtra el Código de VTURB

Cuando copias el código de embed de VTURB desde su plataforma, recibes uno de estos dos formatos:

• Formato JS (el que VTURB recomienda por defecto): usa etiquetas <script> y un elemento personalizado <vturb-smartplayer>
• Formato iframe: usa el atributo onload para cargar la URL del video de forma dinámica

El problema es que el editor de Hotmart Club tiene un sanitizador de seguridad que elimina automáticamente ambos elementos. Aquí tienes el desglose exacto de lo que ocurre con cada componente del código:

Resultado: pegas el código, guardas, y cuando recargas la lección, el video simplemente no está. O aparece el iframe vacío apuntando a about:blank sin ningún contenido.

Por Qué Funciona en Páginas de Venta pero No en el Área de Miembros

Esta es la confusión más frecuente. VTURB tiene tutoriales oficiales para integrarse con Hotmart, pero todos están orientados al editor de páginas de venta de Hotmart (el constructor de landing pages), no al Hotmart Club.

El editor de páginas de venta de Hotmart sí permite insertar código JS y scripts personalizados, porque está diseñado para páginas externas con mayor flexibilidad técnica.

El Hotmart Club es diferente: es un área de miembros con un editor de texto enriquecido (tipo WYSIWYG) que, por diseño, bloquea scripts para proteger a los estudiantes de código malicioso. Esta restricción es intencional y no se puede desactivar.

Resumen de compatibilidad:

La Solución: El Iframe Limpio con URL Directa

El único formato de embed que sobrevive al sanitizador de Hotmart Club es un iframe simple con la URL del video directamente en el atributo src, sin scripts y sin el atributo onload.

<div style="margin:0 auto;width:100%">
  <div style="position:relative;padding:56.25% 0 0 0">
    <iframe 
      frameborder="0" 
      allowfullscreen 
      src="https://scripts.converteai.net/TU-ACCOUNT-ID/players/TU-PLAYER-ID/v4/embed.html"
      style="position:absolute;top:0;left:0;width:100%;height:100%">
    </iframe>
  </div>
</div>

El padding: 56.25% mantiene la proporción 16:9 del video de forma responsiva en cualquier dispositivo.

Cómo Extraer la URL Correcta de tu Código de VTURB

El paso clave es saber dónde está escondida la URL real del embed dentro del código que te entrega VTURB.

Si tienes el Formato Iframe

El código que recibes de VTURB se ve así:

<script type="text/javascript"> var s=document.createElement("script"); ... </script>
<div id="ifr_XXXXXXXXX_wrapper" style="margin: 0 auto; width: 100%;">
  <div style="position: relative; padding: 56.25% 0 0 0;">
    <iframe frameborder="0" allowfullscreen src="about:blank"
      onload="this.onload=null, this.src='https://scripts.converteai.net/TU-ID/players/TU-PLAYER-ID/v4/embed.html'">
    </iframe>
  </div>
</div>

La URL está dentro del atributo onload, específicamente en el valor de this.src='...'. Busca esa parte y copia exactamente la URL que está entre las comillas simples.

Si tienes el Formato JS

El código que recibes de VTURB se ve así:

<vturb-smartplayer id="vid-PLAYER-ID" style="display: block; margin: 0 auto; width: 100%;"></vturb-smartplayer>
<script type="text/javascript">
  var s=document.createElement("script");
  s.src="https://scripts.converteai.net/TU-ID/players/TU-PLAYER-ID/v4/player.js",
  s.async=!0, document.head.appendChild(s);
</script>

La URL del player.js contiene tu ID. Solo necesitas cambiar player.js por embed.html al final:

https://scripts.converteai.net/TU-ID/players/TU-PLAYER-ID/v4/player.js
                                                                    ↓
https://scripts.converteai.net/TU-ID/players/TU-PLAYER-ID/v4/embed.html

Paso a Paso: Cómo Insertar el Código en Hotmart Club

Una vez que tienes el código correcto (ya sea que lo construiste manualmente o usaste la herramienta de arriba), sigue estos pasos:

1. Ingresa a tu cuenta de Hotmart y ve a Productos → Área de miembros

2. Selecciona el área de miembros y entra al producto correspondiente

3. En la pestaña Contenido, entra a la lección donde quieres insertar el video

4. En el campo Texto, haz clic en el ícono <> (código fuente)

5. Borra cualquier código que haya en el editor y pega el código del iframe limpio

6. Haz clic en Guardar y luego en Publicar

El Video Carga en Blanco Dentro de Hotmart: El Problema del Dominio de Seguridad

Si seguiste todos los pasos y el iframe aparece pero el video se ve en blanco o da un error de origen, el problema no está en el código: está en la configuración de seguridad de VTURB.

VTURB protege tus videos con una lista de dominios autorizados. Si el dominio de Hotmart Club no está en esa lista, el reproductor se niega a cargar.

Cómo solucionarlo:

1. Entra a tu cuenta de VTURB
2. Ve a la pestaña Seguridad del video correspondiente
3. Agrega el dominio: *.hotmart.com
4. Guarda los cambios

Si tu área de miembros tiene una URL personalizada (por ejemplo miembros.tumarca.com), también debes agregar ese dominio a la lista.

Preguntas Frecuentes

¿Puedo usar el código JS de VTURB en alguna parte de Hotmart Club?

No. El editor de lecciones de Hotmart Club elimina cualquier etiqueta <script>, sin excepciones. La única forma de embeber VTURB en el área de miembros es usando el iframe limpio con la URL directa al embed.html.

¿Pierdo funcionalidades al usar el iframe en lugar del JS?

Sí, algunas. Con el iframe limpio no puedes usar los botones de acción de VTURB, el delay sincronizado, ni el smart autoplay avanzado. Sin embargo, el video se reproduce correctamente y con todas las opciones básicas (autoplay, thumbnail, controles). Para un área de miembros esto es suficiente, ya que el objetivo es que el estudiante vea el contenido, no convertir.

¿Funciona esto para VSLs dentro del área de miembros?

¿Por qué VTURB no explica esto en su documentación oficial?

Los tutoriales oficiales de VTURB para Hotmart están orientados a las páginas de venta (donde el código JS sí funciona). El caso específico del Hotmart Club (área de miembros) no tiene documentación oficial en español, lo que hace que muchos creadores pasen horas intentando resolver este problema sin encontrar respuesta.

¿Esto funciona con Vimeo o YouTube también?

Vimeo y YouTube ya entregan iframes limpios por defecto, por lo que se pegan directamente en Hotmart Club sin ninguna modificación. El problema de conversión es exclusivo de VTURB (y reproductores similares como Panda Video o Vidalitics que usan el mismo sistema de carga dinámica).

Resumen

El código de VTURB no funciona en Hotmart Club porque el editor del área de miembros elimina los elementos <script> y el atributo onload por razones de seguridad. La solución es extraer la URL del embed y construir manualmente un iframe limpio que Hotmart Club sí acepta. El formato final debe apuntar directamente a la URL embed.html de tu player en VTURB.

Si quieres hacerlo en segundos, usa la herramienta de conversión gratuita que está más arriba en este artículo: pega tu código de VTURB y obtienes el código listo para copiar y pegar en tu área de miembros.

¿Tienes un curso en Hotmart y usas herramientas de IA para tu negocio? Visita el Círculo IA — la comunidad donde enseñamos a emprendedores a automatizar y escalar sus negocios digitales con inteligencia artificial.