Controle popups com a Popup API

A Popup API permite controlar qualquer popup com código, em vez de depender apenas dos gatilhos integrados (carregamento da página, atraso, rolagem, intenção de saída). Chame window.llPopupsApi a partir de um elemento Custom Code ou de qualquer script para abrir um popup com um botão, fechá-lo depois que um formulário for enviado ou conectar popups às suas próprias integrações.

Use o ID do popup, não o nome. Tudo na API identifica o popup pelo id. O nome do popup (o rótulo legível que você vê no editor) é apenas um metadado para análises e exibição - ele nunca é usado para selecionar o popup. Se você usar o nome, nada vai acontecer.

Antes de controlar um popup com código, configure-o para que ele não entre em conflito com seus gatilhos e dê a ele um ID que você possa referenciar.

Defina o gatilho como Manual

Na aba Popup da barra lateral direita, defina o Trigger como Manual (somente botão). O popup nunca vai abrir automaticamente - ele só aparece quando o seu link ou script o abrir.

Você não precisa usar Manual. A API funciona em qualquer popup, independentemente do gatilho. O Manual apenas garante que o popup permaneça fechado até que você mesmo o abra.

Copie o ID do popup

Todo popup já tem um ID exclusivo. Para encontrá-lo, abra o painel Popups na barra lateral esquerda, clique nos três pontos (ações) ao lado do seu popup e escolha Copy ID. Cole esse valor sempre que a API pedir o ID do popup.

A API JavaScript (`window.llPopupsApi`)

Chame o objeto global window.llPopupsApi para abrir, fechar ou alternar um popup - em um evento personalizado, depois de um atraso que você controla ou a partir de outro script. Coloque o código em um elemento Custom Code na sua página.

// Open a specific popup
window.llPopupsApi.open('promo-popup-id');

Seleção do alvo: o ID é opcional

Todo método aceita um ID de popup opcional:

Informe um ID → a ação afeta apenas esse popup.
Omita o ID → a ação afeta todos os popups da página.

window.llPopupsApi.close('promo-popup-id'); // close one popup
window.llPopupsApi.close();              // close all popups on the page

Métodos

Método	O que faz
`open(id?)`	Força a abertura do popup. Reabre o popup mesmo que o visitante o tenha dispensado antes na sessão (a sua chamada explícita prevalece).
`close(id?)`	Fecha o popup com a animação dele. Não define o cookie “stay dismissed” - o popup pode ser acionado novamente.
`dismiss(id?)`	Fecha o popup e o bloqueia: define o cookie de 30 dias se Stay Dismissed estiver ativado, ou a flag de sessão se Show Once estiver ativado. É isso que o botão de fechar integrado faz.
`toggle(id?)`	Abre o popup se ele estiver fechado e o fecha se estiver aberto. (A abertura via toggle força a abertura, assim como `open`.)
`get(id?)`	Retorna o elemento HTML do popup quando você informa um ID (ou `null` se ele não for encontrado), ou um array com todos os elementos de popup quando você omite o ID.

close vs dismiss. close() é um fechamento temporário - gatilhos automáticos como a intenção de saída ainda podem disparar novamente. dismiss() é permanente durante a sessão (e por até 30 dias com Stay Dismissed). Use close() para “talvez mais tarde” e dismiss() para “não mostrar novamente”.

Exemplos

// Wait until the page is ready before wiring things up.
// DOMContentLoaded guarantees both your button and llPopupsApi exist.
document.addEventListener('DOMContentLoaded', function () {
  const button = document.getElementById('my-button');

  button.addEventListener('click', function () {
    window.llPopupsApi.open('promo-popup-id');
  });
});

// Auto-close the popup 5 seconds after it opens
window.llPopupsApi.open('promo-popup-id');
setTimeout(function () {
  window.llPopupsApi.close('promo-popup-id');
}, 5000);

// Toggle a single popup
window.llPopupsApi.toggle('promo-popup-id');

// Close every popup on the page at once
window.llPopupsApi.close();

// Pass an ID to get one element (or null if not found)
const popup = window.llPopupsApi.get('promo-popup-id');

// Omit the ID to get an array of every popup on the page
const allPopups = window.llPopupsApi.get();

Bom saber

Execute seu código depois que a página estiver pronta. window.llPopupsApi só existe depois que o script de popups é carregado. Envolva suas chamadas em um listener DOMContentLoaded — como no exemplo Open from a button acima — para que a API esteja disponível antes de você chamá-la.
Modo de pré-visualização. Nas URLs de pré-visualização, o cookie “Stay Dismissed” e a flag “Show Once” nunca são lidos nem gravados, então o popup sempre aparece enquanto você está testando.
ESC para fechar. Se Close on ESC estiver ativado para o popup, pressionar Esc fecha o popup aberto que estiver por cima - sem precisar de código.
A abertura prevalece sobre a dispensa. Chamar open() reabre um popup mesmo depois que um visitante o dispensou, mas os gatilhos automáticos do próprio popup continuam respeitando a dispensa. Use dismiss() se quiser bloqueá-lo novamente.

Primeiros passos

Landing Pages

Editor visual (Canvas)

IA

Quizzes (funis)

Workflows

Gestão de leads

Domínio

Multiusuário

Testes e relatórios

Blocos globais

Integrações

Perfil

A API JavaScript (`window.llPopupsApi`)

Seleção do alvo: o ID é opcional

Métodos

Exemplos

Bom saber

​Passo 1 - Prepare o popup

​A API JavaScript (window.llPopupsApi)

​Seleção do alvo: o ID é opcional

​Métodos

​Exemplos

​Bom saber

Passo 1 - Prepare o popup

A API JavaScript (`window.llPopupsApi`)

Seleção do alvo: o ID é opcional

Métodos

Exemplos

Bom saber