WordPress

​

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

Selecione WordPress nas opções de Website Builder no seu 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: Arquivo PNG ou JPG quadrado de 256x256px para notificações e prompts – MacOS Safari não mostrará um prompt de notificação sem um ícone.

Digite sua URL exata do site. https://seu-site.com é diferente de https://www.seu-site.com—use apenas um formato de forma consistente

​

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

Acesse e personalize as configurações do seu push slide prompt

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

Configure o tempo do auto-prompt e personalize a aparência do prompt

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.

Exemplo: Configurar categorias News e Deals cria tags 'news: 1' e 'deals: 1' para usuários que marcam essas opções

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

Copie seu App ID e API Key do painel do OneSignal

Certifique-se de que o App ID e REST API Key do seu plugin WordPress correspondem exatamente ao seu painel do OneSignal

​

Configurações avançadas

Configurações avançadas para funcionalidade aprimorada e rastreamento de analytics

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

​

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

Clique em Migration Completed para finalizar a atualização do seu plugin

​

Testando sua configuração

• Teste Inicial
• Verificar Inscrição
• Enviar Mensagem de Teste

1. Visite seu site (evite navegação anônima/privada—usuários não podem se inscrever nesses modos) 2. Procure pelo slidedown prompt que você configurou

Seu slidedown prompt configurado deve aparecer com base nas suas configurações de tempo

3. Clique no botão de inscrição (rotulado como “Subscribe” neste exemplo)
4. Aceite a permissão do navegador quando solicitado

Prompt de permissão do navegador (aparência varia por navegador) é necessário para notificações push web

5. Verifique a notificação de boas-vindas (se configurada)

Notificação de boas-vindas aparece imediatamente após inscrição bem-sucedida

1. No seu painel do OneSignal, vá para Audience > Subscriptions 2. Você deve ver sua inscrição de push web marcada como “Subscribed”

Inscrições bem-sucedidas aparecem no painel de audiência do OneSignal

1. Navegue até Messages > Push no seu painel do OneSignal 2. Crie uma New Message 3. Envie uma notificação de teste para você mesmo 4. Verifique se a notificação aparece corretamente Consulte nosso guia de mensagens Push para instruções detalhadas.

• 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

Metabox OneSignal Push Notifications—arraste para reposicionar se necessário

• 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

Tags diferenciam maiúsculas de minúsculas! 'news' e 'News' são tags diferentes

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

Selecione segmentos específicos para direcionar grupos de usuários relevantes

​

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

Personalize título, conteúdo e outros elementos da notificação

Notificação push personalizada como aparece para os usuários

​

Adicionar um Custom Post Type ao OneSignal WordPress Plugin

​

Encontre o nome do seu custom post type

https://seusite.com/wp-admin/post-new.php?post_type=seu_tipo_personalizado

​

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

Desabilite Auto Prompt para controlar manualmente quando os prompts aparecem

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”

Desabilite o cache do navegador para forçar o carregamento de arquivos atualizados após a migração

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:

Erro 404 no console do navegador indica processo de migração incompleto

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) {

  // Include any properties mentioned in the Create Notification API Reference:
  // https://documentation.onesignal.com/reference/push-notification eg:

  // Add action buttons
  $fields['web_buttons'] = array(
    array(
      "id" => "read-more",
      "text" => "Read More",
      "url" => get_permalink($post->ID)
    )

  // Return the modified fields array
  return $fields;

}, 10, 2);