Pular para o conteúdo principal
Notificações push (também conhecidas como notificações remotas) são uma das maneiras mais eficazes de reengajar usuários com conteúdo oportuno e personalizado em todos os dispositivos—mesmo quando eles não estão usando ativamente seu aplicativo ou site. O OneSignal fornece uma plataforma completa para gerenciar notificações push em dispositivos móveis, web e desktop. Seja você um profissional de marketing, gerente de produto ou desenvolvedor, você pode lançar campanhas push de alto impacto em minutos.

​
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
Mais detalhes podem ser encontrados em nosso blog:

​
Configuração Push

Antes de enviar notificações push, conclua as seguintes etapas de configuração:
  1. Configuração específica da plataforma (push móvel, push web, Android, iOS, etc.)
  2. Configurar prompts de permissão (permitir que os usuários optem por notificações push)
  3. Configurar recursos e casos de uso (personalização, multi-idioma, limitação, etc.)
Guias de configuração:

Push móvel

Etapas completas de configuração para aproveitar ao máximo suas notificações push de aplicativo móvel. Configure notificações push do iOS, Android, Huawei e Amazon.

Push web

Etapas completas de configuração para aproveitar ao máximo suas notificações push web. Habilite push para Chrome, Firefox, Safari e Edge.

Configuração do SDK Móvel

Desenvolvedores: Adicione o OneSignal à base de código do seu aplicativo móvel.

Configuração do SDK Web

Desenvolvedores: Adicione o OneSignal ao seu site.

Migrar para o OneSignal

Migrando de outro provedor? Veja as etapas completas de migração para garantir que tudo esteja configurado corretamente.

Suporte a aplicativos macOS

Configure o OneSignal para funcionar com seu aplicativo macOS.

Suporte a aplicativos Windows

Configure o OneSignal para funcionar com seu aplicativo desktop Windows.

Suporte a WatchOS e WearOS

Adicione o OneSignal aos seus dispositivos Apple Watch e WearOS.

​
Prompts de permissão

Uma ótima experiência de opt-in maximiza sua audiência push:

Móvel: Solicitar permissões push

Melhores práticas para solicitar permissões push em aplicativos.

Web: Solicitar permissões push

Personalize o tempo e a mensagem do prompt para push web.

Móvel: Notificações Push Provisórias do iOS

Comece a enviar notificações push para usuários iOS. Notificações push provisórias vão diretamente para o centro de notificações e não podem reproduzir som ou aparecer na tela.

Móvel: Categorias de Notificação Android

Permita que usuários Android personalizem como querem receber notificações para seu aplicativo. Proporciona uma ótima experiência do usuário.

​
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 em vários idiomas.

Limitação de Taxa

Controle a velocidade de entrega de notificações.

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.

​
Analytics

Rastreie desempenho e otimize engajamento:

Relatórios de mensagens push

Use análises integradas para relatórios no nível da mensagem.

Fluxos de Eventos

Transmita eventos para seu data warehouse ou ferramentas de BI.

API de visualização de mensagens

Obtenha análises de mensagens.

Visão geral de Analytics

Entenda as capacidades de analytics no OneSignal.

​
Enviar notificações push

Você pode enviar mensagens de várias maneiras com base em suas necessidades.

A/B Testing

Teste até 10 variantes de mensagem no painel.

Jornadas

Construa fluxos de mensagens automatizados e personalizados.

API

Envie programaticamente via REST API.

Painel

Continue abaixo para aprender como enviar push do painel do OneSignal.
Etapas para enviar mensagens com o painel do OneSignal:

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.

Escolher um método de composição

Comece do zero ou use Templates pré-construídos.

Definir um nome e rótulo

  • Adicione metadados de rastreamento interno.
  • Equivalente na API: name

Definir audiência de segmentação

Os usuários elegíveis para receber a mensagem. Você pode incluir e excluir Segmentos para segmentar usuários específicos.
  • 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.
Método de segmentaçãoDashboardAPI
Segments✅✅
Filters (Somente API)❌✅
Aliases (Somente API)❌✅

​
Agendamento e entrega por usuário

Agende notificações com até 30 dias de antecedência. Push pode ser enviado para usuários em seus respectivos fusos horários ou otimizado inteligentemente com base no comportamento de cada usuário.
  • 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

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.
Experimente usar nosso Compositor de Mensagem com IA para gerar rapidamente o título e corpo da sua notificação. Ajuste facilmente o tom e 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 (sem fontes personalizadas ou estilo como negrito ou itálico).

​
Subtítulo

Texto secundário suportado apenas no iOS e macOS (via APNs). Não disponível no Android ou web.

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

​
Í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 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 – 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.
  • Parâmetros da API:
    • url: URL universal única
    • app_url: deep link (por exemplo, your-app://screen)
    • web_url: link web http ou 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
  • 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.

​
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
Exemplo: Um sistema de alerta meteorológico pode enviar as seguintes notificações: 
Notification 1. sent at 1:41 PM — "A storm is approaching. Grab an umbrella!"
Notification 2. sent at 2:20 PM — "Storm clearing up. Sunshine expected."
Notification 3. sent at 2:44 PM — "Storm has passed. Enjoy the sunshine!"
Se o usuário abrir o dispositivo às 16h00, apenas a última mensagem será exibida.

​
Web push topic (push web)

Evite substituir notificações antigas na web usando valores únicos de web_push_topic.
  • Comprimento máximo: 64 caracteres
  • API: web_push_topic
Exemplo: 
Notification 1. web_push_topic: "breaking-news"   → Notification 1
Notification 2. web_push_topic: "breaking-news"   → Notification 2 (substitui #1)
Notification 3. web_push_topic: "sports"          → Notification 3 (permanece visível)
Notification 4. web_push_topic: "weather"         → Notification 4 (permanece visível)

​
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:

​
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
Se um usuário estiver offline e o TTL expirar, a mensagem será descartada. Exemplo: Definir ttl: 0 — Se o dispositivo estiver offline quando a mensagem for enviada, ela nunca será entregue.
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 notificações para seu aplicativo. Agrupamento de notificações iOS
  • Use a propriedade REST API thread_id com o mesmo valor para agrupar mensagens juntas.
Agrupamento de notificações Android
  • Use a propriedade REST API android_group com o mesmo valor para agrupar mensagens juntas.
  • Android “Group Key” também pode ser definida ao enviar mensagens push do painel.
Se você precisar de mais personalizações, consulte o Android NotificationExtenderService para agrupar mensagens e adicionar outro 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.

​
Cancelar notificações push

Você pode cancelar uma mensagem se ela ainda não foi Entregue. O OneSignal parará de enviar a mensagem para todas as Assinaturas que não foram adicionadas à fila. Isso não remove a mensagem de um dispositivo se já foi entregue. No Relatório de Mensagem, selecione Actions > Cancel ou use a API Cancel Message para cancelar uma mensagem.

​
Remover notificação push do dispositivo

Uma vez que um push foi entregue, há poucas opções para removê-lo do dispositivo de um usuário. Você pode substituir uma notificação push por uma nova se definir um Collapse ID ou Web push topic. Se você não definir um Collapse ID ou Web push topic, não poderá substituí-lo.