Por que notificações push geram o maior engajamento
- Enviar campanhas e mensagens transacionais do Dashboard ou API
- Automatizar fluxos multicanal com Jornadas
- Segmentar usuários com precisão usando Segmentos, filtros ou dados do usuário
- Testar A/B e otimizar o desempenho das mensagens
- Personalizar conteúdo com atributos do usuário e conteúdo dinâmico
- Integrar com seu stack — HubSpot, Mixpanel, Amplitude, Zapier e mais
Configuração Push
Antes de enviar notificações push, conclua a configuração da plataforma, configure os prompts de permissão e habilite os recursos necessários.Guias de configuração de plataforma
Configuração de push móvel
Configuração de 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 Wear OS
Permissões
Uma experiência de opt-in bem projetada maximiza sua audiência push.Prompts de push móvel
Prompts de push web
Push Provisório iOS
Categorias de Notificação Android
Recursos e casos de uso avançados
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
Enviar notificações push
Você pode enviar mensagens de várias formas. A melhor opção depende dos seus casos de uso.Painel
Enviar via API
Jornadas
A/B Testing
Enviar pelo painel
Selecionar o canal de mensagem

Crie uma nova mensagem no painel do OneSignal.
Escolher um método de composição
- Comece do zero ou use o compositor de mensagem com IA.
- Use um modelo pré-construído
Definir um nome e rótulo
nameSelecionar sua audiência

Seleção de nome, rótulo e segmento de audiência no painel.
Agendamento de entrega e otimização
Veja como o timing impacta o desempenho das notificações push.O tempo é tudo: Como enviar notificações push que geram ação
Propriedades de design
Mensagens push podem exibir conteúdo voltado ao usuário ou executar operações em segundo plano.- 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.- 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 estilos. 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 recomendado: ~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:
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) - API:
ios_attachments(iOS),big_picture(Android),chrome_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.- API:
url(URL universal única),app_url(deep link, por exemplo,your-app://screen),web_url(link web http/https) - 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 - Android: Requer categorias de notificação
- Huawei: Badge exibido como número ou ponto. API:
huawei_badge_class,huawei_badge_set_num,huawei_badge_add_num - Web (Chrome/Android): Ícone mostrado na barra de status do Android; deve ser um PNG alfa 72×72. API:
chrome_web_badge - 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 e listeners de clique no SDK móvel e SDK web
- O Dashboard suporta apenas dados chave-valor simples; use a API com
datapara enviar JSON aninhado - Tamanho total máximo do payload: ~4KB; campo
data: até 2048 bytes - Consulte Referência de payload de notificação
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
Por exemplo, um aplicativo meteorológico envia três alertas. Se o usuário abrir o dispositivo após os três, apenas a última mensagem é exibida.
Web push topic (push web)
Evite substituir notificações antigas na web usando valores únicos deweb_push_topic. Notificações com tópicos diferentes permanecem visíveis independentemente. 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
- API:
priority - Docs da plataforma: Prioridade APNs, Prioridade FCM
Tempo de vida (TTL)
Por quanto tempo manter uma mensagem se o dispositivo estiver offline. Padrão: 3 dias. Intervalo: 0–2.419.200 segundos (28 dias). API:ttl
Se um usuário estiver offline e o TTL expirar, a mensagem será descartada. Defina ttl: 0 para mensagens que nunca devem ser entregues com atraso.
Agrupamento de notificações
Android e iOS agruparão notificações automaticamente após o dispositivo receber 4 ou mais do seu aplicativo.- iOS: Use
thread_idna API para agrupar mensagens juntas. - Android: Use
android_groupna API, ou defina a “Group Key” no painel. Para personalização avançada, consulte o Android NotificationExtenderService e o Guia de Notificação de Grupo do Android.

Notificações agrupadas no Android.
Cancelar notificações push
Cancele uma mensagem se ela ainda não foi Entregue. O OneSignal para de enviar a mensagem para todas as assinaturas não adicionadas à fila. Isso não remove a mensagem de dispositivos que já a receberam. No Relatório de Mensagem, selecione Actions > Cancel, ou use a API Cancel Message.Remover uma notificação push de um dispositivo
Uma vez entregue, você só pode substituir uma notificação push se definir um Collapse ID ou Web push topic. Sem um desses, a notificação não pode ser substituída ou removida.Analytics
Rastreie o desempenho das mensagens e o engajamento.Relatórios de mensagens push
Visão geral de Analytics
Fluxos de Eventos
API de visualização de mensagens
Perguntas frequentes
Quais plataformas o push do OneSignal suporta?
O OneSignal suporta push no iOS (APNs), Android (FCM), Huawei (HMS), Amazon (ADM), navegadores web (Chrome, Firefox, Safari, Edge), macOS e Windows. Consulte os guias de configuração de plataforma acima.Como testar notificações push antes de enviar aos usuários?
Configure assinaturas de teste para verificar entrega, renderização e deep links sem afetar usuários reais. Você também pode enviar para um segmento de usuário único para testes rápidos.Por que minhas notificações push não estão aparecendo?
Causas comuns incluem credenciais de plataforma ausentes ou expiradas, usuários que não concederam permissão, ou configurações de nível de dispositivo como Não Perturbe. Consulte Notificações não mostradas ou com atraso para uma lista de verificação completa de solução de problemas.Qual é o tamanho máximo do payload de notificação push?
O tamanho total do payload é de aproximadamente 4 KB em todas as plataformas. O campodata suporta até 2048 bytes. Exceder esses limites pode fazer com que as notificações sejam truncadas ou rejeitadas.