Plantillas HSM y variables (el selector {{var}})

Conversa Labs

Conversa Labs

Última actualización el Jun 27, 2026

Visión general

Las plantillas HSM (Highly Structured Messages) son modelos de mensaje de WhatsApp aprobados por Meta. Son obligatorias para iniciar una conversación fuera de la ventana de 24 horas — por ejemplo, en una campaña a una lista de contactos.

Muchas plantillas tienen variables (marcadores con el formato {{1}}, {{2}} o con nombre como {{nombre}}) que se completan con los datos de cada contacto. En ConversaLabs, completas esas variables con el selector de variables ({{var}}), y el valor se resuelve para cada destinatario en el momento del envío.

Requisitos previos

  • Una bandeja de WhatsApp conectada.
  • Plantillas HSM aprobadas en la bandeja (la aprobación se gestiona con Meta).
  • Contactos con los datos que piensas usar en las variables (por ejemplo, el nombre).

Paso a paso

  1. En una campaña de WhatsApp (o al enviar un mensaje que requiere plantilla), selecciona la bandeja de entrada y elige la plantilla.
  2. Selecciona el idioma de la plantilla (y revisa la categoría, definida en la aprobación).
  3. Para cada variable de la plantilla, indica el valor:
    • escribe un texto fijo; o
    • usa el selector de variables ({{var}}) para insertar un campo dinámico (como el nombre del contacto), que se sustituirá por destinatario.
  4. Revisa la vista previa de la plantilla con los valores completados.
  5. Completa el envío (o programa la campaña). La plataforma resuelve las variables por contacto en el momento del disparo.

Configuración y opciones

  • Plantilla: el modelo aprobado que se enviará.
  • Idioma: la versión de idioma de la plantilla.
  • Categoría: la finalidad de la plantilla, definida en la aprobación (por ejemplo, marketing o utilidad).
  • Variables: los marcadores {{...}} de la plantilla, completados con texto fijo o con el selector de variables.
  • Selector de variables ({{var}}): inserta campos dinámicos (contacto, cuenta, etc.) que se resuelven individualmente para cada destinatario.
  • Vista previa: muestra cómo se verá el mensaje con los valores aplicados.

Casos de uso

  • Personalizar el saludo con el nombre del contacto en un envío masivo.
  • Enviar un código o enlace específico por contacto dentro de una plantilla.
  • Reutilizar la misma plantilla en varias campañas, cambiando solo los valores de las variables.

Consejos, límites y buenas prácticas

  • Completa todas las variables de la plantilla — los campos vacíos pueden impedir el envío a ese contacto.
  • Usa variables dinámicas con datos confiables; si un contacto no tiene el dato, prefiere un valor fijo de respaldo para no dejar el mensaje incompleto.
  • Recuerda que el contenido de la plantilla es fijo (aprobado por Meta) — solo cambias los valores de las variables, no el texto del modelo.
  • Las variables se resuelven en el servidor, por destinatario — no necesitas armar un mensaje distinto para cada contacto.

Solución de problemas

  • La plantilla no aparece: confirma que esté aprobada y en la bandeja correcta.
  • El envío falla para algunos contactos: revisa si alguna variable quedó sin valor para esos contactos.
  • El nombre (u otro dato) no aparece: confirma que el campo existe en el contacto y que se seleccionó la variable correcta en el selector.

Ver también