Índice de guías del SDK

Guía de instalación · Player

Guía de instalación — GoHighLevel

Volver a: Índice de guías

Cómo incrustar un embed de Treisa Player en una página de funnel o sitio de GoHighLevel (HighLevel) usando el elemento Custom JS/HTML (Code). EMBED_KEY es la key de tu embed (Player → Embeds); el host https://player.treisaflow.com es el por defecto (el snippet del panel trae el real).

Los pasos siguen el builder de funnels/websites actual. En cuentas white-label el elemento puede aparecer como Code o Custom HTML/JavaScript; es el mismo elemento.


1. Antes de empezar

  1. Dominio registrado en Player → Dominios: el dominio que sirve la página — el subdominio de GHL (ejemplo: tunegocio.leadconnectorhq.com o mysites.io) o tu dominio personalizado. Sin https://.
  2. Flag del workspace activo (treisa_player_external_embed_enabled).
  3. El video debe estar publicado y en estado ready.

2. Paso a paso

El snippet que vas a pegar es exactamente este (de Player → Embeds → Copiar snippet, variante Script v2):

<!-- Treisa Player — embed -->
<div data-treisa-player="EMBED_KEY"></div>
<script async src="https://player.treisaflow.com/v2/player.js"></script>
  1. En GoHighLevel entra a Funnels (o Sites) y abre la página en el editor (builder).

  2. Pulsa + (Add Element) para abrir el panel de elementos.

  3. En la sección Custom del panel, arrastra el elemento Custom JS/HTML al lugar exacto donde va el video.

  4. Pulsa el elemento en el lienzo para abrir sus opciones.

  5. Pulsa Open Code Editor y pega el snippet del inicio de esta sección, con tu EMBED_KEY real.

  6. Guarda el editor de código y pulsa Save en el builder.

  7. Abre la página en Preview o en su URL publicada. El código insertado con este elemento no se renderiza dentro del builder: se ve una caja, y el video aparece en la página pública.

Dónde NO pegarlo

Las opciones de Custom Code / Tracking Code a nivel de paso o de sitio (Settings → head/body) inyectan en <head> o al final del <body>: no sirven para el video, porque el <div data-treisa-player> debe vivir en el lugar del lienzo donde quieres que se vea. Usa el elemento.

3. Variante iframe plano

El mismo elemento acepta la variante sin script:

<iframe
  src="https://player.treisaflow.com/e/EMBED_KEY"
  title="Treisa Player"
  allow="autoplay; fullscreen; encrypted-media; picture-in-picture"
  allowfullscreen
  referrerpolicy="strict-origin-when-cross-origin"
  sandbox="allow-scripts allow-same-origin allow-popups allow-forms allow-presentation"
  style="width:100%;aspect-ratio:16/9;border:0"></iframe>

4. CSP

GoHighLevel no permite configurar una CSP propia para las páginas de funnels/sites: no hay que hacer nada. Las páginas se sirven sin restringir script-src ni frame-src hacia el player.

5. Troubleshooting

SíntomaCausa probableQué revisar
La caja aparece vacía en el buildernormal: el código no se renderiza en el editorverifica en Preview / página publicada
Se ve el código como texto en la página publicadapegado en un elemento de texto (paragraph)usa el elemento Custom JS/HTML
Error EMBED_DOMAIN_NOT_ALLOWEDel dominio de la página no está registradoregistra el subdominio de GHL o tu dominio custom en Player → Dominios
Error EMBED_UNPUBLISHED / EMBED_NOT_READYvideo despublicado o procesándosepublica / espera ready en Treisa Flow
El video carga pero sin eventos postMessagereferrer suprimido por el navegadorusa data-on-event o TreisaPlayer.on (apéndice del SDK)

Códigos completos en la sección 6 del SDK.