From a845cea360b0f2f18c94daec1a8df2c21f4eb2ef Mon Sep 17 00:00:00 2001 From: Buddies Dev Date: Fri, 26 Jun 2026 13:00:23 +0200 Subject: [PATCH 1/2] Document customizable email templates --- docs/functions/emailsms_alert.md | 65 ++++++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) diff --git a/docs/functions/emailsms_alert.md b/docs/functions/emailsms_alert.md index 169fd33b..c0ad9f8b 100644 --- a/docs/functions/emailsms_alert.md +++ b/docs/functions/emailsms_alert.md @@ -47,6 +47,71 @@ Gmail in this example 10. Change the port to 587 11. Click Save +### Customizing alert email subjects and bodies + +Tactical RMM supports customizable email templates for alert emails directly in +**Settings > Global Settings > Email Alerts**. + +You can define custom subject and body templates for: + +- Checks +- Tasks +- Agent Offline +- Agent Recovered + +If a template field is left blank, Tactical RMM will continue using the built-in +subject or body for that alert type. + +The original generated values are still available as template variables: + +- `{subject}` +- `{body}` + +Depending on the alert type, additional variables are available. + +`{agent}`, `{client}`, `{site}`, `{site_id}`, `{policy}`, `{alert_name}` + +Section-specific variables are also available, for example: + +- Checks: `{check_name}`, `{check_description}`, `{details}`, `{more_info}`, + `{stdout}`, `{stderr}`, `{retcode}` +- Tasks: `{task_name}`, `{details}`, `{stdout}`, `{stderr}`, `{retcode}` +- Agent offline / recovered: `{details}`, `{alert_status}` + +Example subject template: + +```text +[{client}] {agent} - {alert_name} +``` + +Example body template: + +```text +Alert: {alert_name} +Agent: {agent} +Site ID: {site_id} + +{details} +``` + +Original built-in subject examples: + +```text +{client}, {site}, {agent} - {alert_name} Failed +{client}, {site}, {agent} - {alert_name} Resolved +{client}, {site}, {agent} - data overdue +{client}, {site}, {agent} - data received +``` + +Original built-in body examples: + +```text +{client}, {site}, {agent} - {alert_name} Failed - {details} +{client}, {site}, {agent} - {alert_name} Resolved - {details} +Data has not been received from client {client}, site {site}, agent {agent} within the expected time. +Data has been received from client {client}, site {site}, agent {agent} after an interruption in data transmission. +``` + ## SMS Alerts Under **Settings > Global Settings > SMS Alerts** From 31c2d23b3b0779c9a8de4facfe13245ea8e47957 Mon Sep 17 00:00:00 2001 From: Buddies Dev Date: Fri, 3 Jul 2026 10:31:28 +0200 Subject: [PATCH 2/2] Add last_response variable --- docs/functions/emailsms_alert.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/functions/emailsms_alert.md b/docs/functions/emailsms_alert.md index c0ad9f8b..4d0723c9 100644 --- a/docs/functions/emailsms_alert.md +++ b/docs/functions/emailsms_alert.md @@ -76,7 +76,9 @@ Section-specific variables are also available, for example: - Checks: `{check_name}`, `{check_description}`, `{details}`, `{more_info}`, `{stdout}`, `{stderr}`, `{retcode}` - Tasks: `{task_name}`, `{details}`, `{stdout}`, `{stderr}`, `{retcode}` -- Agent offline / recovered: `{details}`, `{alert_status}` +- Agent offline / recovered: `{details}`, `{alert_status}`, `{last_response}` + +`{last_response}` uses the Default Date Format from Global Settings. Example subject template: