Plugin OneSignal para WordPress e push web

​

Visão geral

​

Novidades na Versão 3+

• 🚀 Atualização do SDK: Atualiza o OneSignal Web SDK da versão 15 para 16
• 💬 Prompts no Painel: Configure todos os prompts de permissão diretamente no painel do OneSignal—sem necessidade de código customizado
• ⏩ Publicação com Um Clique: Marque “Enviar notificação quando o post for publicado” para enviar notificações push automaticamente
• 🧑‍🤝‍🧑 Segmentação de Audiência: Escolha quais segmentos recebem notificações para cada post
• 📲 Integração com App Mobile: Envie para assinantes de aplicativos móveis com deep linking opcional

​

Configuração

• Conta OneSignal (grátis para criar)
• Acesso de administrador do WordPress para instalar e configurar plugins
• Site com HTTPS habilitado (necessário para notificações push web)

​

1. Configure o WordPress no Painel do OneSignal

​

Configuração do site

• Site Name: O nome do seu site e título padrão de notificação.
• Site URL: Deve corresponder exatamente à URL do seu site WordPress (siga a política de mesma origem)
• Auto Resubscribe: Ative isso para reinscrever automaticamente usuários que limparam os dados do navegador quando retornarem ao seu site (sem necessidade de novo prompt de permissão)
• Default Icon URL: PNG, JPG ou GIF não animado quadrado de 256×256 para notificações e prompts. Consulte Ícones de notificação.

​

Prompts de permissão

• Configuração Básica de Prompt
• Avançado: Segmentação Baseada em Categorias

1

Clique no Push Slide Prompt para personalizar

2

Configure o tempo e o texto:

• Defina Auto Prompt para 1 visualização de página e 1 segundo para testes iniciais
  • Personalize o texto e a aparência do prompt
  • Ajuste o tempo com base no comportamento do usuário após o lançamento

3

Clique em Done quando terminar de configurar o prompt.

Para mensagens direcionadas baseadas nos interesses do usuário, configure categorias:

1

Selecione Categories nas configurações do seu prompt

2

Configure cada categoria com:

• Label: O que os usuários veem no prompt
• Tag Key: Chave de tag interna para segmentação

3

Clique em Done quando terminar de configurar o prompt.

Lógica de Tags: Categorias marcadas definem o valor da tag como 1, desmarcadas como 0. Essas tags possibilitam mensagens direcionadas para interesses específicos do usuário.

​

Notificação de boas-vindas

• Agradece aos usuários pela inscrição
• Demonstra como as notificações aparecem
• Aumenta o engajamento e reduz cancelamentos de inscrição

​

2. Configure o plugin do WordPress

​

Configurações avançadas

utm_medium=push&utm_source=onesignal&utm_campaign=wordpress-plugin

utm_medium=ppc&utm_source=adwords&utm_campaign=snow%20boots&utm_content=durable%20snow%20boots

• Custom Post Types: Adicione tipos de post de plugins para habilitar opções de notificação
• Automatically send notifications when a post is published: Marca automaticamente a caixa de notificação ao publicar posts para que notificações sejam enviadas sem ter que marcar a caixa manualmente
• Automatically send notifications when a post is updated: Marca automaticamente a caixa de notificação ao atualizar posts para que notificações sejam enviadas sem ter que marcar a caixa manualmente
• Automatically send notifications when a page is published: Marca automaticamente a caixa de notificação ao publicar páginas para que notificações sejam enviadas sem ter que marcar a caixa manualmente
• Automatically send notifications when a page is updated: Marca automaticamente a caixa de notificação ao atualizar páginas para que notificações sejam enviadas sem ter que marcar a caixa manualmente
• Automatically send a push notification when I publish a post from 3rd party plugins: Envia notificações automaticamente de plugins de publicação externos
• Mobile App Integration: Envia notificações para seus assinantes de aplicativo móvel usando o mesmo App ID do OneSignal

​

Service worker

importScripts("https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.sw.js");

​

3. Complete a migração (Somente para Usuários que Estão Atualizando)

​

Testando sua configuração

• Revise Prompts de permissão web para personalização avançada
• Explore Configuração de canais para integração de email e SMS
• Configure estratégias de segmentação para mensagens direcionadas

​

Publicando notificações

​

Notificações básicas de post

• Marque “Send notification when post is published or updated”
• Desmarque para pular o envio de notificação para esse post

​

Segmentação de audiência

​

Enviar para todos os assinantes (padrão)

​

Enviar para segmentos específicos

1. Vá para Audience > Segments no seu painel do OneSignal
2. Crie segmentos usando suas chaves de tag, por exemplo:
   • Segmento News: Tag news é 1
   • Segmento Deals: Tag deals é 1

3. Após criar os segmentos, atualize o editor de posts do WordPress
4. Selecione seu segmento alvo no menu suspenso

​

Personalizando o conteúdo da notificação

​

Comportamento padrão

• Title: Usa o título do seu site WordPress (Settings > General)
• Message: Usa o título do post
• Image: Usa a imagem destacada do post (se definida)
• URL: Link para o post publicado

​

Conteúdo personalizado

​

Adicionar um Custom Post Type ao OneSignal WordPress Plugin

​

Encontre o nome do seu custom post type

https://yoursite.com/wp-admin/post-new.php?post_type=your_custom_type

​

Adicionar às configurações do OneSignal

1. Vá para OneSignal > Settings no admin do WordPress
2. Em Advanced Settings, adicione os nomes dos seus custom post types no campo Custom Post Types
3. Salve as configurações

​

Integração com aplicativo móvel

1. Habilite “Send notification to Mobile app subscribers” nas configurações do plugin
2. No metabox do post, adicione uma Mobile URL para deep linking
3. Usuários móveis serão direcionados para seu app em vez do navegador web

​

FAQ

Como desabilito prompts em páginas específicas?

Nota: Este método funciona apenas com slidedown e prompts de permissão nativos, não com bell ou prompts de link personalizados.

1. No seu painel do OneSignal, vá para Settings > Push & In-App > Web Settings
2. Selecione seu prompt da tabela Permission Prompt Setup
3. Desmarque Auto Prompt e clique em Done

4. Role para baixo, clique em Save, depois em Finish
5. Adicione código JavaScript personalizado em páginas específicas onde você deseja que os prompts apareçam

Isso lhe dá controle completo sobre o tempo e posicionamento dos prompts. Consulte Prompts de permissão web para detalhes de implementação.

Por que meus prompts não estão funcionando após a migração?

Problemas de Cache: O cache do WordPress pode atrasar as mudanças da migração.Solução:Passo 1: Clique com o botão direito no seu site e selecione InspectPasso 2: Vá para a aba NetworkPasso 3: Marque “Disable cache”

Passo 4: Atualize seu site para ver a configuração atualPasso 5: Limpe as configurações do seu plugin de cache do WordPress, se aplicável

O que significa o erro `A bad HTTP response code (404)`?

Este erro indica migração incompleta:

Solução:

1. Certifique-se de que você salvou a configuração do painel do OneSignal
2. No WordPress, clique em “Migration Completed” nas configurações do plugin
3. Clique em Save Settings para finalizar a atualização

Este erro afeta apenas usuários que estão atualizando da versão 2.x.x.

<?php

add_filter('onesignal_send_notification', function ($fields, $post_id) {

  // Add fields supported by the Create notification API:
  // https://documentation.onesignal.com/reference/create-notification

  $fields['web_buttons'] = array(
    array(
      'id' => 'read-more',
      'text' => 'Read More',
      'url' => get_permalink($post_id),
    ),
  );

  return $fields;

}, 10, 2);