Dê estilo ao push que chega com o app aberto
Quando um push chega com o seu app aberto, o iOS deixa esse momento com você. O Pushwoosh iOS SDK o desenha como um banner animado com suas próprias cores e fontes, com o material Liquid Glass da Apple no iOS 26.
Mais de 80.000 empresas confiam na Pushwoosh para escalar o engajamento
O recurso, por completo
Um push que chega enquanto o app está em primeiro plano é problema do seu app. O iOS coloca o banner simples do sistema por cima da sua interface, ou não mostra nada, e uma mensagem em torno da qual você montou uma Jornada inteira aparece como um retângulo cinza genérico. O módulo PushwooshForegroundPush renderiza esse mesmo payload como um banner que é seu.
Liquid Glass (iOS 26)
Ative useLiquidView e o banner é desenhado no material Liquid Glass da Apple, parecendo parte do iOS 26 e não uma camada colada por cima da sua tela.
Banner padrão (iOS 13 a 25)
Abaixo do iOS 26, a mesma chamada renderiza um banner sólido com seu gradiente e suas cores, e toolchains Swift mais antigas recorrem a uma view com efeito de desfoque. Uma configuração cobre os três casos.
Imagem de card e GIF
Título, mensagem, uma imagem de card e um GIF animado, tudo lido do payload que o push já transporta.
Movimento, vibração e tempo de exibição
Uma animação de entrada, uma saída balls ou regularPush, uma vibração na chegada escolhida entre sete níveis e uma duração em segundos antes de o banner sumir sozinho.
O que você controla
| Propriedade | O que define | Valores |
|---|---|---|
useLiquidView | O material Liquid Glass no iOS 26 | Bool, false por padrão |
gradientColors, backgroundColor | A superfície em que o banner é desenhado | As cores da sua marca |
titlePushColor, messagePushColor | Cor do texto das duas linhas | As cores da sua marca |
titlePushFont, messagePushFont | Fontes das duas linhas | Qualquer fonte incluída no seu app |
usePushAnimation | A animação de entrada | Bool, true por padrão |
duration | Quanto tempo o banner fica antes de sumir | Segundos |
vibration | A vibração disparada na chegada | none, light, medium, heavy, soft, rigid, notification |
disappearedPushAnimation | Como o banner sai da tela | balls ou regularPush |
style | O layout nativo | style1, o único disponível hoje |
useLiquidViewfalse por padrãogradientColors, backgroundColortitlePushColor, messagePushColortitlePushFont, messagePushFontusePushAnimationtrue por padrãodurationvibrationnone, light, medium, heavy, soft, rigid, notificationdisappearedPushAnimationballs ou regularPushstylestyle1, o único disponível hojeOnde você configura
Uma chamada na inicialização
foregroundNotificationWith(style:duration:vibration:disappearedPushAnimation:) em didFinishLaunchingWithOptions, mais as propriedades de aparência. Configurado uma vez para o app inteiro.
Uma chamada na chegada
showForegroundPush(userInfo:) a partir do callback PWMessagingDelegate.onMessageReceived renderiza o banner direto do payload da mensagem.
Um delegate para o toque
PWForegroundPushDelegate.didTapForegroundPush(userInfo:) entrega o payload completo, então o toque faz o deep link exatamente para onde a campanha previa.
O trabalho que ele faz, dentro de uma jornada
Um push, três formas de exibição
O banner em primeiro plano é um modo de exibição de uma mensagem que você já envia. Mesmo segmento, mesmo gatilho, mesmo payload, mesma etapa da mesma Jornada do Cliente. O que muda é o que o dispositivo faz com ela na chegada.
Com o app fechado, a mensagem chega como um push comum do sistema ou atualiza uma Live Activity. Com o app aberto, o SDK desenha este banner. Quando o momento pede tela cheia com uma oferta ou um formulário, a mesma Jornada escala para uma mensagem in-app.
Uma notícia estoura enquanto o leitor está no meio de uma matéria
Um evento editorial dispara a Jornada. Um push silencioso pré-carrega a matéria em segundo plano, invisível para o leitor, e o alerta vem um segundo depois.
Quem está com o app fechado vê o push do sistema na tela de bloqueio. Quem já está dentro vê o banner do próprio veículo deslizar sobre a matéria que estava lendo, com miniatura, e um toque leva direto à nova notícia. A Message Inbox guarda o alerta em qualquer um dos casos.
Para que usar
O banner só aparece quando alguém está dentro do seu app, então o valor dele acompanha a densidade de sessão: quanto dos seus envios chega a uma tela já aberta. Apps com sessões longas ganham mais; apps cujas mensagens chegam com o celular no bolso ganham muito pouco.
| Momento | O que a mensagem diz | Por que o banner funciona |
|---|---|---|
| Esportes ao vivo: um gol enquanto o usuário acompanha no app | 1 a 0, 68 minutos | O usuário abriu o app para o jogo e está assistindo quando o push chega |
| E-commerce e marketplaces: uma queda de preço durante a navegação | De volta ao estoque no seu tamanho | Um banner com estilo no meio da rolagem parece parte da loja, e não uma interrupção |
| Fintech: uma confirmação durante uma tarefa no app | Transferência enviada | Uma confirmação com a cara da marca parece nativa no momento em que o usuário está esperando por ela |
| Mídia e notícias: uma notícia estoura durante a leitura | Saiu o veredito | O leitor já está no app, e o banner do sistema quebra o design do próprio veículo |
| Streaming: um lançamento chega durante um episódio | A 3ª temporada está no ar | O alerta pode trazer a arte da série em vez de aparecer como elemento genérico do sistema |
| Jogos mobile: um evento ou recompensa durante a partida | Sua vez: A raid começa em 5 | Sessões longas fazem a maioria dos pushes chegar durante o jogo, e um banner no estilo da arte combina com a interface |
| Apps de criadores e assinatura: um lançamento ou um lembrete de teste | Novidade de um artista que você segue | Um app bem desenhado não deveria entregar esse momento ao sistema, e o toque leva direto ao paywall |
Quando outra superfície é a certa
O banner é o degrau intermediário, de leitura rápida, entre um alerta simples do sistema e uma mensagem in-app em tela cheia. Muitos momentos ficam de um lado ou do outro.
- O momento chega com o app fechado: o entregador na porta, uma mudança de portão, um alerta de fraude. Isso é um push simples, um nível de interrupção ou uma Live Activity.
- O estado é contínuo, não instantâneo: um pedido em andamento, uma corrida a caminho, um placar ao vivo. Isso é uma Live Activity.
- A mensagem precisa de tela cheia: uma oferta, um formulário, um paywall. Isso é uma mensagem in-app, mais rica e criada sem código.
- Você quer mudar quem recebe a mensagem ou o que ela diz. Este recurso muda a aparência; o alcance continua com o push mobile.
Cobertura de plataformas e técnica
O módulo é de iOS. O Android controla o comportamento em primeiro plano pelos canais de notificação, que o Pushwoosh SDK cria a partir do payload do push em vez de o seu app registrá-los em código, e a web não tem superfície comparável. A última coluna diz o que de fato desenha o banner, porque quase tudo aqui vive no seu app, e não no servidor.
| Recurso | iOS | Android | Web | Entregue por |
|---|---|---|---|---|
| Banner em primeiro plano personalizado | iOS 13.0+, Pushwoosh SDK 6.10.0+ | – | – | O módulo PushwooshForegroundPush no seu app |
| Material Liquid Glass | iOS 26 com Swift 5.13+ | – | – | Material da Apple, ativado com useLiquidView |
| Fallback de banner sólido | iOS abaixo do 26, Swift 5.13+ | – | – | Uma view padrão desenhada pelo SDK |
| Fallback de banner desfocado | Qualquer iOS, Swift abaixo de 5.13 | – | – | Uma view com efeito de desfoque desenhada pelo SDK |
| Título, mensagem, imagem de card, GIF | Sim | – | – | O payload do push, sem alterações |
| Cores, gradientes e fontes da marca | Sim | – | – | Propriedades estáticas de aparência no módulo |
| Vibração, animação de entrada e saída, duração | Sim | – | – | foregroundNotificationWith na inicialização do app |
| Tratamento do toque e deep link | Sim | – | – | PWForegroundPushDelegate.didTapForegroundPush |
| Configuração da aparência sem código | – | – | – | Não disponível hoje, o estilo fica no código do app |
| A superfície equivalente durante a sessão em outras plataformas | Mensagens in-app, Live Activities | Mensagens in-app | Mensagens in-app | Produtos separados, criados sem código no Control Panel |
PushwooshForegroundPush no seu appuseLiquidViewforegroundNotificationWith na inicialização do appPWForegroundPushDelegate.didTapForegroundPushSegurança e hospedagem
A Pushwoosh roda em hardware próprio nos EUA e na Alemanha, em conformidade com GDPR.
Como funciona
Este recurso pede tempo de engenharia, e a gente fala isso claramente. Não existe editor no Control Panel para a aparência em primeiro plano, então um desenvolvedor configura uma vez no app, e tudo o que vem depois é o envio que você já faz.
-
Adicione o módulo e passe o primeiro plano para o seu app (desenvolvedor)
Adicione
PushwooshForegroundPushjunto comPushwooshFramework,PushwooshCore,PushwooshBridgeePushwooshLiveActivities, e definaPushwoosh_SHOW_ALERTcomofalsenoInfo.plist. Isso impede o iOS de desenhar o próprio alerta, porque o banner o substitui em vez de aparecer junto. -
Configure a aparência uma vez (desenvolvedor)
Chame
foregroundNotificationWith(style:duration:vibration:disappearedPushAnimation:)emdidFinishLaunchingWithOptionse defina as propriedades de aparência para cores, gradientes e fontes. Renderize cada mensagem comshowForegroundPush(userInfo:)a partir deonMessageReceivede trate os toques emdidTapForegroundPush. -
Envie exatamente como hoje (sem código)
Mesma audiência, mesma Jornada do Cliente, mesmo payload, venha a campanha do Control Panel ou da Messages API. O banner é como esse push aparece quando encontra o app aberto.
Limites que vale conhecer
Explore produtos relacionados
Notificações push móveis da Pushwoosh: alcance total (iOS, Android, Huawei), conteúdo rico, segmentação precisa e jornadas omnichannel — 99% de uptime.
Mensagens in-app da Pushwoosh: faça onboarding, upsell, avisos e colete feedback bem na hora em que o usuário está com atenção total no seu app. Editor sem código, layouts nativos via SDK, analytics por elemento. Conformidade com GDPR. Comece grátis.
Adicione botões de ação ao push que você já envia: o usuário aprova, resgata ou acompanha num toque. Crie botões iOS sem código no Control Panel.
Pedido, corrida ou entrega num único card na tela de bloqueio do Android 16, atualizado em tempo real pela Pushwoosh a partir do servidor.
Coloque várias imagens num único push iOS e deixe o usuário deslizar por elas na notificação expandida. A Pushwoosh fornece a extensão necessária.
Uma central de notificações no seu app e site. A entrega silenciosa alcança todos os usuários, até quem recusou push, e as mensagens ficam salvas.