Variables de email para personalizar sin errores

«Hola, {{first_name}}» resulta útil en un borrador y desconcertante en un mensaje recibido. Las variables de email funcionan cuando el editor, el documento guardado y el sistema de envío acuerdan qué significa cada dato y cuándo se sustituye.

La personalización merece un contrato pequeño y explícito. Sin él, un campo vacío o un carácter inesperado puede convertir un anuncio corriente en una consulta de soporte.

Define el contrato antes de añadir ejemplos

Enumera los campos permitidos, sus tipos y la fase de sustitución. Un nombre es texto. Un saldo necesita formato y moneda. Un enlace requiere una política de URL. Tratarlos como cadenas intercambiables oculta diferencias que afectan al resultado.

Como ejemplo, imagina una aplicación que permite first_name, plan_name y account_url, utilizando una sintaxis elegida como {{first_name}}. Los nombres y delimitadores son ilustrativos: no representan un estándar universal ni una API de interpolación de Weavour.

Decide cómo tratar las claves desconocidas. Rechazar una variable no reconocida durante la preparación suele resultar más claro que eliminarla sin avisar. Vincula el error con el campo o la frase correspondiente para facilitar la corrección.

Separa los datos de ejemplo del documento guardado

El editor debe conservar la variable mientras la vista previa demuestra un resultado posible. Si previsualizar «Hola, Ana» sustituye permanentemente el campo por ese nombre, el siguiente destinatario podría recibir un saludo equivocado.

Utiliza perfiles ficticios que muestren casos diferentes: una ficha completa, un nombre ausente, caracteres acentuados y un nombre de organización largo. Indica qué perfil está activo. Evita mostrar datos personales de clientes en capturas o demostraciones compartidas.

Weavour conserva los marcadores de la aplicación anfitriona durante la edición y la exportación; la sustitución por destinatario corresponde a esa aplicación. El idioma de interfaz es independiente del contenido: cambiar los controles al español no traduce automáticamente el mensaje ni modifica el contrato de variables.

Redacta alternativas como contenido real

Cuando falta el nombre, «Hola» puede resultar más natural que «Hola, cliente». La alternativa depende de la frase completa. Prepara el saludo como unidad en vez de insertar una palabra genérica en una puntuación que deja de tener sentido.

Piensa en una novedad cuyo significado previsto sea: «Tu espacio Pro ya incluye informes guardados». Si plan_name no existe, «Tu espacio ya incluye informes guardados» sería una alternativa coherente. La aplicación debe elegir esa redacción de manera deliberada.

No supongas que una expresión de valor predeterminado admitida por un motor funciona en todos los demás. Documenta la sintaxis que acepta tu sistema de envío y pruébala allí. Revisa el asunto y la alternativa de texto por separado aunque utilicen los mismos datos que el HTML.

Escapa los valores según su contexto

Los datos de contacto no deben convertirse en marcado activo por aparecer en un email. Usa las reglas de escape adecuadas de tu motor. Por ejemplo, las expresiones de Handlebars escapan normalmente el HTML; su forma de salida sin procesar omite esa protección deliberadamente.

Escapar texto no valida un destino. Comprueba la URL final según los protocolos y destinos que permita tu aplicación. Evita sustituir cadenas indiscriminadamente en todo el documento exportado: la misma variable podría estar en texto visible, en un atributo o en otro contexto que requiera reglas diferentes.

Resuelve datos estructurados en los campos previstos y examina el resultado. No introduzcas datos de contacto no fiables como HTML sin procesar salvo que exista una política explícita de saneamiento revisada para ese uso.

Prueba una matriz pequeña de personalización

Antes de enviar la novedad, prepara estos registros ficticios:

• Un nombre habitual y un destino de cuenta válido.
• Un nombre ausente o formado solo por espacios.
• Un nombre con acento, apóstrofo y ampersand.
• Una etiqueta de plan especialmente larga.
• Una URL de cuenta inexistente o no permitida.
• Una variable desconocida introducida durante la edición.

Comprueba en cada caso el saludo, asunto, botón, HTML y alternativa de texto. Detén la preparación si no puedes producir un destino obligatorio en vez de exportar un botón convincente que no lleva a un lugar útil.

Una personalización fiable conserva el sentido cuando los datos son imperfectos. Escribe tu contrato, elige dos perfiles incompletos y procesa un mensaje real mediante tu propio sistema de envío. Explora Weavour incorporando ese contrato a los requisitos de integración.