Plantillas con Header de Texto y Variables en WhatsApp
Crea y envía plantillas HSM con encabezado de texto, incluyendo variables dinámicas, en campañas masivas de WhatsApp.
¿Por qué usar headers de texto?
Un encabezado de texto permite que el primer elemento visible del mensaje sea un texto personalizado — por ejemplo, un saludo con el nombre del cliente o una referencia de pedido. Esto mejora la tasa de apertura y da contexto inmediato al destinatario antes de leer el cuerpo del mensaje.
Casos de uso
- Confirmaciones de pedido con número de orden en el header: "Pedido #12345"
- Recordatorios de cita con nombre del paciente: "Hola María, tu cita de mañana"
- Seguimiento de envío personalizado: "Tu envío a Providencia está en camino"
- Campañas masivas donde cada destinatario recibe un header distinto según una columna del CSV
Paso a paso: crear una plantilla con header de texto
Paso 1: Ir al editor de plantillas BSP
En el menú lateral, ve a Adereso BSP → Plantillas. Haz clic en Crear plantilla.
Paso 2: Seleccionar el tipo de header "Texto"
En la sección Header, verás pestañas para cada tipo de encabezado: Texto, Imagen, Documento, Video y Ubicación. Selecciona la pestaña Texto.
El campo de texto tiene un límite de 60 caracteres. Es un input de una sola línea, sin formato enriquecido.
Paso 3: Agregar una variable al header
Haz clic en el botón Agregar variable debajo del campo de texto. Se insertará automáticamente {{1}} en la posición del cursor.
Debajo del campo 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 de la plantilla a revisión de Meta, debes llenarlo con un ejemplo real de la información que contendrá tu variable.
Paso 4: Completar y enviar la plantilla a revisión
Completa el cuerpo, botones y footer como de costumbre. Al guardar, la plantilla se envía a Meta para revisión. Cuando Meta la apruebe, estará disponible para envío.
Uso en campañas masivas (CSV)
Al crear una campaña masiva con una plantilla que tiene header de texto con variable, la plantilla CSV de carga incluye automáticamente una columna header_text. Esta columna no aparece si la plantilla no usa variable en el header.
Estructura del CSV
Las columnas del archivo CSV se generan dinámicamente según la plantilla seleccionada:
phone— número de teléfono del destinatario (obligatorio)
header_text— valor del header de texto (aparece solo si la plantilla tiene variable en el header)
media_url— URL del archivo multimedia (aparece solo si el header es de tipo imagen o documento)
param1,param2, ... — valores de las variables del cuerpo del mensaje
header_text O media_url, nunca ambas. La columna depende del tipo de header configurado en la plantilla. Ejemplo de CSV
phone,header_text,param1,param2
+56912345678,Pedido #4521,María González,15 de abril
+56987654321,Pedido #4522,Carlos Pérez,16 de abril⚠️ Límites y restricciones
- Largo máximo del header de texto: 60 caracteres
- Variables por header: 1 máximo (restricción de Meta)
- El tipo de header es excluyente: texto, imagen, documento o video. No se pueden combinar
- Video y ubicación están deshabilitados (Coming Soon)
- El header de texto no soporta formato enriquecido (negrita, cursiva, etc.)
❓ Solución de problemas
El botón "Agregar variable" está deshabilitado
Ya existe una variable en el header. Meta solo permite 1 variable por header de texto. Si necesitas agregar más variables, usa el cuerpo del mensaje.
La columna header_text no aparece en mi CSV
Verifica que la plantilla seleccionada tenga un header de tipo texto con una variable configurada. Si el header es de tipo imagen o documento, la columna que aparece es media_url.
Artículos relacionados
- Guía de Borradores de Plantillas — Cómo crear y gestionar borradores de plantillas HSM antes de enviarlos a revisión de Meta.
- Carruseles en WhatsApp y Uso en Adereso Desk — Cómo configurar plantillas de tipo carrusel para mostrar múltiples productos o servicios.
- WhatsApp Campaigns [Desarrolladores] — Referencia técnica de la API de campañas masivas para equipos de desarrollo.