Email Notifications for ServiceNow
ServiceNow notifications are triggered by events and send emails, SMS, or other alerts to users.
Notification Components
| Component | Table | Purpose |
|---|
| Notification | sysevent_email_action | Main notification record |
| Email Template | sysevent_email_template | Reusable email layouts |
| Event | sysevent | Triggers notifications |
| Event Registration | sysevent_register | Defines custom events |
| Email Script | sys_script_email | Dynamic content scripts |
Creating Notifications
Basic Notification Structure
Notification: Incident Assigned
├── When to send
│ ├── Table: incident
│ ├── When: Record inserted or updated
│ └── Conditions: assigned_to changes AND is not empty
├── Who will receive
│ ├── Users: ${assigned_to}
│ └── Groups: (optional)
├── What it will contain
│ ├── Subject: Incident ${number} assigned to you
│ ├── Message: HTML body with ${field} references
│ └── Email Template: (optional)
└── Advanced
├── Weight: 0 (priority)
└── Send to event creator: false
Notification Conditions
// Simple field conditions
assigned_to CHANGES
priority = 1
state = 6 // Resolved
// Script condition (ES5 only!)
// Returns true to send, false to skip
(function() {
// Only notify for VIP callers
var caller = current.caller_id.getRefRecord();
return caller.vip == true;
})()
// Advanced condition with multiple checks
(function() {
// Don't notify on bulk updates
if (current.sys_mod_count > 100) return false;
// Only for production CIs
var ci = current.cmdb_ci.getRefRecord();
return ci.used_for == 'Production';
})()
Email Templates
Template Variables
<!-- Field references -->
${number}
<!-- Direct field value -->
${caller_id.name}
<!-- Dot-walked reference -->
${opened_at.display_value}
<!-- Display value -->
<!-- Special variables -->
${URI}
<!-- Link to record -->
${URI_REF}
<!-- Reference link -->
${mail_script:script_name}
<!-- Include email script -->
<!-- Conditional content -->
${mailto:assigned_to}
<!-- Mailto link -->
Template Example
<html>
<body style="font-family: Arial, sans-serif;">
<h2>Incident ${number} - ${short_description}</h2>
<table border="0" cellpadding="5">
<tr>
<td><strong>Priority:</strong></td>
<td>${priority}</td>
</tr>
<tr>
<td><strong>Caller:</strong></td>
<td>${caller_id.name}</td>
</tr>
<tr>
<td><strong>Assigned to:</strong></td>
<td>${assigned_to.name}</td>
</tr>
<tr>
<td><strong>Description:</strong></td>
<td>${description}</td>
</tr>
</table>
<p>
<a href="${URI}">View Incident</a>
</p>
${mail_script:incident_history}
</body>
</html>
Email Scripts
Basic Email Script
// Email Script: incident_history
// Table: incident
// Script (ES5 only!):
;(function runMailScript(current, template, email, email_action, event) {
// Build activity history
var html = "<h3>Recent Activity</h3><ul>"
var history = new GlideRecord("sys_journal_field")
history.addQuery("element_id", current.sys_id)
history.addQuery("name", "incident")
history.orderByDesc("sys_created_on")
history.setLimit(5)
history.query()
while (history.next()) {
html += "<li><strong>" + history.sys_created_on.getDisplayValue() + "</strong>: "
html += history.value.substring(0, 200) + "</li>"
}
html += "</ul>"
template.print(html)
})(current, template, email, email_action, event)
Email Script with Attachments
// Add attachments from the record to the email
;(function runMailScript(current, template, email, email_action, event) {
var gr = new GlideRecord("sys_attachment")
gr.addQuery("table_sys_id", current.sys_id)
gr.addQuery("table_name", "incident")
gr.query()
while (gr.next()) {
email.addAttachment(gr)
}
})(current, template, email, email_action, event)
Dynamic Recipients
// Email Script to add CC recipients dynamically
;(function runMailScript(current, template, email, email_action, event) {
// Add all group members as CC
var group = current.assignment_group
if (!group.nil()) {
var members = new GlideRecord("sys_user_grmember")
members.addQuery("group", group)
members.query()
while (members.next()) {
var user = members.user.getRefRecord()
if (user.email) {
email.addAddress("cc", user.email, user.name)
}
}
}
})(current, template, email, email_action, event)
Custom Events
Registering a Custom Event
// Event Registration
// Name: x_myapp.incident.escalated
// Table: incident
// Description: Fired when incident is escalated to management
// Fired by: Business Rule
// In Business Rule (ES5 only!)
;(function executeRule(current, previous) {
// Check if escalation occurred
if (current.escalation > previous.escalation) {
// Fire custom event
gs.eventQueue(
"x_myapp.incident.escalated",
current,
current.escalation.getDisplayValue(), // parm1
current.assigned_to.name, // parm2
)
}
})(current, previous)
Notification on Custom Event
Notification: Escalation Alert
├── When to send
│ ├── Send when: Event is fired
│ └── Event name: x_myapp.incident.escalated
├── Who will receive
│ └── Users/Groups: Escalation Managers
└── What it will contain
├── Subject: Escalation: ${number} - ${event.parm1}
└── Message: Incident escalated. Assigned to: ${event.parm2}
Recipient Types
Who Will Receive
| Type | Description | Example |
|---|
| Users | Specific users | ${assigned_to}, ${caller_id} |
| Groups | User groups | Service Desk, CAB |
| Group Managers | Group manager field | ${assignment_group.manager} |
| Event Parm 1/2 | From event parameters | ${event.parm1} |
| Additional Recipients | Email addresses | External emails |
Recipient Script
// Recipient Script (ES5 only!)
// Returns comma-separated list of emails or sys_ids
;(function getRecipients(current, event) {
var recipients = []
// Add the caller
if (!current.caller_id.nil()) {
recipients.push(current.caller_id.email.toString())
}
// Add VIP's manager
var caller = current.caller_id.getRefRecord()
if (caller.vip == true && !caller.manager.nil()) {
recipients.push(caller.manager.email.toString())
}
return recipients.join(",")
})(current, event)
Notification Weight
Priority system for multiple matching notifications:
| Weight | Use Case |
|---|
| 0 | Default priority |
| 1-99 | Higher priority (lower weight = higher priority) |
| -1 to -99 | Lower priority |
| 100+ | Rarely used |
// Only highest weight notification sends if "Exclude subscribers" checked
// Weight 0 notification beats Weight 10 notification
Digest Notifications
Configuring Digest
Notification: Daily Incident Summary
├── Digest: Checked
├── Digest Interval: Daily
├── Digest Time: 08:00
└── Content: Summary of all incidents
Digest Email Script
// Summarize digest records
;(function runMailScript(current, template, email, email_action, event) {
var count = 0
var html = '<table border="1" cellpadding="5">'
html += "<tr><th>Number</th><th>Description</th><th>Priority</th></tr>"
// 'current' is a GlideRecord with all digest records
while (current.next()) {
count++
html += "<tr>"
html += "<td>" + current.number + "</td>"
html += "<td>" + current.short_description + "</td>"
html += "<td>" + current.priority.getDisplayValue() + "</td>"
html += "</tr>"
}
html += "</table>"
html += "<p>Total: " + count + " incidents</p>"
template.print(html)
})(current, template, email, email_action, event)
Outbound Email Configuration
Email Properties
// System Properties for email
glide.email.smtp.active // Enable/disable outbound email
glide.email.smtp.host // SMTP server
glide.email.smtp.port // SMTP port (usually 25 or 587)
glide.email.default.sender // Default from address
glide.email.test.user // Test recipient (all emails go here)
Testing Notifications
// Background Script to test notification (ES5 only!)
var gr = new GlideRecord("incident")
gr.get("sys_id_here")
// Fire event to trigger notification
gs.eventQueue("incident.assigned", gr, gr.assigned_to.getDisplayValue(), gs.getUserDisplayName())
gs.info("Event queued for incident: " + gr.number)
Best Practices
- Use Templates - Reuse layouts across notifications
- Test Thoroughly - Use test user property during development
- Consider Digests - For high-volume notifications
- Weight Carefully - Prevent duplicate emails
- ES5 Only - All scripts must be ES5 compliant
- Limit Recipients - Don't spam large groups
- Include Context - Provide enough info to act without login
- Mobile-Friendly - Keep HTML simple for mobile clients
Common Issues
| Issue | Cause | Solution |
|---|
| Email not sent | Event not fired | Check business rule fires event |
| Wrong recipients | Script error | Debug recipient script |
| Missing content | Template variable wrong | Check field names |
| Duplicate emails | Multiple notifications | Check weights and conditions |
| Delayed emails | Email job schedule | Check sysauto_script |
