Para qué sirve#
Los templates (plantillas) de correo son correos ya diseñados que reutilizas en tus difusiones por correo. Los diseñas por bloques, arrastrando texto, imágenes, botones y más, sin escribir código; verás cómo queda en escritorio y en móvil y puedes enviarte una prueba.
Quién puede usarlo y cómo llegar#
- Cómo llegar: menú lateral Difusiones y formularios → Plantillas de correo (ruta
/templates). Los enlaces antiguos/correoredirigen aquí. - Ver la lista: cualquier usuario.
- Crear, editar, duplicar, archivar y eliminar: administradores y los roles que tengan permiso para crear difusiones (por defecto, administrador y supervisor; se cambia en Configuración → Gestión de difusión). Los demás pueden abrir el editor para ver y probar el diseño, pero sin guardar: aparece «Puedes ver y probar el diseño, pero tu rol no permite guardar templates.». Ver Difusiones y formularios.
La biblioteca de templates#
La pantalla Templates de correo lista los templates con pestañas, buscador, tabla y paginación.
| Elemento | Qué hace |
|---|---|
| Pestañas Activos / Archivados | Cada una muestra su cantidad. |
| Botón de filtro (embudo, a la derecha de las pestañas) | Abre una lista con las categorías (el tipo de correo de cada template: Promocional, Informativo, etc., y «Sin categoría») con cuántos templates tiene cada una en la pestaña actual. Marca una o varias para ver solo esos templates; el botón se pone verde, muestra cuántas hay marcadas y a su derecha aparece el nombre de la categoría seleccionada (o los nombres, separados por coma). «Mostrar todas» quita el filtro. |
| Casillas de selección | Cada fila tiene una casilla, y la casilla del encabezado selecciona todos los templates que cumplen la búsqueda, la pestaña y el filtro de categorías (en todas las páginas). Al marcar alguno aparece una barra con la cantidad seleccionada y tres opciones: Asignar categoría (elige una existente o «Sin categoría» y se aplica a todos), Eliminar (pide confirmación en una ventana; las difusiones que usaron los templates conservan su copia) y Quitar selección. |
| Nuevo template | Abre el editor en blanco. Solo se ve si tienes permiso. |
| Buscador «Buscar por nombre o asunto...» | Filtra la lista. |
| Paginación | Muestra 20, 50 o 100 por página (20 por defecto), con anterior/siguiente y «Mostrando N de M». |
Columnas de la tabla:
| Columna | Qué muestra |
|---|---|
| Template | El nombre. |
| Asunto | El asunto («Sin asunto» si no tiene). |
| Tipo de correo | Promocional, Informativo, etc. («—» si no tiene). |
| Formato | Por bloques (diseñado con el editor) o Texto / HTML (creado antes del editor). |
| Usos | Cuántas difusiones activas (no eliminadas) usaron este template. |
| Actualizado / Por | Cuándo y quién lo modificó por última vez. |
Con permiso, al hacer clic en una fila se abre el editor. El menú ⋮ de cada fila ofrece:
| Opción | Qué hace |
|---|---|
| Editar | Abre el editor. |
| Duplicar | Crea una copia llamada «Nombre (copia)» (si ya existe, «Nombre (copia) 2», etc.). Aviso «Template duplicado». |
| Archivar / Restaurar | Mueve el template entre Activos y Archivados. Los archivados no se ofrecen al crear difusiones. Avisos «Template archivado» / «Template restaurado». |
| Eliminar | Pide confirmación: «¿Eliminar el template «Nombre»?». Si tiene usos: «Las N difusiones que lo usaron conservan su propia copia.». Aviso «Template eliminado». |
Si no hay templates: «Aún no hay templates.» y, con permiso, «Crea el primero con «Nuevo template».».
La pantalla del editor#
El editor tiene una barra superior, una franja con el asunto y tres zonas: bloques a la izquierda, el correo en el centro y las propiedades a la derecha.
Barra superior#
| Elemento | Qué hace |
|---|---|
| Flecha ← | Vuelve a la biblioteca. |
| Nombre del template | Hasta 150 caracteres. Obligatorio; no puede repetirse. |
| Tipo de correo | Clasifica el template. Opciones iniciales: Promocional, Informativo, Transaccional, Bienvenida y Recordatorio. Con permiso, + Nuevo tipo… crea otro (hasta 80 caracteres, sin repetir). |
| Deshacer / Rehacer | Hasta 80 pasos. Atajos Ctrl+Z y Ctrl+Y (o Ctrl+Mayús+Z). |
| Escritorio / Móvil | Cambia el ancho del lienzo (el móvil muestra 375 px). |
| Vista previa | Muestra el correo completo; ver abajo. |
| Enviar prueba | Te manda el correo; ver abajo. |
| Guardar | Guarda el template (atajo Ctrl+S). |
Franja de asunto#
| Campo | Qué hace | Límites |
|---|---|---|
| Asunto | Asunto del correo. Admite variables con el botón { }. Ejemplo: «{{nombre|Hola}}, tenemos algo para ti». | 250 caracteres |
| Texto de vista previa | El adelanto que muchos programas de correo muestran junto al asunto en la bandeja de entrada. Tiene contador «0/150». | 150 caracteres |
Panel izquierdo#
Pestaña Contenido
- Bloques (arrástralos al correo o haz clic para agregarlos al final de la fila seleccionada): Texto, Título, Imagen, Botón, Divisor, Espacio, Redes, Video, Menú, Formulario y HTML.
- Filas y columnas (arrastra o haz clic para agregar una fila): una columna (100 %), dos columnas (50/50), tres (33/34/33), cuatro (25 cada una), 30/70 y 70/30.
Pestaña Guardados: los bloques reutilizables. Ver Bloques guardados.
El lienzo#
Un correo está formado por filas; cada fila tiene una o más columnas y cada columna contiene bloques.
- Al pasar el cursor se resaltan filas y bloques; al hacer clic se seleccionan y aparece una barra flotante.
- Si el correo está vacío, verás «Empieza tu template» con tres puntos de partida: En blanco, Boletín informativo y Promoción.
- Los textos y títulos se escriben directamente en el lienzo.
- Arrastrar un bloque: suéltalo sobre otro bloque (antes o después), sobre una columna o en una zona libre (crea una fila nueva). También se pueden mover filas y bloques con el asa de la barra flotante.
- La tecla Supr o Retroceso elimina el elemento seleccionado (si no estás escribiendo).
- Las filas o bloques con condición muestran la etiqueta naranja Condicional.
Barra flotante del elemento seleccionado:
| Botón | Qué hace |
|---|---|
| Asa de arrastre | Mueve el elemento. |
| Seleccionar la fila | (Solo en un bloque) selecciona la fila que lo contiene. |
| Subir / Bajar | Cambia el orden. |
| Duplicar | Copia el bloque o la fila. |
| Guardar como bloque reutilizable | (Solo en una fila) la guarda en la pestaña Guardados. |
| Eliminar | Quita el elemento. |
Panel derecho: propiedades#
Cambia según lo que esté seleccionado. Textos y títulos además muestran sobre el panel una barra de formato: Negrita, Cursiva, Subrayado, Tachado, listas con viñetas y numeradas (solo en Texto), Insertar enlace, Quitar enlace, Quitar formato, Párrafo… (Párrafo, Título 1, 2 o 3; solo en Texto), Tamaño (11 a 40 px), color del texto, resaltado y { } Variable. Los enlaces deben empezar por https://, http://, mailto:, tel: o ser una variable.
Estilo del correo (nada seleccionado, o clic en el fondo)#
| Propiedad | Valores | Por defecto |
|---|---|---|
| Ancho del correo | 400 a 800 px | 600 |
| Fondo de la página | Color | #FFFFFF |
| Fondo del contenido | Color | #FFFFFF |
| Tipo de letra | Arial, Verdana, Tahoma, Trebuchet, Georgia, Times, Courier | Arial |
| Tamaño de letra base | 11 a 22 px | 15 |
| Color del texto | Color | #111827 |
| Color de los enlaces | Color | #059669 |
Al enviar una difusión se agrega automáticamente un pie con el enlace para darse de baja y el píxel de apertura.
Fila#
| Propiedad | Qué hace | Por defecto |
|---|---|---|
| Columnas | Cambia la distribución. Si reduces columnas, los bloques sobrantes pasan a la última. | 1 columna |
| Apilar columnas en móvil | (Con 2 o más columnas) Las columnas se apilan en pantallas pequeñas. | Activado |
| Color de fondo | Fondo de la fila. | Sin color |
| Relleno | Espacio interior arriba, derecha, abajo, izquierda (0 a 200 px). | 0, 0, 0, 0 |
| Mostrar solo si… | Condición. Ver Variables y condiciones. | Apagado |
Bloques#
Todos los bloques tienen además Relleno, Color de fondo y Mostrar solo si….
| Bloque | Propiedades (valor por defecto) |
|---|---|
| Texto | Tamaño 10–60 px (15); Color; Alineación (izquierda); Interlineado 1–3 (1,5). Relleno 10/20/10/20. Texto inicial: «Escribe aquí tu mensaje…». |
| Título | Nivel (Título 1, 2 o 3; Título 2); Tamaño 12–80 px (26); Grosor (Negrita o Normal); Color; Alineación (izquierda). Relleno 14/20/6/20. Texto inicial: «Título del mensaje». |
| Imagen | Dirección o archivo (solo https://); Texto alternativo; Enlace al hacer clic; Ancho 10–100 % (100); Alineación (centro); Borde redondeado 0–200 px (0). Relleno 0. Sin imagen, el lienzo muestra «Imagen: elige o sube una en el panel». |
| Botón | Texto («Ver más»); Enlace (http, https, mailto, tel o variable); Color de fondo (#10B981); Color del texto (#FFFFFF); Color del borde (opcional); Tamaño de letra 10–40 px (15); Texto en negrita (sí); Borde redondeado 0–50 px (6); Relleno vertical 4–40 (12); Relleno horizontal 4–100 (26); Alineación (centro); Ocupar todo el ancho (no). |
| Divisor | Color (#E5E7EB); Grosor 1–12 px (1); Estilo (Continua, Rayas, Puntos); Ancho 10–100 % (100). |
| Espaciador («Espacio») | Alto 4–200 px (24). |
| Redes sociales («Redes») | Lista de redes (Facebook, Instagram, X, LinkedIn, YouTube, TikTok, WhatsApp, Sitio web) con su enlace — por defecto Facebook e Instagram, con Agregar para más; Tamaño 20–64 px (32); Forma (Círculo o Cuadrado); Colores (De cada red, Oscuros, Grises); Alineación (centro). En el correo final solo aparecen las redes que tienen enlace. |
| Video | Enlace del video; Imagen de portada (opcional; si el enlace es de YouTube se usa su miniatura); Texto del enlace («Ver video»); Texto alternativo («Video»); Alineación del enlace (centro). El correo no reproduce el video: muestra la portada y un enlace «▶ Ver video». |
| Menú | Opciones (por defecto Inicio y Contacto; cada una con texto y enlace, con Agregar); Tamaño 10–30 px (13); Color; Separadores (sí); Alineación (centro). |
| Formulario | Formulario (lista de los formularios publicados); Texto del botón («Completar formulario»); y las mismas propiedades de apariencia del Botón. El botón lleva al formulario con un enlace personal para cada contacto. Sin formulario elegido: «Formulario: elige uno en el panel». |
| HTML | Código. Para quien sabe HTML; se limpia al guardar (ver abajo). |
Los campos de texto con el botón { } permiten insertar variables.
Imágenes#
Con el botón Subir imagen (flecha hacia arriba) de la propiedad de imagen subes un archivo JPG, PNG, GIF o WebP de hasta 3 MB. El editor te da una dirección pública que se pone sola en la propiedad. Mensajes: «La imagen pesa más de 3 MB.», «Solo se admiten imágenes JPG, PNG, GIF o WebP.». Las imágenes se sirven públicas (los programas de correo las cargan desde fuera). En los bloques de imagen solo se aceptan direcciones https://.
Vista previa#
El botón Vista previa abre una ventana con el correo tal como saldría:
- Ver como: «Sin datos (valores de respaldo)» o uno de hasta 8 contactos recientes activos con correo (se muestra «Nombre · Tipo»). Las variables y las condiciones se aplican con los datos de ese contacto.
- Botones de escritorio y móvil.
- Arriba se muestra el Asunto ya con las variables reemplazadas.
Enviar prueba#
El botón Enviar prueba abre «Enviar prueba»: el campo Enviar a viene con tu correo (puedes cambiarlo) y el botón Enviar prueba.
- Se envía con la conexión SMTP asignada a la categoría Campañas de correo masivo. Si no hay una conexión activa asignada, aparece «No hay una conexión SMTP configurada (o activa) para esta categoría de envío.». Ver SMTP: envío de correo.
- El asunto llega con el prefijo «[Prueba]».
- Las variables toman tus datos (tu nombre; el correo de destino) y las condiciones se evalúan como un contacto sin tipo ni metadatos; el enlace de baja queda como
#. - Necesitas permiso de gestión de templates.
Guardar#
Guardar (o Ctrl+S) guarda el nombre, el asunto, el texto de vista previa, el tipo de correo, el diseño y el HTML final. Al guardar un template nuevo, la dirección de la página pasa a incluir su número.
| Situación | Mensaje |
|---|---|
| Sin nombre | «Ponle un nombre al template.» |
| Sin contenido | «Agrega contenido al template antes de guardar.» / «El template no tiene contenido.» |
| Nombre repetido (sin importar mayúsculas) | «Ya existe un template con ese nombre.» |
| Diseño muy grande | «El diseño es demasiado grande.» |
| Sin permiso | «No tienes permiso para guardar templates.» |
| Éxito | «Template guardado» |
Si intentas salir (con un enlace o el menú lateral) con cambios sin guardar, aparece «Hay cambios sin guardar» con Seguir editando, Salir sin guardar y Guardar y salir.
Reglas y comportamientos#
- El correo final usa solo tablas y estilos en línea, para que se vea bien en Gmail y Outlook.
- Al guardar, el HTML se limpia: solo se conservan etiquetas y estilos seguros; se quitan scripts, formularios, marcos y atributos de eventos; los enlaces solo pueden ser
http,https,mailto,telo variables; las imágenes solohttps. - Un template creado antes del editor (formato «Texto / HTML») se abre con todo su contenido dentro de un bloque HTML.
- Los templates guardados son de toda la empresa. Además de las difusiones, las acciones por etapa de las oportunidades pueden enviar un template por correo; la columna Usos solo cuenta difusiones.
- Al eliminar un template, las difusiones que ya lo usaron conservan su propia copia.
<!-- Fuente: tenant-app/public/templates/index.php, tenant-app/public/templates/mailtemplate.php, tenant-app/public/templates/editor.js, tenant-app/public/templates/render.js, tenant-app/public/api/plantillas_correo.php, tenant-app/public/api/correo_editor.php, tenant-app/public/correo/index.php, tenant-app/public/correo/mailtemplate.php, shared/src/Core/DifusionCorreo.php, shared/src/Core/DifusionCfg.php, db/migrations/0106_editor_templates_correo.sql, db/migrations/0107_tipos_correo.sql -->