Sonidos de notificación

Agrega sonidos de notificación personalizados a apps de iOS, Android, Huawei y Amazon — incluidos formatos de archivo, configuración del SDK y parámetros de API.

Los sonidos personalizados te permiten proporcionar una experiencia más única y de marca en tu app. Puedes agregar un sonido personalizado a cada notificación o solo a ciertos tipos. Por ejemplo, una app social podría reproducir un sonido distintivo solo para mensajes directos para diferenciarlos de las notificaciones del sistema.

Solo para apps móviles. Los sonidos personalizados no están soportados en web push.

​

Configuración

​

Crear archivos de sonido

Crea archivos de sonido siguiendo los requisitos de plataforma a continuación. Si el dispositivo no puede encontrar el archivo especificado o el formato de archivo no está soportado, recurrirá al sonido de notificación del sistema predeterminado.

Mantén los nombres de archivos de sonido en minúsculas ya que algunas plataformas ignoran letras mayúsculas para archivos de sonido. En lugar de AwesomeSound.wav usa awesomesound.wav o awesome_sound.wav.

Plataforma	Extensiones	Notas
iOS	.wav .aiff .caf	Los sonidos deben estar codificados como Linear PCM, MA4 (IMA/ADPCM), µLaw o aLaw. Deben durar menos de 30 segundos.
Android	.wav .mp3 .ogg	Duración recomendada menos de 30 segundos. Mantén el tamaño de archivo pequeño, archivos grandes pueden no reproducirse en algunos dispositivos.
Huawei	.wav .mp3 .wma	Duración recomendada menos de 30 segundos. Mantén el tamaño de archivo pequeño, archivos grandes pueden no reproducirse en algunos dispositivos.
Amazon	.wav .mp3 .ogg	Duración recomendada menos de 30 segundos. Mantén el tamaño de archivo pequeño, archivos grandes pueden no reproducirse en algunos dispositivos.

​

Agregar archivos de sonido a tu app

Los archivos de sonido deben incluirse como recursos dentro de tu app. Las URLs externas no están soportadas.

iOS

Agrega archivos de sonido a la ubicación apropiada en tu proyecto Xcode dependiendo de tu SDK.

SDK	Folder
iOS Native	Add files to the Xcode project root. Make sure Add to targets is selected when adding files so they are automatically added to the bundle resources.
Cordova, Ionic	Add files to Resources directory within the Xcode project in <project-root>/platforms/ios/project-name.xcodeproj.
Unity	Add sounds anywhere in your Unity project, build your project, and then move those sounds to the Xcode project root.

Android, Huawei, and Amazon

Agrega archivos de sonido a la carpeta apropiada en tu proyecto dependiendo de tu SDK. Si la carpeta no existe, créala.

SDK	Folder
Android, Huawei, Amazon Native	res/raw
React Native	<project-root>/android/app/src/main/res/raw
Cordova	<project-root>/platforms/android/res/raw/
Ionic	/android/app/src/main/res/raw/
Unity	Assets/Plugins/Android/OneSignalConfig/res/raw NOTE: Your sound and icon file names must be lowercase and can’t contain anything else except underscores and numbers.
Flutter	main/res/raw
.NET	<project-root>/Platforms/Android/Resources/raw/

​

Enviar notificaciones

iOS

Incluye la extensión del archivo al hacer referencia al recurso de sonido (p. ej., explode_sound.wav). Configura el sonido en el dashboard al enviar mensajes push o usa la propiedad ios_sound del API Create Notification.

Para sin sonido, pasa nil al campo Sound.

Android, Huawei, and Amazon

Android 8+ introdujo Notification Categories que deben configurarse para personalizar sonidos de notificación. OneSignal usa el sonido configurado en el Notification Channel para todas las versiones de Android.

En Settings > Push & In-App > Android Notification Channels, crea el grupo y canal.

• Establece Importance a “Urgent” o “High” para reproducir sonido.
• Establece Sound a “Default” o “Custom” según tus necesidades. No agregues la extensión del archivo al hacer referencia al recurso de sonido (p. ej., cat_meow_sound).
• Para sin sonido, establece Importance a “Urgent” o “High” y Sound a “Off”. O establece Importance a “Medium” o “Low” para sin sonido.

Luego puedes establecer el nombre de categoría en el dashboard al enviar mensajes push o usar las propiedades android_channel_id y huawei_channel_id del API Create Notification. El sonido configurado en la categoría funciona para todas las versiones de Android.

REST API

Puedes enviar notificaciones con sonidos a través del REST API usando el parámetro apropiado para cada plataforma. Consulta la referencia del API Create Notification para todos los detalles.

Plataforma	Parámetro API	Detalles
iOS	ios_sound	Incluir extensión de archivo. Ejemplo: "ios_sound": "explode_sound.wav". Para sin sonido, pasa nil.
Android	android_channel_id — Usar si creaste el canal en el dashboard de OneSignal a través de Notification Categories. existing_android_channel_id — Usar si creaste el canal en otro lugar.	Se recomienda usar Notification Categories.
Huawei	huawei_channel_id — Usar si creaste el canal en el dashboard de OneSignal a través de Notification Categories. huawei_existing_channel_id — Usar si creaste el canal en otro lugar.	Se recomienda usar Notification Categories.
Amazon	adm_sound	No incluir extensión de archivo. Ejemplo: "adm_sound": "explode_sound".

Si recientemente agregaste un recurso de sonido a tu app, considera esperar unos días antes de enviar notificaciones que lo usen. Puede tomar días o semanas para que la mayoría de los usuarios actualicen a la versión más reciente de la app que contiene el nuevo archivo de sonido.

Si un usuario tiene una versión anterior sin el recurso de sonido y recibe una notificación que lo referencia, solo escuchará el sonido de notificación del sistema predeterminado.

---

​

FAQ

​

¿Puedo establecer un sonido predeterminado?

Usa una Template que haga referencia al sonido y/o Android Notification Channel. Cada notificación enviada con esa plantilla usará automáticamente el sonido configurado.

​

¿Puedo enviar diferentes sonidos de notificación a diferentes usuarios?

Los parámetros ios_sound y android_channel_id son a nivel de solicitud — se aplican a todos los destinatarios de esa llamada API. No puedes especificar diferentes sonidos para diferentes usuarios en una sola solicitud.

Para entregar diferentes sonidos a diferentes usuarios, usa un patrón fan-out: haz llamadas API separadas para cada variante de sonido, apuntando a usuarios por etiqueta o segmento. Por ejemplo, almacena el sonido preferido de cada usuario en una etiqueta como preferred_sound, luego envía una solicitud por valor de sonido.

Request 1 — users

{
  "app_id": "YOUR_APP_ID",
  "contents": {"en": "You have a new message!"},
  "ios_sound": "chime.wav",
  "android_channel_id": "CHIME_CHANNEL_ID",
  "include_filters": [
    {"field": "tag", "key": "preferred_sound", "relation": "=", "value": "chime"}
  ]
}

Cada solicitud apunta solo a los usuarios cuya etiqueta preferred_sound coincide, por lo que cada grupo escucha su propio sonido. Agrega tantas variantes como necesites — una llamada API por sonido.

​

¿Por qué mi notificación no reproduce el archivo de sonido personalizado?

Hay algunas causas comunes:

• El archivo de sonido tiene una extensión de archivo incorrecta
• El archivo de sonido no está codificado en un formato soportado
• El archivo de sonido está en la ubicación incorrecta en el proyecto
• El archivo de sonido tiene más de 30 segundos

iOS — Lee más en la documentación de Apple para guía de codificación y pruebas.

Android — Verifica que el archivo de sonido esté incluido en tu APK extrayéndolo y confirmando que existe en res/raw/.

Si la reducción de recursos está habilitada, protege los archivos de sonido de ser eliminados creando keep.xml en res/raw/:

<resources xmlns:tools="http://schemas.android.com/tools"
  tools:keep="@raw/sound_file"/>

​

¿Por qué mi notificación reproduce el archivo de sonido predeterminado?

Asegúrate de haber seguido las instrucciones de configuración y que el archivo de sonido esté en la ubicación correcta para tu SDK. Verifica el uso de mayúsculas en el nombre del archivo — algunas plataformas ignoran las letras mayúsculas.

​

¿Por qué se reproduce el sonido incorrecto?

En Android, las notificaciones se agrupan después de que se recibe un cierto número sin abrirlas. Las notificaciones agrupadas reproducen un sonido predeterminado. Puedes establecer el sonido con la clave de grupo para todas tus notificaciones.

---

​

Páginas relacionadas

Categorías de notificación

Configura los canales de notificación de Android para controlar el sonido, la vibración y la importancia.

Plantillas

Crea plantillas de notificación reutilizables con sonidos predefinidos.

API Create Notification

Referencia de API para los parámetros ios_sound, android_channel_id y adm_sound.

Iconos de notificación

Personaliza los iconos de notificación para tu app móvil.