Pular para o conteúdo principal

​
Visão geral

Este guia cobre como configurar e configurar o OneSignal WordPress Web Push Plugin v3+.
Para a documentação mais antiga do WordPress versão 2.x.x, veja Plugin WordPress Legacy.

​
O Que Há de Novo na Versão 3+

Este lançamento marca uma atualização significativa ao simplificar o processo de configuração e configuração. Com a Versão 3+, você pode gerenciar todas as suas configurações de prompt em um só lugar—o Dashboard OneSignal.
  • 🚀 Atualização do SDK: Atualiza o OneSignal Web SDK da versão 15 para 16
  • 💬 Prompts no Dashboard: Configure todos os prompts de permissão diretamente no dashboard OneSignal—sem necessidade de código personalizado
  • ⏩ Publicação com Um Clique: Marque “Enviar notificação quando post for publicado” para enviar automaticamente notificações push
  • 🧑‍🤝‍🧑 Segmentação de Público: Escolha quais segmentos recebem notificações para cada post
  • 📲 Integração com App Mobile: Envie para inscritos de app mobile com deep linking opcional
Para a documentação mais antiga do WordPress versão 2.x.x, veja Plugin WordPress Legacy.

​
Configuração

Antes de começar, certifique-se de ter:
  • Conta OneSignal (gratuito para criar)
  • Acesso de administrador WordPress para instalar e configurar plugins
  • Website habilitado para HTTPS (necessário para notificações web push)

​
1. Configurar WordPress no Dashboard OneSignal

Navegue para Settings > Push & In-App > Web > WordPress Plugin or Website Builder

Selecione WordPress das opções de Website Builder no seu dashboard OneSignal

​
Configuração do site

  • Site Name: O nome do seu site e título de notificação padrão.
  • Site URL: Deve corresponder à URL exata do seu site WordPress (siga Política de mesma origem)
  • Auto Resubscribe: Habilite isto para reinscrever automaticamente usuários que limpam seus dados de navegador quando retornam ao seu site (nenhum novo prompt de permissão necessário)
  • 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.

Insira sua URL de Site exata. https://seu-site.com é diferente de https://www.seu-site.com—use apenas um formato consistentemente

Testando localmente? Veja Guia de Testes Locais para desenvolvimento localhost

​
Prompts de permissão

Configure seus prompts de permissão para Push, Email e SMS. O Push Slide Prompt está habilitado por padrão, mas você pode personalizar ou adicionar prompts adicionais.
Dica Profissional: Comece com prompts simples e adicione complexidade gradualmente. Você pode modificar todas as configurações de prompt a qualquer momento através do dashboard OneSignal. Explore todas as opções disponíveis em Prompts de permissão web.
  • Configuração de Prompt Básica
  • Avançado: Segmentação Baseada em Categoria
1

Clique em Push Slide Prompt para personalizar

Acesse e personalize suas configurações de prompt slide push

2

Configure tempo e texto:

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

Configure tempo de auto-prompt e personalize aparência do prompt

3

Clique em Done quando você terminar de configurar o prompt.

Dica Profissional: Comece com prompts simples e adicione complexidade gradualmente. Você pode modificar todas as configurações de prompt a qualquer momento através do dashboard OneSignal. Explore todas as opções disponíveis em Prompts de permissão web.

​
Notificação de boas-vindas

Configure uma notificação imediata enviada após usuários se inscreverem pela primeira vez. Isto:
  • Agradece usuários por se inscreverem
  • Demonstra como notificações aparecem
  • Aumenta engajamento e reduz cancelamentos de inscrição
Configure seu texto e tempo de mensagem de boas-vindas, depois role para baixo e clique em Save.
Pule a seção Advanced Push Settings por enquanto — estas são para configuração personalizada de Web SDK. Clique em Save para continuar.

​
2. Configurar plugin WordPress

Após salvar sua configuração do dashboard, você verá seu App ID e API Key. Copie estes valores para seu plugin WordPress:

Copie seu App ID e API Key do dashboard OneSignal

Não vê uma API Key? Siga nosso guia Keys & IDs para criar uma.
1

No seu admin WordPress, navegue para as configurações do plugin OneSignal

2

Cole o App ID e REST API Key exatamente como mostrado no seu dashboard

Garanta que seu App ID e REST API Key do plugin WordPress correspondem exatamente ao seu dashboard OneSignal

​
Configurações avançadas

Configure opções adicionais do plugin baseadas nas suas necessidades:

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

Rastreamento de parâmetros de URL Adicione parâmetros de analytics às URLs de notificação para rastreamento. Importante: Escape caracteres especiais—entrada é adicionada como está às URLs. Exemplo para Google Analytics: 
utm_medium=push&utm_source=onesignal&utm_campaign=wordpress-plugin
Exemplo com caracteres especiais: 
utm_medium=ppc&utm_source=adwords&utm_campaign=snow%20boots&utm_content=durable%20snow%20boots
Configurações adicionais
  • 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 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 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 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 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: Envio automático de notificações de plugins de publicação externos
  • Mobile App Integration: Envie notificações para seus inscritos de app mobile usando o mesmo OneSignal App ID

​
3. Completar migração (Apenas Usuários em Atualização)

Novas instalações podem pular este passo. Se você está atualizando da v2+, continue lendo…
Tempo Limitado: Complete estes passos O MAIS RÁPIDO POSSÍVEL para evitar que usuários percam notificações durante a transição.
1

Após salvar sua configuração do dashboard OneSignal, retorne ao WordPress

2

Clique em Migration Completed nas configurações do plugin

3

Clique em Save Settings para finalizar a atualização

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

Configuração completa! Clique em Save Settings para finalizar a configuração do plugin.

​
Testando sua configuração

  • Teste Inicial
  • Verificar Inscrição
  • Enviar Mensagem de Teste
  1. Visite seu website (evite navegação anônima/privada—usuários não podem se inscrever nestes modos) 2. Procure pelo slidedown prompt que você configurou

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

  1. Clique no botão de inscrever (rotulado como “Subscribe” neste exemplo)
  2. Aceite a permissão do navegador quando solicitado

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

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

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

Sucesso! Seu site WordPress agora está configurado para notificações web push. Usuários começarão a aparecer em suas Subscriptions à medida que se inscrevem.
Próximos Passos:
Tendo Problemas? Verifique nosso guia de solução de problemas WordPress para soluções comuns.

​
Publicando notificações

Quando você agenda um post para ser publicado, OneSignal também agendará uma notificação push para ser enviada aos seus inscritos no horário agendado. Se você reagendar o post, a notificação push será cancelada e uma nova push será agendada para o novo horário. Você pode ver suas notificações agendadas e canceladas no dashboard OneSignal em Delivery > Scheduled Messages. Veja Relatórios de mensagens push para mais detalhes.

​
Notificações básicas de post

Ao criar ou editar um post WordPress, localize o metabox OneSignal Push Notifications (geralmente na parte inferior ou barra lateral do editor de post).

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

Para enviar uma notificação:
  • Marque “Send notification when post is published or updated”
  • Desmarque para pular envio de notificação para aquele post

​
Segmentação de público

​
Enviar para todos os inscritos (padrão)

Por padrão, notificações vão para todos os inscritos push.

​
Enviar para segmentos específicos

Direcione públicos específicos usando segmentos que você cria em OneSignal Dashboard > Audience > Segments. Se você configurou categorias no Passo 3, crie segmentos correspondentes:
  1. Vá para Audience > Segments no seu dashboard OneSignal
  2. Crie segmentos usando suas chaves de tag, por exemplo:
    • News Segment: Tag news é 1
    • Deals Segment: Tag deals é 1

Tags são sensíveis a maiúsculas! 'news' e 'News' são tags diferentes

  1. Após criar segmentos, atualize seu editor de post WordPress
  2. Selecione seu segmento alvo do dropdown

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

Segmentação Avançada: Crie segmentos baseados em comportamento do usuário, localização, tipo de dispositivo e mais. Tags fornecem a maior flexibilidade para dados de usuário personalizados e personalização.

​
Personalizando conteúdo de notificação

​
Comportamento padrão

  • Title: Usa seu título de 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

Marque “Customize notification content” para sobrescrever padrões:

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

Resultado de exemplo:

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

​
Adicionar um Custom Post Type ao OneSignal WordPress Plugin

​
Encontre seu nome de custom post type

Olhe na barra de endereço do seu navegador ao criar um novo post. A URL será assim: 
https://seusite.com/wp-admin/post-new.php?post_type=seu_tipo_personalizado
O valor do parâmetro post_type (por exemplo, seu_tipo_personalizado) é o nome exato que você precisará adicionar nas configurações do plugin OneSignal.

​
Adicionar às configurações OneSignal

  1. Vá para OneSignal > Settings no admin WordPress
  2. Em Advanced Settings, adicione seus nomes de custom post type ao campo Custom Post Types
  3. Salve configurações
Exemplos comuns: product (WooCommerce), tribe_events (Events Calendar), portfolio

​
Integração com app mobile

Se você tem um app mobile usando o mesmo OneSignal App ID:
  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 mobile serão direcionados ao seu app ao invés do navegador web
Pronto para Escalar: Explore estratégias avançadas de push e journeys automatizadas para campanhas de notificação sofisticadas.
Notificações Não Aparecem? Verifique nosso guia de solução de problemas Web push para soluções.

​
FAQ

Nota: Este método funciona apenas com slidedown e prompts de permissão nativa, não bell ou prompts de link personalizado.
  1. No seu dashboard 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 prompts aparecem

  1. Role para baixo, clique em Save, depois Finish
  2. Adicione código JavaScript personalizado a páginas específicas onde você quer que prompts apareçam
Isto lhe dá controle completo sobre tempo e posicionamento do prompt. Veja Prompts de permissão web para detalhes de implementação.
Sim! Se seu app mobile usa o mesmo OneSignal App ID:
  1. Habilite “Send notification to Mobile app subscribers” nas configurações do plugin WordPress
  2. Ao publicar posts, use o campo Mobile URL no metabox OneSignal para especificar deep links
  3. Sem uma Mobile URL personalizada, usuários serão direcionados ao seu website
Este recurso habilita mensagens cross-platform de uma única interface WordPress.
O plugin WordPress atualmente suporta apenas notificações push. Para email e SMS:
  1. Email: Siga nosso guia de configuração Email, depois use ferramentas de mensagens Email
  2. SMS: Siga nosso guia de configuração SMS, depois use ferramentas de mensagens SMS
Ambos os canais podem ser gerenciados do mesmo dashboard OneSignal ao lado de suas notificações push.
Problemas de Cache: Cache do WordPress pode atrasar mudanças de migração.Solução:Passo 1: Clique com botão direito no seu website e selecione InspectPasso 2: Vá para a aba NetworkPasso 3: Marque “Disable cache”

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

Passo 4: Atualize seu website para ver configuração atualPasso 5: Limpe suas configurações de plugin de cache WordPress se aplicável
Este erro indica migração incompleta:

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

Solução:
  1. Garanta que você salvou sua configuração do dashboard 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 atualizando da versão 2.x.x.
Sim, você pode usar o filtro onesignal_send_notification.
Coloque código PHP personalizado em wp-content/mu-plugins/onesignal-custom.php. Isto garante que carrega corretamente e previne que seja sobrescrito por atualizações.
<?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);