Notificaciones duplicadas

​

Cómo OneSignal previene entregas duplicadas

​

Comience aquí

• Envía mensajes a través de la API desde su propio backend o pipeline → El mismo mensaje enviado varias veces
• Su aplicación usa Firebase u otro SDK de push junto con OneSignal → Manejadores de notificaciones de terceros
• Su aplicación Android personaliza notificaciones en código (extensión de servicio o listener en primer plano) → Manejadores de notificaciones Android
• Su aplicación iOS implementa su propio UNUserNotificationCenterDelegate → Manejador en primer plano de iOS
• Solo ve duplicados en compilaciones de desarrollo o con múltiples instalaciones → Múltiples instancias de aplicación
• Notificaciones antiguas, ya entregadas, reaparecen cuando la aplicación se abre en Android → son notificaciones restauradas, no duplicados. Consulte Notificaciones restauradas

​

El mismo mensaje enviado varias veces

• Su servidor reintenta solicitudes sin verificar si la primera tuvo éxito.
• Duplicación de lógica en su pipeline de backend que envía la misma notificación dos veces.
• Está migrando a OneSignal pero todavía envía notificaciones desde un proveedor anterior. Evite enviar desde ambos sistemas al mismo tiempo.

​

Manejadores de notificaciones de terceros

• Otros SDKs de push remoto (por ejemplo, Firebase Cloud Messaging) que reciben la misma carga útil.
• Manejadores de mensajes personalizados como un FirebaseMessagingService en Android o un UNUserNotificationCenterDelegate en iOS que leen la carga útil entrante y construyen una notificación local a partir de ella.

​

Identificación de notificaciones de OneSignal

{
  "custom": {
    "i": "the-notification-id"
  }
}

​

Filtrar notificaciones de OneSignal en manejadores de terceros

override fun onMessageReceived(remoteMessage: RemoteMessage) {
    val customJson = remoteMessage.data["custom"]
    if (customJson != null) {
        try {
            val custom = JSONObject(customJson)
            if (custom.has("i")) {
                // Notificación de OneSignal — dejar que el SDK de OneSignal la maneje
                return
            }
        } catch (e: JSONException) {
            // No es una carga útil de OneSignal, continuar
        }
    }

    // Manejar su propia notificación aquí
}

func userNotificationCenter(_ center: UNUserNotificationCenter,
                            willPresent notification: UNNotification,
                            withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
    let userInfo = notification.request.content.userInfo

    if let custom = userInfo["custom"] as? [String: Any], custom["i"] != nil {
        // Notificación de OneSignal — dejar que el SDK de OneSignal la maneje
        completionHandler([])
        return
    }

    // Manejar su propia notificación aquí
}

​

Manejadores de notificaciones Android

• onNotificationReceived en una extensión de servicio de notificaciones: se ejecuta para cada push, incluso cuando la aplicación está en segundo plano, y también para las notificaciones restauradas.
• onWillDisplay en un listener de ciclo de vida en primer plano: se ejecuta solo cuando la aplicación está en primer plano.

​

La regla de preventDefault() y display()

• Llamar a event.getNotification().display() sin llamar primero a event.preventDefault(), lo que muestra la notificación dos veces.
• Publicar una notificación separada con NotificationManagerCompat.notify() mientras OneSignal también muestra la original.

override fun onNotificationReceived(event: INotificationReceivedEvent) {
    event.preventDefault()

    val notification = event.notification
    notification.setExtender { builder ->
        builder.setColor(0xFF0000FF.toInt())
    }
    notification.display()
}

@Override
public void onNotificationReceived(INotificationReceivedEvent event) {
    event.preventDefault();

    IDisplayableMutableNotification notification = event.getNotification();
    notification.setExtender(builder ->
        builder.setColor(0xFF0000FF)
    );
    notification.display();
}

OneSignal.Notifications.addForegroundLifecycleListener(object : INotificationLifecycleListener {
    override fun onWillDisplay(event: INotificationWillDisplayEvent) {
        event.preventDefault()

        // Renderice su propia UI o llame a event.notification.display() para mostrar la notificación de OneSignal
    }
})

​

Trabajo asíncrono dentro de callbacks

​

Manejador en primer plano de iOS

• Implementar su propio UNUserNotificationCenterDelegate sin reenviar llamadas a OneSignal, luego llamar a completionHandler([.banner, .sound]) y mostrar una alerta in-app personalizada desde el mismo método.
• Programar una notificación local (UNUserNotificationCenter.current().add(...)) en respuesta a un push entrante que OneSignal también está mostrando.

OneSignal.Notifications.addForegroundLifecycleListener(self)

func onWillDisplay(event: OSNotificationWillDisplayEvent) {
    event.preventDefault()

    // Renderice su propia UI o llame a event.notification.display() para mostrar la notificación de OneSignal
}

​

Múltiples instancias de aplicación

​

Consejos de diagnóstico

• ID de suscripción de OneSignal del dispositivo que recibió los duplicados
• ID del mensaje de OneSignal o un enlace al mensaje en el panel de control
• Lista de otras bibliotecas o plugins en su aplicación
• Registro de depuración que reproduzca el problema
• Pasos de reproducción detallados

​

Preguntas frecuentes

​

¿Qué sucede si tengo dos SDKs de notificación en mi aplicación?

​

¿Cómo enviar push desde un proveedor anterior y OneSignal al mismo tiempo?

• Android: Elimine el código de manejo de notificaciones del SDK antiguo al integrar OneSignal y lanzar la aplicación. A medida que los usuarios actualicen, dejarán de recibir push del proveedor antiguo.
• iOS: Puede continuar enviando desde el proveedor antiguo temporalmente mientras los usuarios actualizan. Una vez que haya completado la transición, envíe solo desde OneSignal para evitar duplicados.

​

¿OneSignal tiene salvaguardas contra el envío de duplicados a mi audiencia?

​

¿Cómo evitar múltiples notificaciones para actualizaciones que cambian rápidamente?

​

Páginas relacionadas