Visão geral

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.

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.

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:

<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.

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.
• Sem etapa de compilação, bundler ou gerenciador de pacotes. A biblioteca é uma única tag de script.

Próximas etapas

• Instalar o cliente – carregar o script e criar uma instância.
• Opções do construtor – todas as opções e seus padrões.
• Abrir o checkout – o método book() e substituições por chamada.
• Eventos – reagir à abertura, ao fechamento e à conclusão do checkout.