Dale estilo al push que llega con tu app abierta
Cuando un push llega mientras tu app está abierta, iOS te deja ese momento a ti. El SDK de iOS de Pushwoosh lo muestra como un banner animado con tus propios colores y fuentes, con el material Liquid Glass de Apple en iOS 26.
Más de 80,000 empresas confían en nosotros para escalar su engagement
El formato, completo
Un push que llega mientras tu app está en primer plano es un problema que resuelve tu app. iOS pondrá su banner de sistema genérico sobre tu interfaz, o nada en absoluto, y un mensaje alrededor del cual armaste todo un journey llega como un recuadro gris. El módulo PushwooshForegroundPush muestra ese mismo payload como un banner que es tuyo.
Liquid Glass (iOS 26)
Activa useLiquidView y el banner se dibuja con el material Liquid Glass de Apple, así se ve como parte de iOS 26 y no como una capa pegada sobre tu pantalla.
Un banner estándar (iOS 13 a 25)
Por debajo de iOS 26, la misma llamada muestra un banner sólido con tu degradado y tus colores, y las toolchains de Swift más antiguas recurren a una vista con efecto de desenfoque. Una sola configuración cubre los tres casos.
Imagen de tarjeta y GIF
Título, mensaje, una imagen de tarjeta y un GIF animado, todo leído del payload que el push ya trae.
Movimiento, háptica y tiempo en pantalla
Una animación de entrada, una salida balls o regularPush, una vibración háptica al llegar elegida entre siete niveles, y una duración en segundos antes de que el banner desaparezca solo.
Lo que controlas
| Propiedad | Qué define | Valores |
|---|---|---|
useLiquidView | El material Liquid Glass en iOS 26 | Bool, false por defecto |
gradientColors, backgroundColor | La superficie sobre la que se dibuja el banner | Los colores de tu marca |
titlePushColor, messagePushColor | El color del texto de las dos líneas | Los colores de tu marca |
titlePushFont, messagePushFont | Las tipografías de las dos líneas | Cualquier fuente que incluya tu app |
usePushAnimation | La animación de entrada | Bool, true por defecto |
duration | Cuánto tiempo permanece el banner antes de desaparecer | Segundos |
vibration | La vibración háptica al llegar | none, light, medium, heavy, soft, rigid, notification |
disappearedPushAnimation | Cómo sale el banner de la pantalla | balls o regularPush |
style | El diseño integrado | style1, el único disponible hoy |
useLiquidViewfalse por defectogradientColors, backgroundColortitlePushColor, messagePushColortitlePushFont, messagePushFontusePushAnimationtrue por defectodurationvibrationnone, light, medium, heavy, soft, rigid, notificationdisappearedPushAnimationballs o regularPushstylestyle1, el único disponible hoyDónde lo configuras
Una llamada al iniciar
foregroundNotificationWith(style:duration:vibration:disappearedPushAnimation:) en didFinishLaunchingWithOptions, más las propiedades de apariencia. Se configura una vez para toda la app.
Una llamada al llegar
showForegroundPush(userInfo:) desde tu callback PWMessagingDelegate.onMessageReceived muestra el banner directamente a partir del payload del mensaje.
Un delegate para el toque
PWForegroundPushDelegate.didTapForegroundPush(userInfo:) te entrega el payload completo, así un toque abre con deep link exactamente lo que la campaña quería.
Su función, dentro de un journey
Un push, tres formas de mostrarse
El banner en primer plano es un modo de visualización de un mensaje que ya estás enviando. Mismo segmento, mismo trigger, mismo payload, mismo paso dentro del mismo Customer Journey. Lo que cambia es lo que hace el dispositivo con él al recibirlo.
Con la app cerrada, el mensaje llega como un push de sistema normal o actualiza una Live Activity. Con la app abierta, el SDK dibuja este banner. Cuando el momento merece una pantalla completa con una oferta o un formulario, el mismo journey escala a un mensaje in-app.
Una noticia estalla mientras el lector está a mitad de un artículo
Un evento editorial dispara el journey. Un silent push precarga el artículo en segundo plano, invisible para el lector, y la alerta llega un segundo después.
Los lectores con la app cerrada ven el push de sistema en su pantalla de bloqueo. Los que ya están dentro ven el banner propio del medio deslizarse sobre el artículo que estaban leyendo, con miniatura incluida, y un toque los lleva por deep link a la nueva nota. Message Inbox guarda la alerta en ambos casos.
Para qué usarlo
El banner solo puede aparecer mientras alguien está dentro de tu app, así que su valor depende de la densidad en sesión: cuánto de lo que envías llega a una pantalla que ya está abierta. Las apps con sesiones largas son las que más lo aprovechan; las apps cuyos mensajes llegan a un teléfono guardado en el bolsillo, muy poco.
| Momento | Qué dice el mensaje | Por qué encaja el banner |
|---|---|---|
| Medios y noticias: una noticia estalla durante una sesión de lectura | Ya hay veredicto | El lector ya está en la app, y el banner de sistema interrumpe el diseño propio del medio |
| Deportes en vivo: un gol mientras el usuario sigue el partido en la app | 1-0, minuto 68 | El usuario abrió la app por el partido y lo está siguiendo cuando llega el push |
| E-commerce y marketplaces: una baja de precio mientras navega | De nuevo disponible en tu talla | Un banner con estilo a mitad del scroll se lee como parte de la tienda y no como una interrupción |
| FinTech: una confirmación durante una tarea en la app | Transferencia enviada | Una confirmación de marca se siente nativa en el momento en que el usuario la está esperando |
| Streaming: un estreno durante un episodio | Ya está la temporada 3 | La alerta puede llevar el arte de la serie en lugar de llegar como un recuadro de sistema |
| Juegos móviles: un evento o recompensa durante una partida | Tu turno: La raid empieza en 5 | Con sesiones largas, la mayoría de los push llegan en plena partida, y un banner acorde al arte encaja con la interfaz del juego |
| Apps de creadores y suscripción: un lanzamiento nuevo o un empujón de prueba | Nuevo de un artista que sigues | Una app diseñada con cuidado no debería ceder este momento al sistema, y el toque lleva por deep link al paywall |
Cuándo otra superficie es la correcta
El banner es el escalón intermedio, de un vistazo, entre una alerta de sistema simple y una pantalla in-app completa. Muchos momentos caen de un lado o del otro.
- El momento llega con la app cerrada: un repartidor en la puerta, un cambio de puerta de embarque, una alerta de fraude. Eso es un push normal, un nivel de interrupción o una Live Activity.
- El estado es continuo, no instantáneo: un pedido en curso, un viaje en camino, un marcador en vivo. Eso es una Live Activity.
- El mensaje necesita pantalla completa: una oferta, un formulario, un paywall. Eso es un mensaje in-app, más rico y armado sin código.
- Quieres cambiar quién recibe el mensaje o lo que dice. Esto cambia cómo se ve; el alcance sigue siendo cosa de las notificaciones push móviles.
Cobertura de plataformas y técnica
El módulo es de iOS. Android gestiona el comportamiento en primer plano a través de los canales de notificación, que el Pushwoosh SDK crea a partir del payload del push en lugar de que tu app los registre en código, y la web no tiene una superficie comparable. La última columna indica qué dibuja realmente el banner, porque casi todo esto vive en tu app y no en el servidor.
| Capacidad | iOS | Android | Web | Lo entrega |
|---|---|---|---|---|
| Banner en primer plano personalizado | iOS 13.0+, Pushwoosh SDK 6.10.0+ | – | – | El módulo PushwooshForegroundPush en tu app |
| Material Liquid Glass | iOS 26 con Swift 5.13+ | – | – | El material de Apple, activado con useLiquidView |
| Banner sólido de respaldo | iOS anterior a 26, Swift 5.13+ | – | – | Una vista estándar dibujada por el SDK |
| Banner desenfocado de respaldo | Cualquier iOS, Swift anterior a 5.13 | – | – | Una vista con efecto de desenfoque dibujada por el SDK |
| Título, mensaje, imagen de tarjeta, GIF | Sí | – | – | El payload del push, sin cambios |
| Colores, degradados y fuentes de marca | Sí | – | – | Propiedades de apariencia estáticas del módulo |
| Háptica, animación de entrada y salida, duración | Sí | – | – | foregroundNotificationWith al iniciar la app |
| Manejo del toque y deep link | Sí | – | – | PWForegroundPushDelegate.didTapForegroundPush |
| Configuración no-code del aspecto | – | – | – | No disponible hoy, el estilo vive en el código de la app |
| La superficie en sesión equivalente en otras plataformas | Mensajes in-app, Live Activities | Mensajes in-app | Mensajes in-app | Productos aparte, armados sin código en el Control Panel |
PushwooshForegroundPush en tu appuseLiquidViewforegroundNotificationWith al iniciar la appPWForegroundPushDelegate.didTapForegroundPushSeguridad y hosting
Pushwoosh opera en su propio hardware en EE.UU. y Alemania, bajo GDPR.
Cómo funciona
Esta función pide tiempo de ingeniería, y lo decimos claro. No hay un editor en el Control Panel para el aspecto en primer plano, así que un desarrollador lo conecta una vez en la app y todo lo demás es el envío que ya haces.
-
Agrega el módulo y cede el primer plano a tu app (desarrollador)
Agrega
PushwooshForegroundPushjunto aPushwooshFramework,PushwooshCore,PushwooshBridgeyPushwooshLiveActivities, y luego definePushwoosh_SHOW_ALERTenfalseenInfo.plist. Así iOS deja de dibujar su propia alerta, porque el banner la reemplaza en lugar de sumarse a ella. -
Configura el aspecto una vez (desarrollador)
Llama a
foregroundNotificationWith(style:duration:vibration:disappearedPushAnimation:)endidFinishLaunchingWithOptionsy define las propiedades de apariencia para colores, degradados y fuentes. Muestra cada mensaje conshowForegroundPush(userInfo:)desdeonMessageReceived, y maneja los toques endidTapForegroundPush. -
Envía exactamente como hoy (no-code)
Misma audiencia, mismo Customer Journey, mismo payload, ya sea que la campaña salga del Control Panel o de la Messages API. El banner es cómo se muestra ese push cuando encuentra la app abierta.
Límites que conviene conocer
Explora productos relacionados
Notificaciones push móviles con Pushwoosh: alcance total, contenido enriquecido, targeting preciso y 99% de uptime. Convierte usuarios en clientes fieles.
Mensajería in-app de Pushwoosh: onboarding, upsell, anuncios y feedback justo cuando tus usuarios están activos en la app. Editor sin código, plantillas nativas vía SDK, analítica por elemento. Cumple con GDPR. Empieza gratis.
Suma botones de acción al push que ya envías: tus usuarios aprueban, reclaman o rastrean con un toque. Botones de iOS sin código en el Control Panel.
Un pedido, un viaje o una entrega en una sola tarjeta que se actualiza en la pantalla de bloqueo de Android 16. Pushwoosh la controla desde el servidor.
Pon varias imágenes en un push de iOS y deja que tus usuarios las deslicen en la notificación expandida, desde la misma campaña y journey de siempre.
Message Inbox suma un centro de notificaciones in-app a tu app y sitio web. Llega incluso a quienes rechazaron el push, y los mensajes quedan guardados.