El cliente JavaScript de Entase es una pequeña biblioteca que cargas desde nuestra CDN. Le proporciona a tu sitio web una función que no puede realizar por sí solo: abrir el proceso de compra de Entase directamente, para que un visitante compre una entrada sin salir de la página en la que se encuentra.
Gestiona el panel o la ventana emergente, el fondo superpuesto, el bloqueo del desplazamiento de la página, el paso de consentimiento, la configuración regional y los parámetros de seguimiento. Tu código decide cuándo abrir el proceso de compra y para qué evento.
Lo que no es
El cliente no muestra listados de eventos, fechas, precios ni disponibilidad. Si quieres un widget listo para usar que muestre tu programación, utiliza los códigos de inserción: se copian y pegan, y no requieren trabajo de desarrollo. Consulta Insertar eventos en tu sitio web.
Sin embargo, no son alternativas. El widget insertado carga internamente este mismo cliente para abrir su proceso de compra, por lo que puedes pasar opciones del cliente mediante la configuración de inserción. Consulta Opciones avanzadas de inserción.
Cuándo usarlo
Usa el cliente directamente si tienes tus propias páginas de eventos y quieres que tu propio botón «Comprar entradas» abra el proceso de compra de Entase:
<button id="buy">Buy tickets</button>
<script src="https://js.entase.com/client.js"></script>
<script>
const entase = new Entase({ pk: 'YOUR_PUBLISHABLE_KEY' });
document.getElementById('buy').addEventListener('click', () => {
entase.book('EVENT_ID');
});
</script>Esa es toda la integración. Todo lo demás de esta sección es para afinarla: qué opciones existen, cómo decide el proceso de compra entre un panel y una ventana emergente, y qué eventos puedes escuchar.
Dos modos de compra
El proceso de compra se abre de una de estas dos formas:
- Panel – un panel integrado dentro de tu página, que se desliza desde la derecha en ordenadores y desde abajo en dispositivos móviles. El visitante nunca sale de tu sitio.
- Ventana emergente – una ventana independiente del navegador.
El modo panel ofrece una mejor experiencia, pero solo está disponible para los dominios que hayas añadido como orígenes de confianza en la configuración de Entase. El cliente detecta cuál puede utilizar y recurre a una ventana emergente cuando no se permite el proceso de compra integrado. Este es el comportamiento más importante que debes comprender antes de realizar la integración – consulta Modos de compra.
Requisitos
- Una página servida mediante HTTPS. Con HTTP sin cifrar, el cliente siempre utiliza una ventana emergente.
- Tu dominio añadido a los orígenes de confianza en Configuración → Integraciones, si quieres usar el proceso de compra integrado. Consulta Integraciones y personalización del proceso de compra.
- No se necesita paso de compilación, empaquetador ni gestor de paquetes. La biblioteca es una única etiqueta de script.
Qué hacer a continuación
- Instalar el cliente – cargar el script y crear una instancia.
- Opciones del constructor – todas las opciones y sus valores predeterminados.
- Abrir el proceso de compra – el método
book()y las anulaciones por llamada. - Eventos – reaccionar a la apertura, el cierre y la finalización del proceso de compra.