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
- En una campaña de WhatsApp (o al enviar un mensaje que requiere plantilla), selecciona la bandeja de entrada y elige la plantilla.
- Selecciona el idioma de la plantilla (y revisa la categoría, definida en la aprobación).
- Si la plantilla tiene un encabezado multimedia, selecciona la imagen, el video o el documento que se enviará. La plataforma conserva ese archivo en el historial de la conversación, incluso cuando WhatsApp utiliza una referencia multimedia temporal para entregarlo.
- 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.
- Revisa la vista previa de la plantilla con los valores completados.
- 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. - Encabezado multimedia: la imagen, el video o el documento específico de ese envío. El archivo que se muestra en el historial corresponde a lo enviado, no al contenido de ejemplo usado al aprobar la plantilla.
- 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.
- El encabezado aparece sin contenido: confirma que el archivo se seleccionó antes del envío y que su formato coincide con el encabezado aprobado. La plataforma no sustituye un archivo desconocido por el contenido de ejemplo de Meta.