Plantillas de WhatsApp con variables en el encabezado: por qué la vista previa no las muestra bien

Si estás mirando la vista previa de una plantilla de WhatsApp y el encabezado aparece vacío, con el marcador {{1}} tal cual, o con un texto que no es el que escribiste, no se rompió nada: la vista previa no está adivinando el contenido de la variable. Una plantilla con variables en el encabezado es un molde, no un mensaje. La vista previa sólo puede mostrar lo que el molde tiene definido más lo que vos le cargues como valor de ejemplo. Cuando falta ese ejemplo, o cuando el tipo de encabezado no admite variables, la previsualización muestra el hueco. Es molesto, pero no es grave: no afecta a los mensajes que ya salieron ni bloquea la aprobación de Meta por sí solo. En la mayoría de los casos lo arreglás vos, sin soporte.

Qué significa exactamente este problema

Una plantilla de WhatsApp tiene partes: encabezado, cuerpo, pie y botones. El encabezado puede ser de texto, de imagen, de video o de documento. Cuando el encabezado es de texto y le ponés una variable, esa variable es un espacio en blanco que se completa recién en el momento del envío, con el dato real de cada contacto. La vista previa, en cambio, se genera antes de ese envío. Por eso necesita un valor de ejemplo: el texto provisorio que le dice al sistema (y a Meta) qué forma va a tener ese hueco.

El problema, entonces, no es que la plantilla esté mal escrita. Es que la previsualización no tiene con qué rellenar el hueco. Eso se ve de tres maneras: el encabezado queda en blanco, aparece el marcador {{1}} sin reemplazar, o aparece un texto de ejemplo que no coincide con lo que esperabas porque quedó cargado de una versión anterior de la plantilla.

Por qué aparece: las causas más comunes

Casi todos los casos caen en alguna de estas situaciones. Vale la pena revisarlas en orden, porque la primera es la más frecuente y la más fácil de descartar.

• Falta el valor de ejemplo de la variable del encabezado. Es la causa número uno. Cargaste el texto con {{1}} pero no completaste el ejemplo, así que la vista previa no tiene nada para mostrar.
• El encabezado no admite variables según su tipo. Un encabezado de imagen, video o documento se completa con un archivo, no con texto variable. Si esperabas ver texto ahí, estás mirando la parte equivocada de la plantilla.
• La variable está en el lugar equivocado. Las variables del cuerpo y las del encabezado se cuentan por separado. Si numeraste el encabezado como {{2}} porque el cuerpo ya usaba {{1}}, la vista previa puede confundirse o quedar vacía. Cada sección arranca su propia numeración.
• Quedó una versión vieja de la plantilla. Editaste el texto, pero la vista previa sigue mostrando el ejemplo anterior porque no se volvió a guardar con el valor nuevo.
• El texto de ejemplo tiene un formato que no se corresponde con el contenido real. Por ejemplo, un ejemplo vacío, con sólo espacios, o con caracteres que el sistema no toma como texto válido.
• Estás mirando la vista previa de un idioma distinto al que editaste. Las plantillas pueden tener varias versiones por idioma y cada una lleva sus propios ejemplos.

Cómo arreglarlo paso a paso

Estos pasos los puede hacer alguien que maneja el panel de WhatsApp Business o la herramienta con la que administrás las plantillas, sin tocar código. Si en tu caso la plantilla se crea desde una plataforma externa, los nombres de los botones pueden cambiar, pero la lógica es la misma.

1. 1Abrí la plantilla en el editor y mirá primero el tipo de encabezado: texto, imagen, video o documento. Si no es texto, no esperes variables de texto ahí.
2. 2Si el encabezado es de texto, fijate si tiene una variable escrita como {{1}}. Si no la tiene, el problema es otro: revisá el cuerpo.
3. 3Buscá el campo de valor de ejemplo o muestra del encabezado. Suele estar justo debajo del texto editable, con una etiqueta del tipo 'ejemplo' o 'muestra'.
4. 4Escribí un ejemplo realista y completo, no un espacio ni un punto. Por ejemplo, si la variable es el nombre del negocio, poné 'Panadería Los Tilos'.
5. 5Guardá la plantilla. Si la vista previa no se actualiza sola, salí del editor y volvé a entrar para forzar el refresco.
6. 6Revisá que la numeración del encabezado arranque en {{1}} y no continúe la del cuerpo. Si el cuerpo usa {{1}} y {{2}}, el encabezado igual empieza en {{1}}.
7. 7Si la plantilla tiene varios idiomas, repetí la carga del ejemplo en cada idioma que vayas a usar.
8. 8Mirá la vista previa de nuevo. Si el encabezado ya muestra tu ejemplo, el problema estaba resuelto en el paso 4.

Si después de cargar el ejemplo la vista previa sigue vacía, probá duplicar la plantilla y crear una nueva con la misma estructura. A veces el problema queda pegado a una versión guardada y una plantilla nueva arranca limpia. Si tampoco así aparece, ahí sí conviene escalar: puede ser un problema de la plataforma o de la cuenta, no de tu edición.

Cómo evitar que vuelva a pasar

El error se repite casi siempre por dos motivos: se carga el ejemplo a las apuradas o se edita la plantilla sin revisar la vista previa antes de mandarla a aprobación. Un par de hábitos simples lo evitan.

• Cargá el ejemplo en el mismo momento en que escribís la variable, no después. Si dejás el hueco para más tarde, se te va a olvidar.
• Usá ejemplos con la forma real del dato: si la variable va a llevar un nombre, poné un nombre; si va a llevar una fecha, poné una fecha.
• Antes de enviar la plantilla a revisión, mirá la vista previa completa: encabezado, cuerpo, pie y botones. Es el último control barato que tenés.
• Si la plantilla tiene varios idiomas, revisá cada uno. El ejemplo no se copia solo de un idioma a otro.
• Guardá una plantilla base que ya funcione y duplicala cuando necesites una parecida. Arrancar de un molde probado reduce los olvidos.
• Anotá en un lugar visible qué plantillas tienen variables en el encabezado, así las revisás con más cuidado que las de texto fijo.

Cuánto tarda Meta en aprobar una plantilla

Este punto aparece siempre que alguien toca plantillas. Meta no garantiza un plazo de aprobación más preciso que 'hasta 48 hs'. Puede ser menos, pero el único plazo que se puede afirmar es ese. La vista previa no influye en la aprobación: Meta revisa el contenido de la plantilla, no cómo se ve en tu panel. Si la plantilla está bien escrita y cumple las políticas, la previsualización vacía no la va a hacer rebotar.

Los costos de conversación de WhatsApp los define Meta y varían por país. No los fijamos nosotros ni ninguna herramienta que use la API oficial: están en la documentación oficial de Meta y conviene consultarlos ahí antes de sacar cuentas.

Cuándo el problema real es otro y la vista previa es sólo el síntoma

A veces la vista previa se ve mal porque hay algo más roto atrás. Estos son los casos que conviene descartar antes de seguir peleando con el ejemplo del encabezado.

• El mensaje no llega aunque la plantilla se vea bien. Ahí el problema no es la vista previa: puede ser el token de acceso vencido, un número mal configurado o un problema de la cuenta. La previsualización no tiene nada que ver.
• La plantilla fue rechazada por Meta. Si el estado es 'rechazada', la vista previa es lo de menos: hay que revisar el motivo del rechazo y corregir el contenido.
• El encabezado lleva una imagen o un documento y no aparece. En ese caso el hueco no se llena con texto: hay que subir el archivo correspondiente.
• Estás probando con datos de un contacto de prueba que no tiene cargado el campo que alimenta la variable. La vista previa puede verse bien y el envío real salir vacío, o al revés.
• El problema aparece sólo en algunos idiomas. Suele ser que el ejemplo quedó cargado en uno y no en los demás.
• La plantilla se ve bien en el panel pero mal en el teléfono. Ahí el problema está en el cliente de WhatsApp del dispositivo, no en la plantilla.

Qué mirar si usás una herramienta para gestionar WhatsApp

Si administrás las plantillas desde una plataforma en vez del panel directo de Meta, la mayoría de estas herramientas usan la API oficial y respetan las mismas reglas. La diferencia está en dónde te piden el valor de ejemplo y cómo muestran la vista previa. En Wando, por ejemplo, las plantillas se cargan con sus variables y sus ejemplos antes de mandarlas a aprobación, y la vista previa sirve para revisarlas antes de usarlas en una campaña. Sea cual sea la herramienta, si el encabezado tiene una variable y no le cargaste el ejemplo, la previsualización va a mostrar el hueco: es una regla de la API, no de la plataforma.

En resumen

Una plantilla con variables en el encabezado no se muestra bien en la vista previa casi siempre porque falta el valor de ejemplo, porque el encabezado no es de texto, o porque la numeración de las variables quedó mezclada entre el encabezado y el cuerpo. Se arregla cargando el ejemplo correcto, revisando el tipo de encabezado y guardando de nuevo. No afecta la aprobación de Meta ni los envíos ya hechos. Si después de eso la vista previa sigue mal, el problema probablemente sea otro: token, cuenta, idioma o plataforma.