> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Medios en cabeceras de plantillas de WhatsApp: imágenes y vídeos
> Qué formatos y tamaños de medios acepta WhatsApp en las cabeceras de plantilla, por qué los enlaces de YouTube no se incrustan y cómo subir y referenciar medios a través de Flowella.
Una plantilla WhatsApp puede llevar un medio en su cabecera: una imagen, un vídeo o un documento. Si se utiliza bien, duplica las tasas de apertura y participación de un mensaje que, de otro modo, sería sólo de texto. Si se utiliza mal -formato incorrecto, URL rota, tipo MIME no coincidente-, provoca que el envío falle o que la plantilla parezca de aficionado.
Esta página es la referencia práctica sobre lo que funciona, lo que no, y cómo sondear los medios a través de Flowella.
## Formatos soportados y límites
Estos son los formatos y límites de tamaño que Meta aplica a los medios en las cabeceras de las plantillas (y en otros lugares de los mensajes de WhatsApp Business Platform).
### Imágenes
\| Formato Extensión Tipo MIME Tamaño máximo
\| --- | --- | --- | --- |
\| JPEG `.jpeg` / `.jpg` `image/jpeg` 5 MB
\| PNG | `.png` | `image/png` | 5 MB |
Las imágenes deben ser de **8 bits, RGB o RGBA**. WebP **no** se acepta en las cabeceras de las plantillas (sólo es válido en los mensajes adhesivos, que son un tipo de mensaje aparte).
**Dimensiones recomendadas:** Relación de aspecto 1,91:1, mínimo 800×418 px. Las imágenes cuadradas (1:1) también se ven bien. El cliente WhatsApp aplica letterbox a otras relaciones de aspecto.
### Vídeos
\| Formato Extensión Tipo MIME Tamaño máximo
\| --- | --- | --- | --- |
\| 3GPP | `.3gp` | `video/3gpp` | 16 MB |
\| MP4 `.mp4` `video/mp4` 16 MB
Los vídeos deben utilizar el **códec de vídeo H.264** y el **códec de audio AAC**, con un **solo flujo de audio o sin audio**.
Los vídeos codificados con el perfil H.264 **"High" y fotogramas B** no son compatibles con los clientes Android WhatsApp. Codifica (o recodifica) con el perfil H.264 **"Main" sin fotogramas B**, o con el perfil **"Baseline "**, y coloca las casillas `moov` antes de las casillas `mdat` para una mayor compatibilidad.
Si se utiliza ffmpeg, el indicador `-movflags faststart` se encarga de la ordenación `moov`/`mdat`.
### Documentos
\| Formato Extensión Tipo MIME Tamaño máximo
\| --- | --- | --- | --- |
\| PDF `.pdf` `application/pdf` 100 MB
\| Microsoft Word `.doc` / `.docx` `application/msword` / `application/vnd.openxmlformats-officedocument.wordprocessingml.document` 100 MB
\| Microsoft Excel: `.xls` / `.xlsx` / `application/vnd.ms-excel` / `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` 100 MB
\| Microsoft PowerPoint: `.ppt` / `.pptx` | `application/vnd.ms-powerpoint` / `application/vnd.openxmlformats-officedocument.presentationml.presentation` | 100 MB
\| Texto sin formato `.txt` `text/plain` 100 MB
Los PDF son los que se reproducen con mayor fiabilidad en todos los dispositivos. Los documentos de Office funcionan, pero requieren que el destinatario tenga instalada una aplicación compatible; en un móvil no profesional suelen abrirse como previsualizaciones.
## Lo que no funciona
No puedes incrustar un vídeo de YouTube o Vimeo en la cabecera de una plantilla. La cabecera debe ser un archivo MP4 o 3GPP que Meta pueda recuperar y alojar.
Si desea enviar un vídeo de YouTube, tiene dos opciones:
1. **Poner el enlace de YouTube en el cuerpo o un botón URL.** Al tocarlo se abre la aplicación o el navegador de YouTube. La vista previa del vídeo mostrada en WhatsApp será una miniatura estática.
2. **Descarga el vídeo y vuelve a subirlo como MP4.** Sujeto a tus derechos para redistribuir el contenido, lo que normalmente significa que tiene que ser tu propio vídeo.
Esta última es la forma de obtener una vista previa real del vídeo en la conversación.
Los GIF animados (`.gif`) no están en la lista de compatibles. WhatsApp los convierte en el servidor cuando se comparten de igual a igual en la aplicación para consumidores, pero la plataforma para empresas no lo hace. Recodifica el GIF como MP4 (que los clientes móviles de WhatsApp reproducen con reproducción automática y sin sonido, de la misma forma que muestran un GIF).
Las imágenes WebP sólo son válidas para los mensajes adhesivos, no para las cabeceras de las plantillas. Conviértelas a JPEG o PNG antes de utilizarlas como imagen de cabecera.
Los iPhones guardan por defecto las fotos en formato HEIC, que no está en la lista de formatos admitidos. Cambia la configuración del iPhone para capturar en JPEG o convierte HEIC a JPEG antes de subir la foto.
Se rechazará una imagen de 6 MB, un vídeo de 18 MB o un PDF de 110 MB. Comprímelo antes de subirlo. En el caso de las imágenes, el cliente WhatsApp también las vuelve a comprimir en pantalla, por lo que una foto de 4 MB no se verá significativamente mejor que una de 1 MB en la pantalla de un teléfono.
## Dos formas de adjuntar medios a una plantilla
Meta admite dos patrones para introducir medios en una plantilla:
### Patrón 1: Media handle (recomendado)
Cargue el archivo a través de la Media API de Meta, obtenga un **manejador de medios** y haga referencia al manejador cuando envíe la plantilla. Usado por Flowella por defecto.
Ventajas:
* Meta aloja el archivo, por lo que no hay fallos de URL rota en el momento del envío.
* Entrega más rápida porque Meta no tiene que buscar desde una URL externa.
* Funciona con los límites de tamaño anteriores.
El identificador es válido durante 30 días. Si su plantilla se envía repetidamente con los mismos medios, Flowella actualiza el identificador automáticamente antes de que caduque.
### Patrón 2: URL HTTPS pública
Proporcione una URL a un archivo de acceso público. Meta lo recupera en el momento del envío.
Esto es útil cuando:
* Los medios cambian según el destinatario (un PDF personalizado, una etiqueta de envío por pedido).
* El soporte se genera sobre la marcha y no desea cargarlo en el momento del envío.
Advertencias:
* La URL debe ser **públicamente accesible** (sin autenticación) y utilizar **HTTPS con un certificado válido**.
* Si la URL devuelve un error o es lenta, el envío falla.
* Meta almacena en caché el archivo obtenido durante un tiempo; la actualización del archivo en la URL no actualiza necesariamente lo que se envía.
## Cómo gestiona Flowella la carga de archivos multimedia
Para la mayoría de los casos de uso, Flowella gestiona la subida de archivos por ti:
En **Plantillas → Crear**, elige **Imagen**, **Vídeo** o **Documento** como tipo de cabecera y, a continuación, arrastra el archivo al área de carga.
El formato, el tamaño y el tipo MIME se comprueban antes del envío. Si el archivo no es compatible, verá un error inmediatamente en lugar de esperar a que Meta rechace la plantilla.
El archivo se carga a través de la Media API de Meta. El handle devuelto se guarda contra la plantilla.
Cuando la plantilla se envía para su aprobación, Meta ve los medios reales (no una URL), por lo que el proceso de revisión puede evaluar los elementos visuales como parte de la aprobación.
Hasta que cambie la cabecera de la plantilla, todos los envíos utilizan el mismo identificador. Las asas se actualizan automáticamente antes de caducar.
Para medios por destinatario (PDF personalizados, etiquetas de envío), utilice la opción **URL pública** en el generador de plantillas y pase la URL como variable al activar el envío desde un flujo de trabajo o la API. Consulte [Acciones de flujo de trabajo](/es/hubspot/workflow-actions).
## Diseño para la ventana gráfica WhatsApp
Algunas notas de diseño que no aparecen en las especificaciones de Meta pero que son importantes en la práctica:
* El texto en las imágenes debe ser grande y de alto contraste. WhatsApp muestra la imagen a la anchura aproximada de la pantalla del móvil, por lo que cualquier tamaño inferior a 14 px resulta ilegible.
* **Zona segura.** WhatsApp puede recortar o hacer letterbox; mantén el contenido crítico en el 80% central de la imagen.
* La imagen de cabecera, el nombre y la foto de perfil de WhatsApp están muy juntos, por lo que hay que mantener la coherencia visual.
* **Primer fotograma de un vídeo.** WhatsApp utiliza el primer fotograma como vista previa fija antes de que se reproduzca el vídeo. No empieces con un marco negro o un logo corporativo; empieza con una imagen significativa.
* Al enviar un PDF u otro documento, el **nombre del archivo** es visible para el destinatario. Utiliza un nombre claro y descriptivo, como `Acme-Order-12345-Receipt.pdf`, no `attachment.pdf`.
## Errores comunes y correcciones
El tipo MIME real del archivo no coincide con el declarado. Suele ocurrir cuando un "JPEG" exportado por iPhone es en realidad HEIC, o cuando una herramienta cambia el nombre de un `.docx` a `.pdf` sin convertirlo.
Solución: inspecciona el archivo (en macOS/Linux: `file -I yourfile.png`) y vuelve a exportarlo en el formato correcto o cambia la extensión para que coincida.
El códec de audio no es AAC o hay varios flujos de audio.
Solución: recodificar con `ffmpeg -i input.mp4 -c:v libx264 -profile:v main -c:a aac -movflags faststart output.mp4`.
Codificado con H.264 High profile y B-frames. Recodificar con perfil Main o Baseline.
Meta No se puede acceder a la URL. Causas comunes: la URL requiere autenticación, el certificado no es válido, el servidor tarda en responder (timeout), o la URL devuelve una redirección en lugar del archivo.
Solución: pruebe la URL con `curl -I` para confirmar que devuelve 200 con el tipo de contenido correcto y que el certificado es válido. A continuación, vuelva a intentarlo.
La fuente es de baja resolución o ha sido reescalada. WhatsApp no reprocesa la nitidez; lo que subes es lo que se muestra.
Solución: sube al menos 800 px en el borde largo para una imagen 1.91:1, y no reescales una fuente pequeña.
## Guías relacionadas
* [Template reference](/es/app/template-reference) - la estructura completa de plantillas en la que encaja este medio
* [Templates](/es/app/templates) - creación de plantillas paso a paso en Flowella
* [Acciones de flujo de trabajo](/es/hubspot/workflow-actions) - paso de URLs de medios por destinatario a través de flujos de trabajo HubSpot