Por que notificações push geram o maior engajamento
O que você pode fazer com o Push do OneSignal
- Enviar campanhas de marketing e mensagens transacionais do Dashboard ou API
- Construir fluxos push automatizados e multicanal com Jornadas
- Segmentar usuários com precisão usando Segmentos, filtros ou dados do usuário
- Testar A/B e otimizar desempenho
- Personalizar mensagens com atributos do usuário e Conteúdo Dinâmico
- Integrar com CRMs e ferramentas como HubSpot, Mixpanel, Amplitude, Zapier e mais
Configuração Push
Antes de enviar notificações push, conclua as seguintes etapas de configuração:- Configuração específica da plataforma (push móvel, push web, Android, iOS, etc.)
- Configurar prompts de permissão (permitir que os usuários optem por notificações push)
- Configurar recursos e casos de uso (personalização, multi-idioma, limitação, etc.)
Push móvel
Push web
Configuração do SDK Móvel
Configuração do SDK Web
Migrar para o OneSignal
Suporte a aplicativos macOS
Suporte a aplicativos Windows
Suporte a WatchOS e WearOS
Prompts de permissão
Uma ótima experiência de opt-in maximiza sua audiência push:Móvel: Solicitar permissões push
Web: Solicitar permissões push
Móvel: Notificações Push Provisórias do iOS
Móvel: Categorias de Notificação Android
Recursos e casos de uso avançados
Como fazer cada notificação push contar
Personalização de Mensagens
Mensagens Multilíngues
Limitação de Taxa
Limitação de Frequência
Notificações de dados e em segundo plano
Notificações VOIP
Analytics
Rastreie desempenho e otimize engajamento:Relatórios de mensagens push
Fluxos de Eventos
API de visualização de mensagens
Visão geral de Analytics
Enviar notificações push
Você pode enviar mensagens de várias maneiras com base em suas necessidades.A/B Testing
Jornadas
API
Painel
Selecionar o canal de mensagem
- Na barra lateral esquerda, selecione + Create… > Push ou no canto superior direito, selecione New Message > New Push.
- Você também pode navegar para Messages > Push para ver mensagens criadas anteriormente no painel.

Opções de envio de nova mensagem no painel do OneSignal.
Escolher um método de composição
Definir um nome e rótulo
- Adicione metadados de rastreamento interno.
- Equivalente na API:
name
Definir audiência de segmentação
- Enviar para segmento padrão: Padrão para todos os “Subscribed Users” se nenhum for definido.
- Enviar para segmentos específicos: Inclua e exclua segmentos explicitamente. Vários segmentos têm uma relação “OR”; Assinaturas duplicadas são removidas automaticamente.

Interface de seleção de nome, rótulo e segmento de audiência
| Método de segmentação | Dashboard | API |
|---|---|---|
| Segments | ✅ | ✅ |
| Filters (Somente API) | ❌ | ✅ |
| Aliases (Somente API) | ❌ | ✅ |
Agendamento e entrega por usuário
O tempo é tudo: Como enviar notificações push que geram ação

Opções de agendamento e entrega no painel do OneSignal.
- Scheduled Delivery: Envie em um horário específico com até 30 dias de antecedência (API:
send_after) - Intelligent Delivery: Otimize por comportamento do usuário (API:
delayed_option: last-active) - Timezone Delivery: Entregue no horário local (API:
delayed_option: timezone&delivery_time_of_day) - Throttling: Limite a velocidade de entrega (API:
throttle_rate_per_minute) - Frequency Capping: Limite mensagens por usuário (API:
enable_frequency_cap)
Propriedades de design
Como transformar notificações push genéricas em mensagens de alto desempenho
- Notificações de exibição: Requerem uma mensagem e podem incluir um título, imagem, botões de ação e outros elementos visuais.
- Notificações de segundo plano/somente dados: Omitem a mensagem, incluem content_available e opcionalmente dados adicionais.

1: Título, 2: Mensagem, 3: Ícone, 4: Imagem, 5: Botões de ação, 6: Nome do aplicativo ou navegador, 7: Timestamp recebido
Título
Texto personalizável superior da notificação. A aparência do texto é controlada pelo sistema operacional (sem fontes personalizadas ou estilo como negrito ou itálico).- Obrigatório para web push e Huawei
- Padrão para nome do site na web se não definido
- Limite recomendado: 25–50 caracteres (móvel), 60–80 (web)
- Suporta: Compositor de mensagem com IA, emojis 👍, personalização de mensagem, mensagens multi-idioma
- API:
headings
Subtítulo
Texto secundário suportado apenas no iOS e macOS (via APNs). Não disponível no Android ou web.- Limite recomendado: 25–50 caracteres
- Suporta: emojis 👍, personalização de mensagem, mensagens multi-idioma
- API:
subtitle
Mensagem
Conteúdo principal da notificação. Não suporta fontes personalizadas ou estilo como negrito, itálico ou sublinhados. O estilo é definido pelo sistema operacional.- Obrigatório a menos que envie notificação em segundo plano
- Suporta: Compositor de mensagem com IA, emojis 👍, Personalização de Mensagem, Mensagens multi-idioma
- Limite: ~150 caracteres
- API:
contents
Ícones
Personalize ícones pequenos e grandes no Android e web. iOS sempre usa o ícone do aplicativo.- Consulte Ícones de notificação
Imagem
Adicione uma imagem grande às notificações no Android, iOS e Chrome para Windows/Android.- Tamanho recomendado para todas as plataformas:
1024×512px(proporção 2:1) - Tamanho máximo: 1 MB, largura máxima: 2000 px
- Não suportado no Safari (macOS/iOS) ou Centro de Notificações do macOS
- A imagem deve ser tocada ou expandida no móvel para visualizar
- Formatos suportados:
PNG,JPG,GIF(animado apenas no iOS) - Parâmetros da API:
ios_attachments– iOSbig_picture– Androidchrome_web_image– Chrome web
- Consulte Imagens e Mídia Avançada
Nome do aplicativo
O nome do aplicativo que exibe a notificação.- iOS: Definido no Xcode em Display Name; requer reinicialização do dispositivo para atualizar
- Android/Amazon/Huawei: Definido em
AndroidManifest.xmlem<application android:label="YOUR APP NAME"> - Web: Mostra o nome do site e/ou navegador
Propriedades de recursos
Botões de Ação
Adicione botões interativos à notificação push.- Suportado no Android 4.1+ e iOS 8.0+
- Consulte Botões de ação
Launch URL
Controle para onde os usuários vão ao tocar na notificação.- Parâmetros da API:
url: URL universal únicaapp_url: deep link (por exemplo,your-app://screen)web_url: link webhttpouhttps
- Consulte URLs, Links e Deep Links
Badges
Mostre pontos ou números de badge em ícones de aplicativo.- iOS: Badge numérico vermelho; pode definir, incrementar ou limpar
- API:
ios_badgeType,ios_badgeCount
- API:
- Android: Requer categorias de notificação
- Web (Chrome/Android):
- Ícone mostrado na barra de status do Android
- Deve ser um PNG alfa 72×72
- API:
chrome_web_badge - Ícone de exemplo →
- Consulte Badges
Som
Reproduza um som quando o push for entregue.- iOS: Definir com
sound - Android: Definir via categorias de notificação
- Web: Não disponível
Dados adicionais
Adicione pares chave-valor personalizados ao payload para manipulação do SDK.- Usado por:
- Extensões de serviço móvel
- Listeners de clique no SDK móvel e SDK web
- O Dashboard suporta apenas dados chave-valor simples
- Para enviar JSON aninhado, use a API com
data - Tamanho do payload:
- Tamanho total máximo: ~4KB
- Campo
data: até 2048 bytes
- Payload OSNotification →
Collapse ID (push móvel)
Substitua notificações anteriores por uma mais recente se compartilharem o mesmocollapse_id.
- Comprimento máximo: 64 caracteres
- API:
collapse_id
Web push topic (push web)
Evite substituir notificações antigas na web usando valores únicos deweb_push_topic.
- Comprimento máximo: 64 caracteres
- API:
web_push_topic
Prioridade
Defina a urgência do push, especialmente em modos de economia de bateria.- High (recomendado): Mensagens imediatas, baseadas em alerta
- Normal: Usado para notificações de segundo plano/dados
priority
Docs da plataforma:
Tempo de vida (TTL)
Por quanto tempo manter uma mensagem se o dispositivo estiver offline.- Padrão: 3 dias
- Intervalo: 0 a 2.419.200 segundos (28 dias)
- API:
ttl
ttl: 0 — Se o dispositivo estiver offline quando a mensagem for enviada, ela nunca será entregue.
Agrupamento de notificações
Android e iOS agruparão notificações automaticamente após o dispositivo receber 4 ou mais notificações para seu aplicativo. Agrupamento de notificações iOS- Use a propriedade REST API
thread_idcom o mesmo valor para agrupar mensagens juntas.
- Use a propriedade REST API
android_groupcom o mesmo valor para agrupar mensagens juntas. - Android “Group Key” também pode ser definida ao enviar mensagens push do painel.
NotificationExtenderService para atualizar a notificação de resumo. Consulte o Guia de Notificação de Grupo do Android para mais detalhes.
Observe que existem algumas limitações que o Android 7+ tem para essas notificações de resumo. Você só pode modificar o texto, cor de destaque e ícone pequeno (não ícone grande). No entanto, você ainda pode modificar os filhos.
