- 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 completa para notificações push iOS, Android, Huawei e Amazon.
Configuração de push web
Habilite push para Chrome, Firefox, Safari e Edge.
Configuração do SDK Móvel
Integre o SDK OneSignal no seu aplicativo móvel.
Configuração do SDK Web
Integre o SDK OneSignal no seu site.
Migrar para o OneSignal
Etapas de migração do Firebase, Airship, Braze e outros provedores.
Suporte a aplicativos macOS
Configure o OneSignal para aplicativos macOS.
Suporte a aplicativos Windows
Configure o OneSignal para aplicativos desktop Windows.
Suporte a watchOS e Wear OS
Adicione o OneSignal a dispositivos Apple Watch e Wear OS.
Permissões
Uma experiência de opt-in bem projetada maximiza sua audiência push.Prompts de push móvel
Crie prompts de pré-permissão e melhores práticas para aplicativos móveis.
Prompts de push web
Personalize o tempo e a mensagem do prompt para push web.
Push Provisório iOS
Entregue notificações silenciosas ao centro de notificações antes de solicitar permissão completa.
Categorias de Notificação Android
Permita que usuários Android personalizem como recebem notificações do seu aplicativo.
Recursos e casos de uso avançados
Personalização de Mensagens
Adicione conteúdo dinâmico para personalizar mensagens para cada usuário.
Mensagens Multilíngues
Envie notificações push no idioma preferido de cada usuário.
Limitação de Taxa
Controle a velocidade de entrega de notificações para grandes audiências.
Limitação de Frequência
Limite o número de notificações push por usuário.
Notificações de dados e em segundo plano
Envie notificações somente de dados para tarefas em segundo plano.
Notificações VoIP
Envie notificações push específicas para VoIP em aplicativos de chamadas.
Enviar notificações push
Você pode enviar mensagens de várias formas. A melhor opção depende dos seus casos de uso.Painel
Componha uma mensagem rapidamente pelo painel.
Enviar via API
Envie mensagens programaticamente usando a REST API.
Jornadas
Crie fluxos automatizados de múltiplas etapas e multicanal.
A/B Testing
Teste até 10 variantes de mensagem para otimizar o desempenho.
Enviar pelo painel
Selecionar o canal de mensagem
Selecione Criar… e escolha seu canal de mensagem. Você também pode navegar para Mensagens ou Modelos para ver mensagens anteriores.
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
Adicione metadados internos para rastreamento e relatórios. Equivalente na API:
nameSelecionar sua audiência
Escolha quais usuários recebem a mensagem. Você pode incluir e excluir segmentos para segmentar grupos específicos. Padrão para todos os “Subscribed Users” se nenhum segmento for definido.
| Método de segmentação | Painel | API |
|---|---|---|
| Segmentos | Sim | Sim |
| Filtros (Somente API) | Não | Sim |
| Aliases (Somente API) | Não | Sim |
Agendamento de entrega e otimização
Veja como o timing impacta o desempenho das notificações push.| Opção | Descrição | Campo API |
|---|---|---|
| Enviar imediatamente | Entregar a todos os destinatários agora. | — |
| Agendado | Enviar em um horário específico, até 30 dias de antecedência. | send_after |
| Opção | Descrição | Campo API |
|---|---|---|
| Todos ao mesmo tempo | Todos os destinatários recebem a mensagem ao mesmo tempo. Melhor para mensagens urgentes. | — |
| Entrega inteligente | Envia no momento ideal para cada usuário com base em sua atividade de sessão. | delayed_option: last-active |
| Horário personalizado por fuso horário | Envia em um horário local definido no fuso horário de cada usuário. | delayed_option: timezone, delivery_time_of_day |
| Substituir Throttling | Alterar a taxa de throttling. | throttle_rate_per_minute |
| Substituir Frequency Capping | Desativar o frequency capping para esta mensagem. | enable_frequency_cap |
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.
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.
Limitação do iOS: APNs armazena apenas a notificação mais recente enquanto offline. As anteriores são descartadas. Saiba mais.
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.
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
Relatórios de taxa de entrega, taxa de abertura e cliques no nível da mensagem.
Visão geral de Analytics
Todas as opções de analytics disponíveis no OneSignal.
Fluxos de Eventos
Transmita eventos push para seu data warehouse ou ferramentas de BI em tempo real.
API de visualização de mensagens
Obtenha análises de mensagens programaticamente via REST API.
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.