Prompt

O artefato Prompt define o componente responsável por solicitar ao usuário autorização para receber notificações push.

Esse componente é exibido no site como uma interface de opt-in, apresentando ao usuário a opção de aceitar ou recusar o recebimento de notificações.

Quando o usuário aceita o prompt:

1. O navegador exibirá a solicitação nativa de permissão para notificações.
2. Se o usuário conceder a permissão, ele será registrado na base de inscritos da família TagPush.
3. A partir desse momento, o navegador ficará apto a receber notificações enviadas pela plataforma.

Caso o usuário recuse o prompt, a inscrição não será realizada. O prompt poderá ser exibido novamente no futuro, conforme as configurações definidas.

Se o usuário bloquear a permissão diretamente no navegador, a inscrição será cancelada e o prompt não voltará a aparecer até que o usuário redefina manualmente as permissões de notificação nas configurações do navegador.

O Prompt também é responsável por gerenciar a base de usuários inscritos. Todos os usuários que aceitarem o opt-in por meio desse componente passam a compor a base utilizada pelo TagPush.

Essa base será utilizada por todas as campanhas de qualquer família de produtos TagPush, funcionando como a origem comum dos usuários aptos a receber notificações.

Por ser um componente visual, o Prompt oferece opções avançadas de personalização, incluindo:

• CSS personalizado, para ajustar aparência e layout.
• Javascript personalizado, para controlar comportamentos ou interações com o DOM.

Fluxo de Interação

Prompt:

Opt-in (usuário aceita receber notificações):

Opt-out (usuário nega o recebimento):

Configuração

Campo	Tipo	Obrigatório	Descrição
promptType	string	Sim	Tipo de exibição do prompt
showAfterPageview	number	Não	Número de páginas visitadas antes de exibir
showAfterTimeDelay	number	Não	Tempo (ms) antes de exibir o prompt
promptMessage	string	Não	Mensagem exibida ao usuário
buttonPositive	string	Não	Texto do botão de aceite
buttonNegative	string	Não	Texto do botão de recusa
customCss	string	Não	CSS customizado do prompt
customJs	string	Não	JS customizado para comportamento
applyRules	object	Sim	Regras que definem onde o prompt será exibido

promptType

Tipo: string
Obrigatório: Sim

Define o formato de exibição do prompt.

Exemplo:

• SLIDE → prompt exibido como elemento deslizante na interface

---

showAfterPageview

Tipo: number
Obrigatório: Não

Define após quantas páginas visitadas o prompt será exibido.

Exemplo:

• 2 → exibe após o usuário navegar por 2 páginas

---

showAfterTimeDelay

Tipo: number
Obrigatório: Não

Tempo (em milissegundos) de espera antes de exibir o prompt.

Exemplo:

• 5000 → exibe após 5 segundos

---

promptMessage

Tipo: string
Obrigatório: Não

Mensagem exibida ao usuário no prompt.

Exemplo:

• Deseja receber notificações com ofertas e novidades?

---

buttonPositive

Tipo: string
Obrigatório: Não

Texto do botão de aceite (opt-in).

Exemplo:

• Aceitar
• Quero receber

---

buttonNegative

Tipo: string
Obrigatório: Não

Texto do botão de recusa (opt-out).

Exemplo:

• Agora não
• Recusar

---

applyRules

Tipo: Regras de aplicação

Obrigatório: Sim

Define em quais páginas ou condições o prompt será exibido. Permite controlar, por exemplo:

• URLs específicas;
• Tipos de página;
• Condições de navegação.

---

customCss

Tipo: string
Obrigatório: Não

Permite customizar o estilo visual do prompt.

Pode ser utilizado para:

• Alterar cores;
• Ajustar layout;
• Customizar tipografia.

---

customJs

Tipo: string
Obrigatório: Não

Permite adicionar comportamentos personalizados ao prompt.

Pode ser utilizado para:

• Interações com o DOM;
• Regras adicionais de exibição;
• Integrações específicas.

warning

Uso avançado. Recomenda-se apoio do time Etag.