# Descripción general

> El cliente JavaScript de Entase abre el proceso de compra desde tu propio sitio web, ya sea como panel integrado o como ventana emergente, sin enviar al visitante a otra página.

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](/organizers/sharing-and-embedding/embedding-events-on-your-website.md).

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](/developers/js-client/embed-advanced-options.md).

## 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:

```html
<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](/developers/js-client/checkout-modes.md).

## 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](/organizers/settings/integrations-and-checkout-customization.md).
- 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](/developers/js-client/installing-the-client.md) – cargar el script y crear una instancia.
- [Opciones del constructor](/developers/js-client/constructor-options.md) – todas las opciones y sus valores predeterminados.
- [Abrir el proceso de compra](/developers/js-client/opening-the-checkout.md) – el método `book()` y las anulaciones por llamada.
- [Eventos](/developers/js-client/events.md) – reaccionar a la apertura, el cierre y la finalización del proceso de compra.
