Plantillas HTML

Una plantilla es todo lo que Frontmail necesita para convertir un conjunto de parámetros en un correo terminado. La editas en Plantillas en el panel; cada vez que guardas se crea una nueva versión.

Qué contiene una plantilla

Parte	Notas
Nombre, descripción, idioma predeterminado	Cualquier idioma (en, cs, hu, pt-BR…). El idioma en que se envía un correo determina el resultado de formatDate, formatNumber y formatMoney.
Variantes de idioma	Traducciones opcionales del asunto, el HTML, el texto y el nombre del remitente; consulta Traducciones de plantillas.
Asunto	Puede contener parámetros: Pedido {{order_id}} confirmado.
Para, CC, CCO	Direcciones separadas por comas. Los parámetros solo se permiten con Permitir destinatario dinámico (ver más abajo). Máximo 50 destinatarios en total.
Nombre del remitente, correo del remitente	El servicio conectado debe permitir el correo del remitente (dominio o remitente verificado).
Reply-To	Normalmente {{email}}, para poder responder directamente al visitante.
Cuerpo HTML	Un documento HTML completo, con <head> y <style>.
Versión de texto	Se genera automáticamente a partir del HTML; desactiva la generación automática para editarla a mano.
Parámetros	El esquema tipado; consulta Parámetros y tipos.
Servicio y servicio de respaldo	Qué servicio la envía y cuál toma el relevo si falla.
Seguridad	Exigir CAPTCHA (activado por defecto cuando tu organización tiene claves de Turnstile; si no, desactivado; un false explícito en un archivo se respeta), Permitir destinatario dinámico (desactivado por defecto).
Archivos adjuntos	Adjuntos fijos, adjuntos dinámicos sí/no, imágenes incrustadas; consulta Archivos adjuntos.
Respuesta automática, recogida de contactos	Consulta Respuesta automática y Recogida de contactos.

El editor

El editor está dividido en dos:

• Izquierda: editor de código HTML con resaltado de Handlebars y autocompletado de tus parámetros (escribe {{ para verlos). Para plantillas sencillas hay un editor visual; puedes volver al HTML en cualquier momento.
• Derecha: vista previa en directo en un iframe aislado. Cambia entre ancho de escritorio y móvil, fondo claro u oscuro y versión HTML o de texto. La vista previa se vuelve a renderizar mientras escribes.

Debajo de la vista previa está el panel de parámetros: un formulario generado a partir del esquema donde editas los valores de ejemplo que usan la vista previa y los envíos de prueba.

CSS en línea

Muchos clientes de correo (sobre todo Gmail en algunas plataformas y Outlook) ignoran los bloques <style>. Con Incrustar CSS al guardar activado, Frontmail copia tus reglas en atributos style="" al guardar y mantiene las media queries en <style> para los clientes que las admiten.

Comprobaciones de la plantilla

El panel de comprobaciones se ejecuta con cada cambio y avisa de:

• parámetros que faltan: se usan en la plantilla pero no están definidos en el esquema,
• parámetros sin usar: están definidos pero no se usan nunca,
• Handlebars no válido: bloques sin cerrar, helpers desconocidos (solo están disponibles los helpers integrados),
• imágenes sin alt: malo para la accesibilidad y para los clientes que bloquean imágenes,
• tamaño de más de ~100 kB: Gmail recorta los mensajes de más de unos 102 kB y oculta el resto tras «Ver mensaje completo».

Las advertencias nunca impiden guardar, pero una plantilla que no se puede compilar no se puede enviar.

Destinatarios dinámicos

Por defecto, Para, CC y CCO deben ser direcciones fijas. Si un campo de destinatario contiene un parámetro (por ejemplo Para: {{email}}), los envíos se rechazan con dynamic_recipient_not_allowed, salvo que actives Permitir destinatario dinámico en la plantilla.

Por qué está desactivado por defecto

Una plantilla con destinatario dinámico y una clave pública podría usarse para enviar cualquier correo a cualquier persona. Actívalo solo junto con orígenes permitidos, Turnstile y unos rate limits razonables, o envía esas plantillas solo desde tu servidor con una clave privada.

Con la clave pública, una plantilla con destinatario dinámico solo se envía con el contenido bloqueado: CAPTCHA obligatorio, campos de remitente fijos, sin parámetros HTML, textos de hasta 500 caracteres, enlaces solo a dominios permitidos y como máximo 5 correos por destinatario al día.

Para el caso habitual de «dar las gracias al visitante», usa mejor una respuesta automática.

Parámetros dentro de atributos

Un parámetro de tipo HTML usado dentro de una etiqueta (<a href="{{bio}}">, <img alt="{{bio}}">) o en <style> se inserta ahí como texto plano escapado, para que su marcado no pueda salirse del atributo. El editor lo avisa en Comprobaciones.

Pie del plan Free

Los correos enviados con el plan Free llevan un pequeño pie «Enviado con Frontmail», en el idioma del correo si es uno de los ocho idiomas del panel; si no, en inglés. Los planes de pago no tienen pie.

Importar y exportar

• Importar: pega HTML o sube un archivo .html; Frontmail detecta los parámetros a partir de los marcadores {{…}}.
• Exportar: descarga la plantilla (HTML, texto, ajustes, esquema de parámetros y variantes de idioma) como JSON, por ejemplo para moverla a otra organización.