Como ativar o Modal personalizado no AI Web Push

O Modal personalizado é a janela do seu próprio site, com a mensagem que você escolher e na hora que você escolher, que aparece antes do pedido de notificação do navegador. Com ele, o seu site explica ao leitor o que ele vai receber antes de pedir a permissão, que é o que o Google recomenda. Este passo a passo vale para o plugin na versão 1.9.3 ou mais nova, que já está no ar e chega a cada site quando o plugin dele atualiza.

No Chrome do celular Android, a captura mudou. O aviso de notificação aparecia no meio da tela, escurecia a página e interrompia a leitura com dois botões, Bloquear e Permitir. A partir da versão 155, que começa a ser liberada em 06/10/2026 e chega aos aparelhos aos poucos, o Chrome mostra um cartão discreto no alto, logo abaixo da barra de endereço, que se esconde sozinho se o leitor não toca nele.

Por isso, mais do que nunca, o Modal personalizado precisa ser usado, porque o aviso do Chrome só aparece para quem já disse sim ao seu site. Quem depende só do aviso padrão do Chrome pode notar variação na entrada de inscritos enquanto o leitor se acostuma com o cartão novo. O AI Web Push já está preparado para essa mudança, e quem usa o plugin precisa se adaptar o quanto antes. O que mudou no Chrome, em detalhe, está no post O aviso de notificação do Chrome mudou no Android.

Passo a passo

1. No menu lateral do painel do WordPress, clique em "Ai Web Push". A tela tem seis abas, "Configurações da API", "Modal", "Configurações Avançadas", "Migração", "Manutenção" e "Changelog".
2. Abra a aba "Modal".

3. Marque a opção "Modal personalizado". Vão aparecer os campos para montar a sua janela.

   "Mensagem do modal" é o texto que o leitor vai ler, com até 100 caracteres.

   "Texto do botão aceitar" e "Texto do botão cancelar" são os textos dos dois botões, com até 20 caracteres cada.

   "Ícone personalizado do modal" é a imagem da janela. Sem imagem, o plugin usa o favicon do seu site.

   Como exemplo, o texto de fábrica do plugin é "Receba as últimas notícias e atualizações", com os botões "Permitir" e "Agora não".

4. Na mesma aba, escolha a "Posição do modal personalizado". Há uma escolha para desktop e outra para mobile. Ali também ficam as opções do "Overlay do modal personalizado".

5. Escolha quando o modal aparece. Há duas formas.

   Em "Atraso do modal", você define quantos segundos depois do carregamento da página o modal aparece. O valor 0 mostra na hora.

   Em "Ativação por scroll", o modal aparece quando o leitor rola a página até a "Porcentagem de scroll" que você definir. O padrão é 25. Se você prefere pedir só depois que o leitor mostrar interesse na página, use a ativação por scroll.

6. Defina o "Intervalo de reexibição". É o tempo, em minutos, que o seu site espera para pedir de novo ao mesmo leitor que tocou no botão de cancelar (o "Agora não") ou que deixou o cartão do Chrome se esconder sem tocar nele. O pedido só volta quando o leitor abre outra página do seu site. O padrão é 1440 minutos, que são 24 horas. Com o Modal personalizado ligado, o valor 0 faz o pedido voltar já na página seguinte. O campo aparece sempre na aba "Modal", com o Modal personalizado ligado ou desligado, mas pedir já na página seguinte só combina com o modal ligado. Sem ele, cada novo pedido é o próprio cartão do Chrome, e o campo avisa que um valor muito baixo pode levar o navegador a bloquear novos pedidos. Se você não tem um motivo para mudar, deixe 1440.
7. Clique no botão de salvar no fim da página. No WordPress em português ele costuma se chamar "Salvar alterações".

O que o leitor vai ver

1. Depois do tempo ou da rolagem que você definiu, aparece a janela do seu site, com a sua mensagem, o ícone e os dois botões, na posição que você escolheu.
2. Se o leitor tocar no botão de aceitar, aparece em seguida o aviso do próprio navegador pedindo a permissão. O seu modal não substitui esse aviso, ele vem antes, e por isso o aviso do navegador só aparece para quem já disse sim ao seu site. No Chrome do celular Android, a partir da versão 155, esse aviso é um cartão discreto no alto, logo abaixo da barra de endereço, com o botão Permitir. A página continua livre e, se o leitor não toca no cartão, ele se esconde sozinho.
3. Se o leitor tocar em "Agora não", ou se o cartão do Chrome se esconder sem o leitor tocar nele, o plugin pede de novo só depois do "Intervalo de reexibição", e só em outra página do seu site.
4. E se o leitor não tocar no cartão na hora e ativar as notificações depois, pelo ícone ao lado do endereço, o AI Web Push coloca esse leitor na sua base. Se o site estava fechado quando ele ativou, o cadastro acontece na próxima visita ao site. Quem já era inscrito não é cadastrado de novo.

Como conferir que funcionou

Teste como um leitor novo. Abra o seu site num perfil novo do Chrome. Não use a guia anônima, porque o push não funciona nela.

1. O modal aparece com a sua mensagem, os seus botões, o ícone e a posição que você escolheu, depois do tempo ou da rolagem que você definiu.
2. Ao tocar no botão de aceitar, aparece o aviso do Chrome pedindo a permissão. No Chrome do celular Android com a versão 155, é o cartão discreto no alto.
3. Ao aceitar, o plugin envia o cadastro do leitor.

Se o modal não aparecer

1. Confira se a opção "Modal personalizado" está marcada e se você salvou a página.
2. Espere o "Atraso do modal" que você definiu, ou role a página até a "Porcentagem de scroll", se você usa a ativação por scroll. Um atraso grande ou uma porcentagem alta dão a impressão de que o modal não abre.
3. Veja se você já tocou em "Agora não" nesse navegador, ou se já deixou o cartão do Chrome se esconder. Nesse caso, o modal só volta depois do "Intervalo de reexibição", e em outra página. Para testar do zero, use um perfil novo do Chrome.
4. Não teste na guia anônima.
5. Se continuar sem aparecer, fale com o suporte do AI Web Push.

Um aviso honesto

Ligar o Modal personalizado deixa o seu site explicar o que o leitor vai receber antes do aviso do Chrome, na hora que você escolher. Depois do sim na janela do seu site, o leitor ainda vê o cartão do Chrome e precisa tocar em Permitir nele. Quanto isso muda a captação de cada site ainda não foi medido, e por isso não prometemos um número.

Perguntas frequentes sobre a versão 1.9.3 e o Chrome 155

1. O que muda na captura de inscritos com o Chrome 155?

No Chrome do celular Android, a captura mudou. O aviso de notificação era uma caixa no meio da tela e virou um cartão discreto no alto, que se esconde se o leitor não toca. A liberação começa em 06/10/2026 e é gradual, e o AI Web Push já está preparado para essa mudança.

2. O que acontece com quem já é inscrito?

A 1.9.3 não cadastra de novo quem já era inscrito e não tira ninguém da sua base. O anúncio do Chrome fala do cartão novo e não menciona quem já aceitou antes.

3. Preciso fazer alguma coisa?

Sim. A 1.9.3 já está no ar. Atualize o plugin pela atualização de plugins do WordPress, ligue o Modal personalizado e confira o Intervalo de reexibição, o quanto antes. O passo a passo está no início deste artigo.

4. Sou obrigado a ligar o Modal personalizado?

Não. O plugin continua funcionando sem ele, com o aviso padrão do Chrome. Mas ligar é o que recomendamos agora, mais do que nunca, porque o Modal personalizado é a janela do seu site, com a sua mensagem e na hora que você escolher, e o aviso do Chrome só aparece para quem já disse sim. Quem usa só o aviso padrão pode notar variação na entrada de inscritos enquanto o leitor se acostuma com o cartão novo.

5. Com o modal ligado, o aviso do Chrome some?

Não. O aviso do Chrome aparece depois que o leitor toca em Permitir no seu modal. No Chrome do celular Android, é o mesmo cartão discreto no alto, e o leitor ainda precisa tocar em Permitir nele. Se não tocar, o cartão se esconde sozinho.

6. Apareceu um evento novo no meu Tag Manager e no GA4 depois da atualização. O que é?

É a contagem nova de quem não respondeu ao cartão do Chrome, que se escondeu ou foi fechado sem resposta. Não é quem disse não, e essa pessoa ainda pode ativar as notificações depois, pelo ícone ao lado do endereço. O nome do evento novo, como aparece na ferramenta, está abaixo.

ai_web_push_permission_timeout

Os eventos novos e o que cada um mede estão no post AI Web Push e Google Tag Manager.

7. O número de quem disse não ficou menor depois da atualização. É erro?

Não. Depois da atualização, essa contagem passa a incluir só quem disse não de verdade, e quem apenas não respondeu ao cartão do Chrome passa para uma contagem própria. Para comparar com antes, some as duas, como no bloco abaixo.

ai_web_push_permission_denied + ai_web_push_permission_timeout

A explicação completa está em O que muda nos seus números depois de atualizar.

8. O leitor que não tocou no cartão ainda pode se inscrever?

Pode. E se o leitor não tocar no cartão na hora e ativar as notificações depois, pelo ícone ao lado do endereço, o AI Web Push coloca esse leitor na sua base. Se o site estava fechado quando ele ativou, o cadastro acontece na próxima visita ao site. O plugin também pede de novo, em outra página, depois do Intervalo de reexibição.

9. Vou ter mais inscritos?

A 1.9.3 passa a cadastrar quem aceita depois, que antes ficava de fora. Quanto isso muda no seu site, ninguém mediu ainda.

10. E no computador? Quando chega no meu celular?

O anúncio do Chrome fala só de Android, e o que muda no computador não foi publicado. A versão 155 do Chrome começa a ser liberada em 06/10/2026 e chega aos aparelhos aos poucos, conforme o Chrome de cada um se atualiza. Por um tempo, o seu site vai receber leitores com o aviso antigo e leitores com o cartão novo.