# Visão geral

> O cliente JavaScript da Entase abre o checkout a partir do seu próprio site, como um painel integrado ou uma janela pop-up, sem enviar o visitante para outra página.

O cliente JavaScript da Entase é uma pequena biblioteca que você carrega da nossa CDN. Ele dá ao seu site uma função que ele não consegue executar sozinho: **abrir o checkout da Entase no próprio local**, para que o visitante compre um ingresso sem sair da página em que está.

Ele gerencia o painel ou a janela pop-up, o plano de fundo, o bloqueio da rolagem da página, a etapa de consentimento, o local e os parâmetros de rastreamento. Seu código decide *quando* abrir o checkout e *para qual evento*.

## O que ele não é

O cliente não exibe listagens de eventos, datas, preços ou disponibilidade. Se quiser um widget pronto que mostre sua programação, use os códigos de incorporação – basta copiar e colar, sem necessidade de desenvolvimento. Consulte [Incorporar eventos no seu site](/organizers/sharing-and-embedding/embedding-events-on-your-website.md).

No entanto, os dois não são alternativas. O widget incorporado carrega esse mesmo cliente internamente para abrir o checkout, por isso você pode transmitir opções do cliente pela configuração da incorporação. Consulte [Opções avançadas de incorporação](/developers/js-client/embed-advanced-options.md).

## Quando usá-lo

Use o cliente diretamente quando tiver suas próprias páginas de eventos e quiser que seu próprio botão "Comprar ingressos" abra o checkout da 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>
```

Essa é toda a integração. Todo o restante desta seção é refinamento: quais opções existem, como o checkout decide entre um painel e uma janela pop-up e quais eventos você pode monitorar.

## Dois modos de checkout

O checkout é aberto de uma destas duas formas:

- **Painel** – um painel integrado à sua página, que desliza pela direita em computadores e pela parte inferior em dispositivos móveis. O visitante nunca sai do seu site.
- **Pop-up** – uma janela separada do navegador.

O modo painel oferece uma experiência melhor, mas está disponível apenas para domínios que você adicionou como origens confiáveis nas configurações da Entase. O cliente detecta qual modo tem permissão para usar e recorre a uma janela pop-up quando o checkout integrado não é permitido. Esse é o comportamento mais importante a entender antes da integração – consulte [Modos de checkout](/developers/js-client/checkout-modes.md).

## Requisitos

- Uma página servida por **HTTPS**. Em HTTP simples, o cliente sempre usa uma janela pop-up.
- Seu domínio adicionado às **origens confiáveis** em Configurações → Integrações, caso queira o checkout integrado. Consulte [Integrações e personalização do checkout](/organizers/settings/integrations-and-checkout-customization.md).
- Sem etapa de compilação, bundler ou gerenciador de pacotes. A biblioteca é uma única tag de script.

## Próximas etapas

- [Instalar o cliente](/developers/js-client/installing-the-client.md) – carregar o script e criar uma instância.
- [Opções do construtor](/developers/js-client/constructor-options.md) – todas as opções e seus padrões.
- [Abrir o checkout](/developers/js-client/opening-the-checkout.md) – o método `book()` e substituições por chamada.
- [Eventos](/developers/js-client/events.md) – reagir à abertura, ao fechamento e à conclusão do checkout.