Skip to Content

Plantillas de Correo Electrónico

Auris envía correos transaccionales para eventos de autenticación y de cuenta: verificación de email, restablecimiento de contraseña, inicio de sesión con magic link, invitaciones, alertas de seguridad y más. La Consola incluye un editor de plantillas que te permite personalizar el asunto, el contenido y el diseño de cada tipo de correo — por idioma — sin escribir código.

Accede al editor desde Consola -> Configuración -> Plantillas de Email.

Tipos de Plantilla

Auris incluye trece plantillas de correo transaccional, cada una activada por un evento específico:

Tipo de plantillaDisparador
verificationUn nuevo usuario se registra y debe verificar su dirección de email
password_resetUn usuario solicita restablecer su contraseña
invitationUn usuario es invitado a unirse a un tenant
mfa_codeLa autenticación de dos factores por email envía un código de verificación
magic_linkUn usuario solicita iniciar sesión sin contraseña vía magic link
login_alertSe detecta un nuevo inicio de sesión en la cuenta
welcomeUn usuario verifica con éxito su dirección de email
password_changedSe cambia la contraseña de un usuario (aviso de confirmación)
account_lockedUna cuenta se bloquea tras demasiados intentos fallidos de inicio de sesión
suspicious_loginSe detecta un inicio de sesión desde una ubicación, dispositivo o IP inusuales
email_changedSe cambia el email principal (enviado a la dirección antigua)
license_issuedSe emite una clave de licencia para un cliente
cibaUna aplicación solicita la aprobación de inicio de sesión vía flujo CIBA (backchannel)

Cada plantilla puede editarse de forma independiente, en cada idioma. Los cambios se aplican a todas las aplicaciones del tenant.

Si no has personalizado una plantilla, Auris usa una plantilla predeterminada renderizada con la marca de tu tenant (nombre de empresa, logo, color primario — mira Branding). Personalizar una plantilla reemplaza por completo el HTML predeterminado para ese tipo y ese idioma.

El correo magic_link contiene dos botones: un enlace principal de inicio de sesión que autentica al usuario en el dispositivo que abre el correo, y un enlace secundario de aprobación que confirma la sesión en el dispositivo desde el que se inició el flujo de acceso.

Usar el Editor de Plantillas

Selecciona un tipo de plantilla

Abre Configuración -> Plantillas de Email y haz clic en la plantilla que quieres personalizar.

Elige un modo de edición

El editor ofrece tres modos:

  • Editor de tema — ajusta identidad (logo, nombre de marca, texto del pie), colores, tipografía, estilo de botones, layout y contenido del cuerpo sin tocar el HTML completo.
  • Builder visual — compón el correo con bloques sobre un lienzo.
  • Editor de código — edita HTML y CSS directamente. Una biblioteca de snippets ofrece puntos de partida listos.

Edita el asunto y el cuerpo

Tanto el asunto como el cuerpo admiten placeholders {{variable}}. En el cuerpo, haz clic en una variable para insertarla en la posición del cursor — el editor lista exactamente las variables disponibles para el tipo de plantilla seleccionado.

Gestiona los idiomas

Cada plantilla puede tener una versión separada por idioma. Cinco idiomas traen plantillas predeterminadas integradas: inglés, italiano, francés, alemán y español. Puedes añadir cualquier otro código de locale (por ejemplo pt-BR) desde el selector de idioma; los idiomas sin predeterminado integrado recurren al inglés hasta que guardes una versión personalizada.

En el momento del envío, Auris resuelve la plantilla en este orden: plantilla personalizada en el idioma del usuario -> plantilla personalizada en inglés -> predeterminada integrada en el idioma del usuario -> predeterminada integrada en inglés.

Previsualiza el resultado

La vista previa en vivo renderiza tu plantilla con datos de ejemplo mientras editas. Usa el selector de dispositivo para comprobar los diseños de escritorio, tablet y móvil, o abre la vista previa a pantalla completa.

Envía un correo de prueba

Haz clic en Enviar prueba. Auris renderiza la plantilla con datos de ejemplo y la envía a tu propia dirección de email (el administrador autenticado). El asunto lleva el prefijo [TEST] para distinguirlo fácilmente de los correos transaccionales reales.

Guarda la plantilla

Haz clic en Guardar para aplicar los cambios. La plantilla tiene efecto inmediato para todos los correos futuros de ese tipo y ese idioma. Usa Restablecer predeterminado para eliminar la versión personalizada del idioma actual y volver a la plantilla integrada.

Los clientes de correo tienen un soporte de HTML y CSS incoherente. Usa CSS inline y layouts de tablas para estructuras complejas, y envía correos de prueba a clientes reales antes de guardar plantillas de producción. El HTML guardado se sanea en el servidor (se eliminan scripts, manejadores de eventos y frames incrustados) y tiene un límite de 500 KB.

Variables de las Plantillas

Variables Globales

Estas variables de fecha se inyectan automáticamente en cada renderizado:

VariableDescripciónValor de ejemplo
{{year}}Año actual2026
{{month}}Mes actual (dos dígitos)07
{{day}}Día actual (dos dígitos)23
{{date}}Fecha actual en formato YYYY-MM-DD2026-07-23

Variables por Plantilla

Cada tipo de plantilla tiene su propio conjunto de variables:

PlantillaVariables
verificationemail, link, expiresIn
password_resetemail, link, expiresIn
invitationemail, orgName, role, inviterEmail, link, expiresIn
mfa_codeemail, code, expiresIn
magic_linkemail, link, approveLink, expiresIn, tenantName
login_alertemail, device, ipAddress, location, time
welcomeemail, name, orgName, dashboardLink
password_changedemail, name, time, ipAddress
account_lockedemail, name, lockDuration, attempts, ipAddress, time
suspicious_loginemail, name, device, ipAddress, location, time, reason
email_changedemail, name, newEmail, time
license_issuedkey, jwtToken, product, expiresAt, features
cibaemail, appName, bindingMessage, approveUrl, denyUrl

Sintaxis de las Plantillas

  • {{variable}} — se sustituye por el valor, con escape HTML por seguridad. En el asunto (texto plano, no HTML) los valores se insertan sin escape.
  • {{{variable}}} — interpolación raw sin escape HTML. Úsala solo para fragmentos HTML de confianza construidos en el servidor.
  • {{#if variable}}...{{/if}} — el contenido encerrado se conserva solo cuando la variable tiene un valor no vacío. Útil para elementos opcionales como el botón approveLink en magic_link.

No existe la notación con punto ({{user.name}} no está soportado) ni los bucles. Los nombres de variables distinguen mayúsculas y minúsculas.

Los placeholders desconocidos permanecen tal cual en la salida. Si un correo enviado contiene {{texto}} literal, comprueba el nombre de la variable en la tabla de arriba.

Entrega de Correo y Pie de Página

Auris envía los correos a través de la configuración SMTP de tu tenant cuando está presente y activa; en caso contrario usa el remitente predeterminado de la plataforma. La configuración SMTP, una prueba de conexión y las opciones del pie de página están en Consola -> Configuración -> Email:

  • Emails white-label — elimina la atribución “Powered by Altovar” del pie de las plantillas predeterminadas.
  • Ocultar pie de página — omite por completo la banda del pie.

Estos interruptores se aplican a las plantillas predeterminadas (no personalizadas); una plantilla personalizada reemplaza todo el HTML, pie incluido. Mira Branding para los detalles.

Referencia de la API

Las plantillas de correo también pueden gestionarse mediante la API REST. Mira la API de Plantillas de Correo para las peticiones y respuestas completas.

GET/api/email-templates
GET/api/email-templates/{type}
PUT/api/email-templates/{type}
DELETE/api/email-templates/{type}
POST/api/email-templates/{type}/preview
POST/api/email-templates/{type}/test

Permisos

PermisoDescripción
manage:securityNecesario para listar, ver, editar, eliminar, previsualizar y probar las plantillas de correo.

Guías Relacionadas

Arquitectura