> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Imágenes de notificación y medios enriquecidos

> Aprende cómo agregar imágenes, gifs y multimedia a notificaciones push móviles usando el Dashboard y API de OneSignal, incluyendo formatos recomendados, comportamiento específico del dispositivo y opciones de personalización de medios enriquecidos.

Esta guía explica cómo mejorar las notificaciones push móviles usando **imágenes y medios enriquecidos**, incluyendo soporte de plataforma, limitaciones técnicas y opciones de personalización en OneSignal.

Guías de imágenes para otros canales:

<Columns cols={2}>
  <Card title="Web Push" href="./push#image" arrow={true}>
    Agrega imágenes a notificaciones push web.
  </Card>

  <Card title="Mensajes In-App" href="./design-your-in-app-message" arrow={true}>
    Agrega imágenes a mensajes in-app.
  </Card>

  <Card title="Email" href="./design-emails-with-drag-and-drop" arrow={true}>
    Agrega imágenes a emails.
  </Card>

  <Card title="SMS" href="./sms-messaging" arrow={true}>
    Agrega imágenes para hacer mensajes MMS.
  </Card>
</Columns>

***

## Imágenes de app móvil

Puedes agregar imágenes a notificaciones push a través del Dashboard de OneSignal o API. Hay dos tipos principales:

### Iconos de notificación

* **iOS**: Usa automáticamente el icono de la app.
* **Android**: Permite iconos grandes y pequeños personalizados.
* Consulta [Iconos de notificación](./notification-icons) para instrucciones de configuración.

### Imagen Big Picture (formato grande)

* **Android**: Se muestra expandida por defecto en la mayoría de dispositivos.
* **iOS**: Requiere que el usuario deslice hacia abajo o mantenga presionado.

Para agregar imágenes:

* En Dashboard: **Messages > New Push > "Upload" al campo de imagen**
* O usa parámetros API: `big_picture` (Android) y `ios_attachments` (iOS)

<Frame caption="Agrega imágenes en el Dashboard de OneSignal a través del campo 'Image'.">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/4cb2ac2-Screenshot_2024-03-15_at_11.19.45_AM.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=d8fa92fdbd9a610dcdbbb2ef5065d08b" width="1828" height="828" data-path="images/docs/4cb2ac2-Screenshot_2024-03-15_at_11.19.45_AM.png" />
</Frame>

***

## Especificaciones de imagen

Usa imágenes orientadas al paisaje con una relación de aspecto 2:1.

|                      | iOS                                                                                                                    | Android                                                                                          |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| **Tipos de archivo** | `jpg`, `jpeg`, `png`, `gif`                                                                                            | `jpg`, `jpeg`, `png`, `gif`\*                                                                    |
| **Resolución**       | Relación de aspecto 1:1 o 2:1 (ej., `1038x1038px` o `1024×512px`)<br />**Ancho Máx:** 2000px<br />**Ancho Mín:** 300px | Relación de aspecto 2:1 (ej., `1024×512px`)<br />**Ancho Máx:** 2000px<br />**Ancho Mín:** 300px |
| **Parámetro API**    | `ios_attachments`                                                                                                      | `big_picture`                                                                                    |

* \*Android **no** soporta GIFs animados.
* Agregar [Botones de Acción](./action-buttons) puede reducir el área de visualización de imagen.
* Consulta [Imágenes de Notificación No Se Muestran](./notification-images-not-showing) si las imágenes no aparecen.

<Warning>
  OneSignal aplica un límite de carga de 5MB y no soporta cargas de audio o video. Las imágenes alojadas expiran después de 33 días. Para uso a largo plazo, carga a tu propia URL estática o usa Plantillas.
</Warning>

***

## Personalización de notificaciones enriquecidas

OneSignal soporta personalización visual e interactiva más profunda usando funciones nativas de plataforma.

### Diseño de notificación personalizado Android

Android 12+ aplica plantillas del sistema para notificaciones personalizadas. Sin embargo, aún puedes personalizar tu diseño usando estilos de notificación estándar de Android. Consulta [cambios de comportamiento](https://developer.android.com/about/versions/12/behavior-changes-12#custom-notifications) para detalles.

Para personalizar tu diseño:

* Sigue [la guía de notificación personalizada de Android](https://developer.android.com/develop/ui/views/notifications/custom-notification)
* Aplica cambios a través de la [Notification Service Extension](./service-extensions)
* Consulta [Notification.DecoratedCustomViewStyle](https://developer.android.com/reference/android/app/Notification.DecoratedCustomViewStyle) para personalizaciones disponibles.

### Extensiones de contenido iOS

iOS usa [`UNNotificationContentExtension`](https://developer.apple.com/documentation/usernotificationsui/unnotificationcontentextension?language=objc) para habilitar medios enriquecidos e interactividad en notificaciones.

Funciones soportadas:

* Carruseles de imágenes
* Reproducción de video incorporado
* Vistas personalizadas como calendarios o vistas previas de chat

Consulta nuestra [Guía de Carrusel iOS](./ios-image-carousel-push-notifications) para instrucciones de configuración.

***

## Adjuntos multimedia soportados

Los medios enriquecidos se pueden agregar a través de URLs a contenido alojado externamente. Esto funciona con `UNNotificationContentExtension` en iOS.

<Warning>
  * Asegúrate de que tus URLs sean enlaces directos al archivo y terminen en la extensión correcta. Si no, agrega una consulta (ej., `?file=video.mp4`) para que el SDK pueda detectar el tipo de medio.
  * OneSignal tiene un límite de 5MB en imágenes cargadas. El video y audio deben estar alojados externamente. Enlaza directamente al archivo multimedia, no a una página web.
</Warning>

| Adjunto    | Tipo de Archivo                        | Tamaño Máx | Requisitos                                                                                                                                     |
| ---------- | -------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Audio**  | `aif`, `aiff`, `wav`, `mp3`            | 5MB        | Ninguno                                                                                                                                        |
| **Video**  | `mp4`, `mpeg`, `mpeg2`, `mpeg4`, `avi` | 50MB       | [`UNNotificationContentExtension`](https://developer.apple.com/documentation/usernotificationsui/unnotificationcontentextension?language=objc) |
| **Imagen** | `jpg`, `jpeg`, `png`, `gif`            | 10MB       | [OneSignalNotificationServiceExtension](./service-extensions)                                                                                  |

<Note>
  La [OneSignalNotificationServiceExtension](./service-extensions) está incluida en el SDK de OneSignal y es requerida para soporte de imágenes, rastreo de entrega y actualizaciones de insignia.
</Note>

***

## Consejos de prueba

Asegúrate de que tus medios se muestren correctamente en todos los dispositivos:

* Siempre prueba en dispositivos reales (no emuladores).
* iOS requiere mantener presionado o deslizar hacia abajo para revelar medios enriquecidos.
* La renderización Android varía según el dispositivo, versión del SO y presencia de botones de acción.
* Usa el botón **"Send Test"** en OneSignal antes de lanzar una campaña.

### Casos de uso de ejemplo

* Mostrar una foto de producto en un recordatorio de carrito abandonado
* Promover un nuevo tráiler de película con una vista previa de video (solo iOS)
* Enviar un banner animado para una venta flash

***

## Solución de problemas

Si tus imágenes no aparecen como se esperaba, consulta la guía [Imágenes de Notificación No Se Muestran](./notification-images-not-showing) para causas y soluciones comunes.

***
