Saltar al contenido principal
Las categorías de notificación de Android (también conocidas como canales de notificación) se introdujeron en Android 8.0 (Oreo) para brindar a los usuarios un mayor control sobre cómo reciben notificaciones de su aplicación. Esto le permite categorizar sus notificaciones y definir diferentes experiencias, como comportamiento de visualización, sonido, vibración, insignias y visibilidad de la pantalla de bloqueo. Por ejemplo, si tiene notificaciones de noticias de última hora, puede crear una categoría para ellas y establecer la importancia “Urgente” y un sonido personalizado para asegurarse de que se muestren de manera prominente en comparación con las notificaciones menos importantes que pueden estar silenciadas o tener un sonido predeterminado. OneSignal facilita la creación y administración de estas categorías directamente desde el panel. Alternativamente, puede definir categorías programáticamente en su aplicación. Consulte la guía de Android para crear canales de notificación.
Las categorías de notificación de Android de OneSignal funcionan para Google Android, Huawei Android y Amazon FireOS.

Ejemplo de las categorías de notificación de una aplicación en el dispositivo

​
Categorías de notificación predeterminadas

OneSignal crea automáticamente dos categorías predeterminadas:

​
Miscellaneous

Se usa cuando no establece una categoría.
  • Importance: Alta
  • Sound: Predeterminado
  • Vibration: Predeterminado
  • Badges: Habilitado
  • Lockscreen: Privado

​
Restored

Se usa cuando su aplicación se cierra forzosamente y se vuelve a abrir. Si su aplicación tiene notificaciones push en el Centro de notificaciones cuando la aplicación se cierra forzosamente, se eliminarán del dispositivo. Volver a abrir la aplicación recrea (restaura) esas notificaciones. Nuestro SDK establecerá automáticamente la categoría como “Restored” con la siguiente configuración para evitar comportamientos no deseados y posibles frustraciones del cliente al recibir múltiples notificaciones de su aplicación con sonidos y ventanas emergentes.
  • Importance: Baja
  • Sound: Desactivado
  • Vibration: Desactivado
  • Badges: Deshabilitado
  • Lockscreen: Privado
Si siempre envía notificaciones push con una categoría personalizada, el canal “Miscellaneous” no aparecerá en los dispositivos de los usuarios. El canal “Restored” siempre aparecerá para manejar las notificaciones restauradas después de cerrar forzosamente la aplicación.

​
Comportamiento específico de Huawei

En dispositivos Huawei, OneSignal no establece una categoría predeterminada. Si no incluye una, Huawei aplicará importancia Alta de forma predeterminada.

​
Crear categorías de notificación de Android en OneSignal

  1. Vaya a Settings > Push & In-App > Android Notification Channels en el panel de OneSignal.
  2. Haga clic en Add Group para organizar sus categorías (por ejemplo, “Actualizaciones de noticias”, “Actividad social”).
  3. Haga clic en Add Channel dentro del grupo para crear una nueva categoría.

Dónde agregar categorías de Android en OneSignal

Se le pedirá que defina lo siguiente:

​
Nombre

Visible para el usuario. Manténgalo claro y descriptivo.

​
Descripción

Visible para el usuario. Explique brevemente el tipo de notificaciones que manejará esta categoría.

​
Importancia

Controla qué tan visible e interruptiva es la notificación:
  • Low: Silenciosa, sin alertas
  • Medium: Sin sonido/vibración, interrupción visual mínima
  • High: Reproduce sonido o vibra, sin ventana emergente en pantalla
  • Urgent: Reproduce sonido y aparece como notificación emergente o estilo banner.

​
Sonido

  • Off: Sin sonido
  • Default: Tono de notificación predeterminado del dispositivo
  • Custom: Cargue y haga referencia a un sonido personalizado (sin extensión de archivo). Ejemplo: alert_beep (no alert_beep.wav) Consulte Sonidos de notificación para instrucciones de configuración.

​
Vibración

  • Off: Sin vibración
  • Default: Usa el patrón de vibración del dispositivo
  • Custom: Defina el suyo propio usando un patrón (en ms). Ejemplo: 0, 300, 500, 300 → Esperar 0ms, vibrar 300ms, pausar 500ms, vibrar 300ms.

​
Color del LED

Algunos dispositivos Android admiten indicadores LED:
  • Off: Sin LED
  • Default: Predeterminado del dispositivo
  • Custom: Valor hexadecimal ARGB (por ejemplo, FF0000FF para azul)

​
Insignias

Muestra el recuento de insignias en el ícono de la aplicación:
  • Enabled: Se muestra la insignia
  • Disabled: No se muestra insignia

​
Visibilidad de la pantalla de bloqueo

  • Public: Se muestra el contenido completo
  • Private: Solo nombre de la aplicación, oculta contenido
  • Secret: No hay notificación visible en la pantalla de bloqueo
Una vez creada su categoría, puede usarla en sus notificaciones.

​
Actualizar categorías

Después de que un dispositivo recibe una notificación con una categoría, Android bloquea el comportamiento de esa categoría. Los cambios en la importancia, sonido, vibración u otras configuraciones no se aplicarán retroactivamente. Por ejemplo, si envía una notificación push con una categoría usando importancia “High” y sonido, luego cambia la importancia a “Urgent” y usa un archivo de sonido diferente, la siguiente notificación push a ese mismo dispositivo con esa misma categoría no tendrá importancia “Urgent” ni el nuevo sonido. Opciones:
  • Para actualizar el comportamiento: Cree una nueva categoría.
  • Para probar cambios: Borre los datos de la aplicación o desinstale y vuelva a instalar la aplicación.
Puede actualizar:
  • Nombre del canal
  • Nombre del grupo de canales
Estos se actualizarán en la configuración de notificaciones de Android cuando se reciba la siguiente notificación usando ese canal actualizado.

​
Eliminar categorías

Para eliminar una categoría eliminada del dispositivo del usuario:
  1. Elimine la categoría del panel de OneSignal.
  2. Asegúrese de que todas las notificaciones se borren del Centro de notificaciones.
  3. Haga que el usuario:
    • Ponga la aplicación en segundo plano durante más de 60 segundos
    • Ábrala nuevamente (activa la sincronización del SDK)
El SDK se volverá a sincronizar y eliminará la categoría eliminada de la configuración de Android.

​
Agregar categorías a las notificaciones

Dependiendo de cómo haya creado la Categoría de Android y cómo esté enviando el mensaje, estas son las formas en que puede hacer referencia a la categoría en sus notificaciones push.

​
Envío desde el panel de OneSignal

  1. Dentro de su Plantilla o Compositor de mensajes push, navegue a la configuración de Android.
  2. En Category, seleccione su categoría si se creó dentro del panel de OneSignal o seleccione (Created in App) si se creó programáticamente en su aplicación.
    • Si se creó programáticamente, también establezca el campo Existing Channel con el nombre definido en su código.

Dónde seleccionar la categoría de Android en el compositor de mensajes

​
Envío con la API REST

Si creó la categoría en el panel de OneSignal, use el android_channel_id en la solicitud de API Crear mensaje. Puede encontrar el Channel ID en la pantalla de configuración de Categoría de Android.

Encuentre el Channel ID en la pantalla de configuración de Categoría de Android

Si usa sus propios canales de Android creados programáticamente, use el parámetro existing_android_channel_id en la solicitud de API Crear mensaje y establezca el nombre como se define en su código.

​
FAQ y solución de problemas

​
¿Las categorías pueden reproducir sonidos en modo No molestar (DND)?

No. OneSignal no establece setBypassDnd en las categorías. Para anular DND, cree su propio canal programáticamente y habilite esta configuración. Consulte setBypassDnd.

​
¿Puedo localizar los nombres o descripciones de las categorías?

No. OneSignal no admite múltiples idiomas para las categorías. Para admitir la localización, defina sus propios canales de Android y haga referencia a ellos a través de existing_android_channel_id en sus solicitudes de API push.

​
¿Por qué no funciona mi categoría de Android?

Hay varias razones por las que su categoría de Android puede no estar funcionando como se esperaba. Para solucionar problemas, verifique lo siguiente:
  • ¿Qué no funciona?
    • ¿No se está reproduciendo el archivo de sonido?
    • ¿No se está mostrando en el dispositivo?
    • ¿No ve la categoría en la Configuración de notificaciones de Android?
  • ¿Cómo se creó la categoría?
  • Revise la configuración de la categoría:
    • Asegúrese de que la configuración esté definida como espera.
    • ¿Se está haciendo referencia correctamente al archivo de sonido? Consulte la sección Sonido arriba.
    • ¿Se está haciendo referencia correctamente al nombre o ID de la categoría al enviar el mensaje?
  • ¿Actualizó la configuración después de enviar una notificación?
    • Si actualizó la configuración después de enviar una notificación, Android no aplicará esas actualizaciones a su dispositivo. Consulte Actualizar categorías arriba.
  • Verifique la inicialización del SDK de OneSignal:
¿Todavía necesita ayuda? ¡Estamos aquí para ayudar! Envíe un correo electrónico a support@onesignal.com con la información anterior, incluida:
  • El código de la categoría de Android si se creó programáticamente en su aplicación
  • La URL del mensaje en su panel de OneSignal con el problema
¡Le ayudaremos lo antes posible!