Las plantillas de correo electrónico controlan el contenido exacto de cada mensaje automático que Banred Helpdesk envía a los clientes. Cada vez que se abre un ticket nuevo, un agente envía una respuesta o el estado cambia, el sistema busca la plantilla activa correspondiente, reemplaza las variables con los datos reales del ticket y despacha el correo a través del buzón configurado medianteDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/banredco/helpdesk/llms.txt
Use this file to discover all available pages before exploring further.
MailService::sendTemplate().
Plantillas del sistema vs. personalizadas
Banred Helpdesk distingue dos categorías de plantillas:| Tipo | is_system | Descripción |
|---|---|---|
| Sistema | 1 | Plantillas integradas que el sistema invoca automáticamente en eventos predefinidos (p. ej. ticket_created, ticket_replied). No pueden eliminarse. |
| Personalizadas | 0 | Plantillas adicionales creadas por el administrador para casos específicos. Se invocan desde código personalizado usando MailService::sendCustomTemplate(). |
ORDER BY is_system DESC, name ASC), lo que facilita identificarlas de un vistazo en /admin/templates.php.
Campos de una plantilla
Cada registro en la tablaemail_templates contiene los siguientes campos relevantes:
| Campo | Descripción |
|---|---|
name | Nombre legible mostrado en la tabla de administración (p. ej. “Ticket creado”). |
code | Identificador único en código, sin espacios, solo letras y guiones bajos (p. ej. ticket_created). Se usa para invocar la plantilla desde PHP. |
subject | Asunto del correo. Admite variables entre llaves dobles. |
html_content | Cuerpo del correo en HTML. Admite variables y etiquetas HTML completas. |
is_system | 1 si es una plantilla de sistema; 0 si es personalizada. |
is_active | 1 para activa; 0 para inactiva. Las plantillas inactivas son ignoradas por MailService. |
Variables de plantilla
Las variables se insertan en el asunto y en el cuerpo HTML usando la sintaxis{{nombre_variable}}. MailService::sendTemplate() reemplaza cada marcador con el valor real del ticket antes de enviar el correo.
Ticket
| Variable | Valor reemplazado |
|---|---|
{{ticket_number}} | Número de ticket (p. ej. 1042). |
{{ticket_subject}} | Asunto del ticket. |
{{ticket_status}} | Nombre del estado actual (p. ej. “Abierto”). |
{{ticket_priority}} | Nombre de la prioridad (p. ej. “Media”). |
{{ticket_url}} | URL pública del ticket para que el cliente acceda sin iniciar sesión. |
Cliente
| Variable | Valor reemplazado |
|---|---|
{{client_name}} | Nombre completo del cliente. |
{{client_email}} | Dirección de correo del cliente. |
Otros
| Variable | Valor reemplazado |
|---|---|
{{reply_body}} | Cuerpo del último mensaje del agente (disponible en la plantilla ticket_replied). |
{{current_date}} | Fecha actual en formato dd/mm/aaaa. |
Crear una plantilla
Abrir el módulo de plantillas
En el panel de administración, navega a Configuración → Plantillas (
/admin/templates.php) y haz clic en Nueva Plantilla.Completar los campos principales
Ingresa el Nombre descriptivo de la plantilla y el Código identificador (sin espacios, solo letras minúsculas y guiones bajos). El código es el que utilizarás para invocarla desde PHP, por ejemplo:
request_documents.Redactar asunto y cuerpo
En el campo Asunto puedes usar variables, por ejemplo:En el campo Contenido HTML escribe el cuerpo completo del correo usando HTML y las variables disponibles. El panel de la derecha muestra todas las variables agrupadas por categoría. Debajo del editor aparece una Vista previa en tiempo real que se actualiza mientras escribes.
Editar una plantilla existente
Desde la tabla principal de plantillas, haz clic en el ícono de edición de cualquier fila para abrir/admin/template-edit.php?id={id}. Puedes modificar el Nombre, el Asunto, el Contenido HTML y el estado Activa / Inactiva mediante el checkbox correspondiente.
Probar una plantilla
El archivotest-template.php permite enviar un correo de prueba con la plantilla ticket_created usando el ticket con ID 1, con los errores de PHP visibles en pantalla. Es útil para verificar la configuración SMTP y el formato del HTML antes de activar una plantilla en producción.
Para probarlo, accede directamente desde el navegador:
MailService::sendTemplate(). Si el envío falla, se muestra el mensaje de error con el stack trace completo para facilitar el diagnóstico.