Skip to main content
Reengaje usuários com conteúdo oportuno e personalizado em todos os dispositivos, mesmo quando não estão usando ativamente seu aplicativo ou site. Veja como as notificações push geram o maior engajamento, ou pule direto para começar.

Por que notificações push geram o maior engajamento

O OneSignal fornece uma plataforma completa para gerenciar notificações push em dispositivos móveis, web e desktop:
  • Enviar campanhas e mensagens transacionais do painel 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.
Painel do OneSignal mostrando as opções de criar mensagem

Crie uma nova mensagem no painel do OneSignal.

Escolher um método de composição

Definir um nome e rótulo

Adicione metadados internos para rastreamento e relatórios. Equivalente na API: name

Selecionar 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.
Campos do painel para nome, rótulo e seleção de segmento de audiência

Seleção de nome, rótulo e segmento de audiência no painel.

Criar o design da mensagem e enviar

Componha a notificação usando as propriedades de design e as propriedades de recursos abaixo. Depois envie imediatamente ou defina um agendamento de entrega.

​
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

Escolha quando o OneSignal avalia a composição da audiência e começa a entregar a mensagem.
O horário de envio determina o corte da audiência. O OneSignal avalia a composição da audiência naquele momento, e qualquer pessoa na audiência recebe a mensagem independentemente das configurações de otimização por usuário.
Horário de entrega por usuário: Defina quando cada usuário na audiência recebe a mensagem. Substituições de entrega: Substitua os padrões de entrega no nível do app apenas para esta mensagem.
Com a Entrega inteligente ou o Horário personalizado por fuso horário, a entrega ocorre ao longo de um período de 24 horas para que todos os registros na audiência possam receber a mensagem. Se já forem 10h para um destinatário quando uma mensagem com horário local de 9h for enviada, ele a receberá às 9h do dia seguinte.

​
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 headings e contents, definem content_available como true tanto no iOS quanto no Android e, opcionalmente, incluem dados adicionais.
Diagrama anotado de uma notificação push com: 1 título, 2 mensagem, 3 ícone, 4 imagem, 5 botões de ação, 6 nome do aplicativo ou navegador, 7 timestamp recebido

Anatomia de uma notificação push web e móvel

Legenda: 1 Título, 2 Mensagem, 3 Ícone, 4 Imagem, 5 Botões de ação, 6 Nome do aplicativo ou navegador, 7 Timestamp recebido.
Use o Compositor de Mensagem com IA para gerar rapidamente títulos e texto do corpo de notificações. Ajuste o tom e o conteúdo para corresponder à sua marca em apenas alguns cliques.

​
Título

Texto personalizável superior da notificação. A aparência do texto é controlada pelo sistema operacional.
As plataformas de push (Android, iOS, Huawei, Amazon) não truncam títulos ou mensagens em uma contagem fixa de caracteres. Onde o texto é cortado depende do dispositivo, da orientação e do tamanho de texto do sistema do usuário (modo de Acessibilidade). No Android, também varia por launcher e fabricante.O OneSignal e os serviços de entrega (APNs, FCM e outros) enviam a notificação, mas não controlam como o dispositivo a renderiza, então nenhuma opção de API ou payload pode substituir o truncamento. O mesmo texto pode aparecer por completo em um dispositivo e ser cortado em outro.

​
Subtítulo

Texto secundário suportado apenas no iOS e macOS (via APNs). Não disponível no Android ou web.
Subtítulos são truncados independentemente do título, sob as mesmas regras de renderização do sistema operacional. Veja a nota em Título acima.

​
Mensagem

Conteúdo principal da notificação. Não suporta fontes personalizadas ou estilos. O estilo é definido pelo sistema operacional.
O corpo da mensagem é truncado sob as mesmas regras de renderização do sistema operacional, e quanto é exibido depende de a notificação estar recolhida ou expandida. Veja a nota em Título acima.

​
Ícones

Personalize ícones pequenos e grandes no Android e web. iOS sempre usa o ícone do aplicativo.

​
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.xml em <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.

​
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 no Android): Ícone monocromático da barra de status para notificações web do Chrome em dispositivos Android. Este não é um badge de ícone de aplicativo. Recomendado: PNG quadrado, 96×96 (mínimo 72×72). API: chrome_web_badge. Consulte Ícones de notificação
  • Consulte Badges

​
Som

Reproduza um som quando o push for entregue.

​
Dados adicionais

Adicione pares chave-valor personalizados ao payload para manipulação do SDK.

​
Collapse ID (push móvel)

Substitua notificações anteriores por uma mais recente se compartilharem o mesmo collapse_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 de web_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 (10, padrão e recomendado): Mensagens imediatas, baseadas em alerta.
  • Normal (5): Recomendado para notificações de segundo plano e somente 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: o APNs armazena apenas a notificação mais recente enquanto o dispositivo está offline. As notificações 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.
Dispositivo Android mostrando notificações push agrupadas do mesmo aplicativo

Notificações agrupadas no Android.

​
Tipo de mensagem Huawei (Huawei)

Controle como o OneSignal entrega push para dispositivos Huawei (HMS). API: huawei_msg_type
  • data: O SDK do OneSignal renderiza a notificação no lado do cliente, habilitando o conjunto completo de recursos (imagem grande, botões de ação) e a Entrega confirmada. Não é exibida se o aplicativo for encerrado à força.
  • message (padrão): O HMS Core renderiza no lado do servidor; apenas título e corpo, mas é exibida mesmo se o aplicativo for encerrado à força.
  • Consulte huawei_msg_type e Notificações de dados e em segundo plano.
huawei_msg_type=data é o tipo de transporte HMS, não uma notificação silenciosa. Um push do tipo data com conteúdo visível ainda exibe uma notificação completa.

​
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 usuários 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 campo data suporta até 2048 bytes. Exceder esses limites pode fazer com que as notificações sejam truncadas ou rejeitadas.
Isso é diferente do truncamento de título/corpo na tela. O tamanho do payload é um limite rígido imposto pelo APNs/FCM antes da entrega. O truncamento de exibição do título e do corpo acontece após a entrega, no dispositivo, e depende da renderização do sistema operacional. Veja Título acima.