Saltar al contenido principal
Si tienes problemas con tu sitio web, consulta la guía de solución de problemas de Web Push.

​
Pasos para solucionar problemas

​
Revisar instrucciones de configuración y actualizar el SDK

Frecuentemente publicamos actualizaciones con correcciones de errores, mejoras y soporte para los últimos cambios del sistema operativo. Asegúrate de estar usando la última versión del SDK y de haber seguido las instrucciones de configuración.

Configuración del SDK móvil

Instrucciones de configuración diseñadas para ayudar a prevenir problemas comunes y probar la integración.

​
Revisar las guías comunes de solución de problemas

Notificaciones no mostradas o retrasadas

Las notificaciones push no están apareciendo en el dispositivo o están retrasadas.

Imágenes de notificaciones no se muestran

Las imágenes no aparecen en la vista expandida de la notificación.

CTR de notificaciones

Pocos o ningún clic en las notificaciones.

Notificaciones duplicadas

Las notificaciones aparecen varias veces en el dispositivo.

Solución de problemas de mensajes en la app

Los mensajes en la app no se muestran o no se comportan como se esperaba.

​
Verificar problemas comunes en tu app

​
Métodos de OneSignal que bloquean la visualización de push

Verifica si tu app tiene métodos como optOut(), por ejemplo OneSignal.User.pushSubscription.optOut(), o si configuraste enabled: false a través de nuestras REST APIs. Esto establece el estado de la suscripción push en unsubscribed. Consulta la referencia del SDK móvil para más detalles. Si la app está abierta mientras se envía el push, es posible que estés impidiendo que el push se muestre mediante el método preventDefault(). Esto generalmente se configura en el Listener de Eventos en Primer Plano o en la Extensión de Servicio de Notificaciones de Android.

​
Conflictos con Firebase Messaging u otros SDKs

Si tu app también incluye el Firebase Messaging SDK u otros SDKs de notificaciones push, verifica que no intercepten mensajes antes de que OneSignal pueda procesarlos. Este problema ocurre comúnmente cuando:
  • Las notificaciones aparecen como Entregadas en OneSignal pero nunca aparecen en el dispositivo.
  • La app incluye tanto OneSignal como firebase_messaging (o un FirebaseMessagingService personalizado).
  • El push funciona cuando se elimina Firebase Messaging, pero falla cuando ambos SDKs están presentes.
  1. Revisa tu AndroidManifest.xml en busca de receptores legacy de Firebase como com.google.firebase.iid.FirebaseInstanceIdReceiver y elimínalos/exclúyelos condicionalmente si OneSignal es responsable de la entrega push.
  2. Verifica si hay implementaciones personalizadas de FirebaseMessagingService (o bibliotecas como firebase_messaging en Flutter) que anulen onMessageReceived. Si otro servicio procesa o suprime completamente los mensajes, puede consumir el payload de FCM antes de que OneSignal pueda mostrar la notificación.
  3. Evita llamar a las APIs de gestión de tokens de Firebase como: FirebaseMessaging.getToken() o FirebaseMessaging.deleteToken().
Si OneSignal es responsable de la entrega push, debe ser el único SDK que gestiona el ciclo de vida del token push. Obtener o gestionar el token FCM directamente puede provocar conflictos de propiedad del token y un comportamiento de entrega inconsistente. Si necesitas el token push del dispositivo para otros sistemas, léelo desde OneSignal (por ejemplo, User.pushSubscription.token) y escucha los cambios de suscripción/token usando las APIs de observador del SDK.

​
Probar el proyecto de ejemplo para tu SDK

Verifica si tu problema es reproducible usando el proyecto de ejemplo mantenido por nuestro equipo de ingeniería para cada SDK.

​
Verificar los registros de errores

Recopila datos de registro antes de diagnosticar más:

Capturar un registro de depuración

Cómo habilitar el registro detallado y capturar la salida del SDK para solucionar problemas.

​
Contactar soporte

Si aún tienes problemas, contacta a support@onesignal.com con:
  • Tu App ID de OneSignal
  • El External ID y/o Subscription ID del dispositivo afectado
  • El ID de notificación o un enlace a la notificación en el panel (si aplica)
  • Un registro de depuración desde el dispositivo reproduciendo el problema

​
Errores comunes

​
APNS Delegate never fired

Los errores como “APNS Delegate Never Fired” y “APNS 3000” son mensajes de tiempo de espera de Apple que indican que el dispositivo no pudo conectarse a los servidores APNS de Apple. Esto es más común cuando:
  • Se prueba en entornos de desarrollo de APNS
  • Se usan múltiples dependencias de notificaciones push o APIs push nativas de iOS junto con OneSignal
  • Un problema de conectividad temporal — generalmente se resuelve solo la próxima vez que el usuario inicia una nueva sesión (app en segundo plano por 30+ segundos, luego reabierta)
Pasos para resolver:
  1. Elimina cualquier otra dependencia de notificaciones push o APIs push nativas de iOS y usa solo OneSignal. Una vez que el error se resuelva, puedes volver a agregar el otro código. Contacta a support@onesignal.com para conocer las mejores prácticas de coexistencia.
  2. Verifica el registro de depuración desde el dispositivo para más detalles.
  3. Si el error persiste, contacta soporte.
Si estás usando Capacitor, agrega esta configuración para permitir que OneSignal maneje las notificaciones push. 
{
  "ios": {
    "handleApplicationNotifications": false
  }
}

​
La app no se abre al cerrarla forzadamente y hacer clic en una notificación

Asegúrate de no estar probando en una compilación Debug. Por ejemplo, en apps Flutter, puedes:
  • Usar una compilación de versión a través de Flutter, por ejemplo flutter run --release (requiere un dispositivo físico)
  • Actualizar el esquema de Xcode a Release en lugar de Debug

​
Páginas relacionadas

Configuración del SDK móvil

Instrucciones de configuración para todos los SDKs móviles y cross-platform compatibles.

Capturar un registro de depuración

Cómo capturar registros del SDK para solucionar problemas.

Solución de problemas de Web Push

Soluciona problemas de notificaciones push web.

Referencia del SDK móvil

Referencia completa de la API para los SDKs móviles de OneSignal.

​
Preguntas frecuentes

​
¿Qué sucede si cambio mi App ID de OneSignal en mi app?

Cambiar el App ID de OneSignal en el código de inicialización de tu app creará un usuario completamente nuevo y una suscripción push bajo el nuevo App ID cuando el usuario actualice y abra la app a la última versión. Si tu bundle ID de iOS y/o package ID de Android son los mismos, entonces el dispositivo continuará con el mismo estado de suscripción push. Los datos del usuario serán completamente nuevos, es decir, necesitarás agregar nuevamente tus alias, tags, dirección de email, número de teléfono en el nuevo registro. Si el bundle ID de iOS o el package ID de Android son diferentes, entonces esta es una app completamente nueva y debe tener diferentes certificados/claves push.

​
¿Puede OneSignal enviar notificaciones push en una red cerrada on-premise?

Esto puede funcionar siempre que las computadoras en tu red cerrada tengan acceso a los servidores de gateway push que deseas soportar: Si la red está completamente desconectada de Internet, las notificaciones push no pueden ser entregadas a través de los servicios estándar de OS/navegador, que es lo que soportamos.