Pré-requisitos
- Website WordPress com acesso de admin
- HTTPS habilitado (necessário para notificações web push)
- Conta OneSignal (gratuita em onesignal.com)
Passo 1: Escolha a Integração
Crie sua conta OneSignal em onesignal.com. Se este não for seu primeiro app, selecione New App/Website, nomeie seu app, selecione Web, e clique em “Next”.

Passo 2: Configuração do Site
Configure as informações do seu site cuidadosamente pois estas configurações afetam todas as notificações:
| Field | Description | Requirements |
|---|---|---|
| Site Name | Nome padrão exibido em notificações push | Mantenha conciso para melhor exibição |
| Site URL | URL completa do seu website | Deve incluir http:// ou https:// e corresponder ao formato real da sua URL |
| Auto Resubscribe | Reinscreve automaticamente usuários que retornam (apenas HTTPS) | Recomendado - Reduz atrito para usuários que limparam dados do navegador |
| Default Icon URL | Ícone para prompts e notificações | Deve ser HTTPS, quadrado 256x256 pixels, formato PNG/JPG/GIF |
Formato de URL Importante: Garanta que sua URL do Site corresponda exatamente a como usuários acessam seu site. URLs incompatíveis (www vs não-www, http vs https) podem causar problemas de subscription.
Passo 3: Configurações Avançadas de Push (Opcional)
OneSignal fornece certificados Safari Web Push sem custo. Apenas faça upload de certificados personalizados se você tiver requisitos específicos.
- Você tem certificados Safari existentes
- Sua organização requer gerenciamento específico de certificado
- Você precisa de marca personalizada de certificado
Passo 4: Configure o Plugin WordPress
Instale o Plugin
Adicione o Plugin WordPress OneSignal do seu admin WordPress ou procurando “OneSignal” no diretório de plugins.Configure Chaves API
Copie seu App ID e API Key do dashboard OneSignal:

Habilite Prompts de Push
Ative o Slide Prompt e Subscription Bell para solicitar permissão dos visitantes:

Passo 5: Teste Sua Configuração
Verifique a Instalação
- Visite seu website (você pode precisar limpar plugins de cache)
- Procure pelo OneSignal Slide Prompt e Subscription Bell
- Inscreva-se para testar o fluxo
- Verifique OneSignal Dashboard → Audience → Users para confirmar sua subscription
Envie Notificação de Teste
Navegue para OneSignal Dashboard → Messages → New Push para enviar sua primeira notificação e verificar que tudo funciona.Solução de Problemas: Se prompts não aparecerem, verifique se notificações push estão habilitadas nas configurações do seu dispositivo e tente limpar o cache do seu navegador.
Passo 6: Configure Prompts de Notificação
Configure como e quando usuários veem prompts de subscription na seção Configure:Subscription Bell
Um ícone persistente (geralmente no canto) que usuários podem clicar a qualquer momento para gerenciar seu status de subscription.Slide Prompt
Um diálogo modal que aparece baseado nas suas configurações de tempo para solicitar permissão. Próximos Passos: Usuários tipicamente querem personalizar tempo e aparência do prompt. Veja a seção Personalizações Avançadas abaixo.Passo 7: Notificações Automáticas de Post
Configuração Básica
Ao criar posts, você verá uma seção OneSignal. Marque Send notification on post publish para notificar inscritos:
Auto-Habilitar Notificações
Para marcar automaticamente esta caixa para todos os novos posts:- Vá para OneSignal Push → Automatic Notification Settings
- Habilite Automatically send a push notification when I create a post
- Salve configurações

Notificações de Boas-Vindas
Configure mensagens de boas-vindas opcionais enviadas imediatamente após usuários se inscreverem. Edite ou desabilite estas na seção Configure do seu plugin.Limitação de Taxa: Múltiplas notificações para o mesmo post são limitadas a uma por minuto para prevenir spam.
Personalizações Avançadas
O plugin WordPress OneSignal carrega nosso Web Push SDK com suas opções configuradas. Você pode usar quaisquer APIs JavaScript do Web Push SDK para personalizar ainda mais a experiência.Nota para Desenvolvedores: Esta seção requer conhecimento de JavaScript e PHP. Se você precisa de ajuda adicionando código ao seu site, considere usar plugins como Insert Headers and Footers ou Custom CSS & JS.
Personalizando Prompts de Subscription
Configuração Avançada de Prompt
Para personalização sofisticada de prompt incluindo atrasos, categorias e coleta de email:Passo 1: Desabilite Prompts Padrão
Em OneSignal WordPress Plugin → Prompt Settings, DESLIGUE o Slide e Native Prompt (você pode manter o Bell habilitado).
Passo 2: Habilite Inicialização Manual
Role para Advanced Settings e ative “Disable OneSignal initialization”, então Salve.
Passo 3: Adicione JavaScript Personalizado
Adicione este código ao seu site (após o atraso de 3 segundos mostrado nos exemplos):Prompts Específicos de Página
Método PHP do Lado do Servidor
Use o filtroonesignal_initialize_sdk para controlar inicialização baseado em propriedades de página.
Método JavaScript do Lado do Cliente
Habilite “Disable OneSignal initialization” e adicione JavaScript condicional para inicializar OneSignal apenas em páginas específicas.Prompts Multi-Idioma
Para sites de idioma único, simplesmente traduza o texto na configuração do prompt. Para sites multi-idioma, use o método de inicialização manual acima e detecte o idioma da página para exibir texto apropriado.Segmentação e Direcionamento de Usuário
Marcando Usuários
Categorize usuários com Data Tags para enviar notificações direcionadas:Direcionando Segmentos
Crie Segments no seu dashboard OneSignal usando filtros User Tag, então direcione-os com o filtroonesignal_send_notification:
Imagens Destacadas em Notificações
Habilite Suporte de Imagem Destacada
Garanta que seu tema suporte imagens destacadas. Verifique ofunctions.php do seu tema para:
Configure Configurações de Imagem
Em OneSignal Push → Sent Notification Settings, ative as opções de imagem destacada desejadas:
Integração de Plugin de Terceiros
Tipos de Post Padrão
Habilite Automatically send a push notification when I publish a post from 3rd party plugins para tipos de post padrão.
Tipos de Post Personalizados
Adicione tipos de post personalizados (separados por vírgula) ao campo Additional Custom Post Types:
https://seusite.com/wp-admin/post-new.php?post_type=seu_tipo_personalizado
O parâmetro post_type mostra o nome a adicionar.
Integração de App Móvel
Método 1: Abertura Simples de Navegador Web
Habilite Send notifications additionally to iOS & Android platforms nas configurações do seu plugin WordPress.
Método 2: Deep Linking
Para comportamento de app móvel personalizado, desabilite a configuração acima e use este código PHP:Hooks e Filtros do Plugin WordPress
Posicionamento de Código
Coloque código PHP personalizado em
wp-content/mu-plugins/ para prevenir que seja sobrescrito por atualizações.wp-content/mu-plugins/onesignal-custom.php com seu código personalizado.
onesignal_send_notification
Modifique parâmetros de notificação antes de enviar:onesignal_initialize_sdk
Controle quando OneSignal inicializa:onesignal_include_post
Force notificações para tipos de post específicos:onesignal_meta_box_send_notification_checkbox_state
Controle o estado padrão do checkbox de notificação:Sites Mistos WordPress/Não-WordPress
Para sites com páginas WordPress e não-WordPress:- Use Configuração com Código Personalizado no dashboard OneSignal
- Adicione este código a páginas não-WordPress:
Solução de Problemas
Problemas Comuns
Erro “No Recipients”
- Causa: Tentar enviar múltiplas notificações para o mesmo post muito rapidamente
- Solução: Aguarde pelo menos um minuto entre notificações para o mesmo post
Prompts Não Aparecem
- Causa: Plugins de cache, configurações de navegador ou problemas de inicialização
- Soluções:
- Limpe todos os plugins de cache
- Verifique permissões de notificação do navegador
- Verifique que HTTPS está habilitado
- Confirme que a configuração do plugin está salva
Aviso “Couldn’t load wp.data”
- WordPress 5+ com Gutenberg: Pode indicar problemas de configuração - contate o suporte
- WordPress 4.x: Seguro ignorar - este aviso não afeta a funcionalidade
Tipos de Post Personalizados Não Funcionam
- Causa: Faltando meta dados necessários
- Solução: Use o filtro
onesignal_include_postpara incluir explicitamente seu tipo de post
Notificações Não Agendando
- Causa: Cron do WordPress ou conflitos de tema
- Soluções:
- Use OneSignal Dashboard ou API para agendamento
- Implemente agendamento personalizado com filtro
onesignal_send_notification - Use integração Zapier para automação
Entradas de Banco de Dados
OneSignal cria estas entradas na sua tabelawp_postmeta:
| Entry | Description |
|---|---|
onesignal_meta_box_present | Confirma que OneSignal estava ativo quando o post foi publicado |
onesignal_send_notification | Rastreia envio de notificação |
status | Status HTTP da notificação (200 = sucesso) |
response_body | Resposta API com ID de notificação e contagem de destinatários |
recipients | Número de usuários que receberam a notificação |
Obtendo Ajuda
- Problemas com Plugin: Verifique Solução de Problemas de WordPress Web Push
- Suporte Geral: Contate
[email protected] - Fonte do Plugin: Disponível no GitHub
Próximos Passos
Após completar esta configuração:- Monitore Desempenho: Verifique seu dashboard OneSignal regularmente para crescimento de inscritos e métricas de engajamento
- Otimize Prompts: Experimente com diferentes tempos e mensagens de prompt
- Segmente Usuários: Implemente marcação para enviar notificações mais direcionadas
- Teste Completamente: Envie notificações de teste para diferentes dispositivos e navegadores
- Planeje Estratégia de Conteúdo: Desenvolva uma estratégia de notificação que adicione valor sem sobrecarregar usuários