📋 Encabezados en plantillas de WhatsApp — Guía completa
Conoce los tipos de encabezado disponibles en tus plantillas de WhatsApp (texto, imagen, documento, video y ubicación), cuándo usar cada uno y cómo configurarlos en Adereso BSP.
🧩 ¿Qué es un encabezado de plantilla?
Cada plantilla de WhatsApp puede incluir un encabezado opcional que aparece antes del cuerpo del mensaje. Es el primer elemento visual que recibe tu cliente — puede ser un texto, una imagen, un documento, un video o una ubicación en el mapa.
El tipo de encabezado se elige al crear la plantilla en Adereso BSP y no puede cambiarse después de que Meta la aprueba. Por eso es importante elegir bien desde el inicio.
🎯 ¿Cuál encabezado necesito?
Usa esta tabla como referencia rápida para decidir:
Tipo | Ideal para | Ejemplo de uso | Categorías compatibles |
Texto | Personalizar el primer vistazo con datos del cliente | "Pedido #4521" o "Hola María" | Marketing, Servicio |
Imagen | Mostrar un producto, banner o referencia visual | Foto del producto en oferta, banner de campaña | Marketing, Servicio |
Documento | Adjuntar archivos que el cliente necesita guardar | Factura PDF, contrato, guía de instrucciones | Marketing, Servicio |
Video | Captar atención con contenido dinámico y demos | Demo de producto, tutorial de onboarding | Marketing, Servicio |
Ubicación | Mostrar un punto en el mapa con coordenadas | Dirección de sucursal, punto de entrega | Marketing, Servicio |
📝 Encabezado de Texto
El encabezado de texto permite agregar una línea corta de texto personalizado como primer elemento del mensaje. Es ideal cuando quieres que el cliente vea inmediatamente un dato relevante — como su nombre, un número de pedido o una referencia — antes de leer el cuerpo.
¿Cuándo usarlo?
- Confirmaciones de pedido con número de orden: "Pedido #12345"
- Recordatorios personalizados: "Hola María, tu cita de mañana"
- Seguimiento de envío: "Tu envío a Providencia está en camino"
- Campañas masivas donde cada destinatario recibe un encabezado diferente según el CSV
Cómo configurarlo
- En Adereso BSP → Plantillas, haz clic en Crear plantilla.
- En la sección Encabezado, selecciona la pestaña Texto.
- Escribe tu texto (máximo 60 caracteres, una sola línea, sin formato enriquecido).
- Si necesitas personalizar el texto por destinatario, haz clic en Agregar variable. Se insertará {{1}} en la posición del cursor.
- Debajo aparecerá un campo para definir el valor de ejemplo de la variable — este valor se usa para la previsualización y para el envío a revisión de Meta.
- Completa el resto de la plantilla (cuerpo, footer, botones) y guarda.
Uso en campañas masivas (CSV)
Cuando creas una campaña con una plantilla que tiene encabezado de texto con variable, el archivo CSV de carga incluye automáticamente una columna header_text. Esta columna solo aparece si la plantilla usa variable en el encabezado.
Ejemplo de CSV:
Límites
- Largo máximo: 60 caracteres
- Variables: 1 máximo (restricción de Meta)
- Sin formato enriquecido (negrita, cursiva, etc.)
🖼️ Encabezado de Imagen
El encabezado de imagen muestra una foto o gráfico como primer elemento del mensaje. Es la opción más efectiva cuando quieres captar la atención visualmente — ideal para productos, banners de campaña o referencias visuales.
¿Cuándo usarlo?
- Campañas de marketing con foto de producto o banner promocional
- Confirmaciones de servicio con imagen de referencia (ej: foto del artículo comprado)
- Cualquier mensaje donde una imagen vale más que un texto como primer vistazo
Cómo configurarlo
- En Adereso BSP → Plantillas, haz clic en Crear plantilla.
- En la sección Encabezado, selecciona la pestaña Imagen.
- Sube una imagen de ejemplo para la previsualización y el envío a revisión de Meta.
- Al momento de enviar la plantilla (proactivo o campaña), podrás reemplazar la imagen por la definitiva.
Uso en campañas masivas (CSV)
En campañas, el CSV incluye una columna media_url donde colocas la URL pública de la imagen para cada destinatario.
Límites y formatos
- Formatos aceptados: JPEG, PNG
- Tamaño máximo: 5 MB
- Se recomienda una resolución de al menos 720x720 px para buena calidad en móvil
📎 Encabezado de Documento
El encabezado de documento adjunta un archivo como primer elemento del mensaje. Es perfecto cuando tu cliente necesita recibir y guardar un archivo — facturas, contratos, manuales, recibos.
¿Cuándo usarlo?
- Enviar facturas o boletas en PDF después de una compra
- Compartir contratos o documentos legales que el cliente debe firmar
- Enviar guías de instrucciones, manuales de usuario o fichas técnicas
- Cualquier caso donde el archivo es el mensaje principal, no un complemento
Cómo configurarlo
- En Adereso BSP → Plantillas, haz clic en Crear plantilla.
- En la sección Encabezado, selecciona la pestaña Documento.
- Sube un documento de ejemplo para la revisión de Meta.
- Al enviar, podrás reemplazar el archivo por el definitivo (ej: la factura real del cliente).
Uso en campañas masivas (CSV)
El CSV incluye una columna media_url con la URL pública del documento para cada destinatario.
Límites y formatos
- Formato recomendado: PDF
- Tamaño máximo: 100 MB
- El nombre del archivo visible para el cliente es el nombre original del archivo subido
🎬 Encabezado de Video
El encabezado de video permite adjuntar un video corto como primer elemento del mensaje. Es ideal para captar la atención con contenido dinámico — demos de producto, tutoriales rápidos o contenido promocional que se destaque en la bandeja del cliente.
¿Cuándo usarlo?
- Demos de producto que muestren funcionalidades en acción
- Tutoriales cortos paso a paso para onboarding de clientes
- Videos promocionales para campañas de marketing
- Testimonios de clientes o casos de éxito en formato visual
Cómo configurarlo
- En Adereso BSP → Plantillas, haz clic en Crear plantilla.
- En la sección Encabezado, selecciona la pestaña Video.
- Sube un video de ejemplo en formato MP4 para la previsualización y el envío a revisión de Meta.
- Al momento de enviar la plantilla (proactivo o campaña), podrás reemplazar el video por el definitivo.
Uso en campañas masivas (CSV)
En campañas, el CSV incluye una columna media_url donde colocas la URL pública del video para cada destinatario.
Uso por API
Al enviar un HSM por API (POST /v2/message/hsm/), incluye el encabezado de video en el campo header con type: "video" y la url del archivo MP4.
Límites y formatos
- Formato aceptado: MP4
- Tamaño máximo: 16 MB
- El video se transcodifica automáticamente para cumplir requisitos de Meta
📍 Encabezado de Ubicación
El encabezado de ubicación muestra un mapa interactivo con un punto marcado como primer elemento del mensaje. Es único porque las coordenadas no se definen al crear la plantilla — se proporcionan dinámicamente en cada envío.
¿Cuándo usarlo?
- Enviar la dirección de una sucursal, tienda o punto de retiro
- Indicar el punto exacto de entrega de un pedido
- Compartir la ubicación de un evento o reunión
- Cualquier mensaje donde mostrar un lugar en el mapa aporta más que una dirección escrita
Cómo configurarlo
- En Adereso BSP → Plantillas, haz clic en Crear plantilla.
- En la sección Encabezado, selecciona la pestaña Ubicación.
- Verás un mensaje informando que la ubicación se proporcionará al momento del envío (Meta requiere coordenadas dinámicas).
- Completa el resto de la plantilla y envía a revisión.
Envío proactivo (Nuevo ticket)
Al enviar un mensaje proactivo con una plantilla de ubicación:
- Abre Nuevo ticket y selecciona la plantilla con encabezado de ubicación.
- Aparece un selector de ubicación con mapa interactivo.
- Haz clic en el mapa para colocar el pin, o usa el campo de búsqueda para encontrar una dirección.
- El sistema completa automáticamente las coordenadas y la dirección.
- Confirma y envía. El destinatario recibe un mapa con la ubicación como encabezado del mensaje.
Uso en campañas masivas (CSV)
Las plantillas con encabezado de ubicación requieren columnas especiales en el CSV:
Columna | Descripción | Ejemplo |
latitude | Latitud del punto | -33.4489 |
longitude | Longitud del punto | -70.6693 |
name | Nombre del lugar (opcional) | Sucursal Providencia |
address | Dirección legible (opcional) | Av. Providencia 1234 |
Cada fila puede tener una ubicación diferente, permitiendo personalizar por destinatario.
Uso por API
Al enviar un HSM por API (POST /v2/message/hsm/), incluye el encabezado de ubicación en el campo header con las propiedades: latitude, longitude, name y address.
📏 Tabla resumen de límites
Tipo | Límite de tamaño | Formatos | Variables | Dinámico por envío |
Texto | 60 caracteres | Texto plano | 1 máximo | Sí (vía variable) |
Imagen | 5 MB | JPEG, PNG | No | Sí (media_url) |
Documento | 100 MB | PDF (recomendado) | No | Sí (media_url) |
Video | 16 MB | MP4 | No | Sí (media_url) |
Ubicación | N/A | Coordenadas | No | Sí (lat/lng por envío) |
📊 ¿Cómo se ve cada encabezado en el CSV de campañas?
El archivo CSV de carga cambia según el tipo de encabezado de tu plantilla:
Tipo de encabezado | Columna en CSV | Valor |
Texto (con variable) | header_text | El texto personalizado |
Imagen | media_url | URL pública de la imagen |
Documento | media_url | URL pública del documento |
Video | media_url | URL pública del video MP4 |
Ubicación | latitude, longitude, name, address | Coordenadas y datos del lugar |
Sin encabezado | (ninguna columna extra) | — |
🔧 Solución de problemas
El botón "Agregar variable" está deshabilitado en el encabezado de texto
Ya existe una variable en el encabezado. Meta solo permite 1 variable por encabezado de texto. Usa el cuerpo del mensaje para variables adicionales.
La columna header_text no aparece en mi CSV
Verifica que tu plantilla tenga un encabezado de tipo Texto con una variable configurada. Si el encabezado es de tipo imagen o documento, la columna que aparece es media_url.
Mi imagen/documento no se envía correctamente en campañas
Asegúrate de que la URL en la columna media_url sea pública y accesible (no requiera autenticación). El archivo debe cumplir con los límites de tamaño y formato.
No puedo editar el tipo de encabezado de una plantilla aprobada
Una vez que Meta aprueba una plantilla, el tipo de encabezado no puede cambiarse. Si necesitas un encabezado diferente, crea una nueva plantilla.
🔗 Artículos relacionados
- Módulo Adereso BSP en Desk — Visión general del módulo BSP, gestión de números y plantillas.
- ¿Cómo sé qué tipo de plantilla debo crear? — Guía para elegir entre Marketing, Servicio y Autenticación.
- Guía de Borradores de Plantillas — Cómo crear y editar borradores antes de enviar a Meta.
- Carruseles en WhatsApp y Uso en Adereso Desk — Plantillas con tarjetas deslizables para mostrar múltiples productos.
- Adereso Engage (Mis Campañas) — Envíos masivos desde WhatsApp con archivos CSV.