.png?version=1&modificationDate=1617629545752&cacheVersion=1&api=v2)
Manage notifications in your Jira and Service Management. Use JQL queries or apply default Jira filters to create personalized notifications for a specific group of people.
| Info |
|---|
Please, remember to log in to your Jira instance with Administration access so you can manage Notification Assistant and create email templates.To learn more, read Installation Guidethat you need to be a Project Administrator to manage Notifications and Templates |
| Table of Contents |
|---|
How to set up your notification in Notification Assistant for Jira Cloud
To set up notifications in Notification Assistant, go you can either set them up at the Global or Project level.
Global Level
Go to the Apps section and then pick Global notifications
Project Level
Go to the Project Settings and select “Apps“. Scroll down to find the "Notification Assistant" and click on it. Configure your notification following the steps described below.
.png?version=1&modificationDate=1617626792928&cacheVersion=1&api=v2)
Edit Notification Details
Notification Name. Provide a unique name for your notification in this required field.
Description. If you like, you can provide your notification with a description to remember the notification's purpose.
Configure Triggers
Determine when the notification should fire and in which interval.
Select the only configuration you want (Weekly or Event).
Weekly. Select how often, at what time interval, and on which days the notification will fire
.
Date/Time. You can specify a start and stop date/time for the notification based on the Custom Fields values on issues found by the JQL query.
Monthly. You can specify a day of the month or the Nth day of the week and the time the notification will be fired.
CRON expression. You can specify your own CRON expression. Provides a parser and evaluator for unix-like CRON expressions.
Event. You can choose trigger by events. You may choose the notification to respect the "Do not notify me" settings in the Jira user profile.
You can read more about what each event means in our Event Definitions page.
Tip: Remember that too many or low value notifications may be consider spam by your recipient.
JQL Expression
Custom JQL. Write any JQL expression to fire your custom notification. To learn more about JQL syntax, read Advanced Searchingread this doc https://support.atlassian.com/jira-core-cloud/docs/use-advanced-search-with-jira-query-language-jql/.
Add Recipients
You can pick recipients from People, Users, Groups, Project Roles, Custom Fields, or enter their hardcoded email addresses. To add recipients, click on the “Configure Recipients” tab and choose the required checkboxes in a modal window. Select whether you like to send one email to all recipients or a personal email per recipient.
| Info |
|---|
Recipients that are email addresses in custom fields, or hardcoded in the Email tab do not need to be licensed Jira users. However, this also means we can’t perform permission checking. Please be careful with how you use this functionality. |
People. In this tab, you can add Assignee, Reporter, Watchers, or Voters to the recipient list.
Users. In this tab, you can specify Jira Users to receive notifications. Enter a user name in the user picker.In case you add a Jira user who has no access to the issue or project you configured in the notification, this user won’t be notified. If you need to notify this person anyway, add their hardcoded email address.
Groups. Select one or more Jira groups to receive notifications. Your notification email will be sent to every recipient separately, not as a group letter in your email agent. See more about user groups in the Managing groups section.
.png?version=1&modificationDate=1617628323825&cacheVersion=1&api=v2&width=408)
Roles. You can select one or more Jira Project Roles to receive notifications. For example, it could be Developers, Administrators, Service Management Customers, or Service Management Team. See more about roles on the Managing project roles page.
Custom Field. To add recipients from custom fields, you can choose a custom field of type "Text Field," "User Picker," "Multi-User Picker," "Group Picker," "Multi-Group Picker" and "JSM Request Recipients" to be the recipient. The custom field of type "Text Field" needs to be populated with one or many valid comma-separated email addresses for notifications to be sent. You can add custom fields in the administration menu "Issues / Fields." See more about custom fields on
page.
Email. Whether it’s a licensed Jira user or an external recipient, you can specify one or many email addresses separated by a comma to notify these people.
Choose Email Template
If you’d like to notify your recipients via email, you can apply a template to the notification. The list of available email templates is visible in a drop-down menu. You can use Default Email Template or create personalized email templates in the new drag-and-drop template editor (available from version 7.0).
We recommend you use our Create Email Template docs to create a default Issue Details Template and a Comment template which can be used with the associated issue events.
Advanced Notification Settings
Advanced Notification Settings
Template Selection
In the Advanced Notification Settings, select the template theme to the notification. The list of available email templates is visible in a drop-down menu. You can use leave it on Dynamic so that NAFJC automatically selects the right default template, or pick from our list of default templates; Table Template, Single Issue Template, Comment Template, or create a personalized one pick a template you created in the drag-and-drop template editor.
template editor.
Including Comment
If you’re using an Issue Commented, Public Comment on Issue, Private Comment on Issue, or their respective Edited events, you can also include previous comments in the email. NAFJ will automatically include as many as there are on the issue, up to 10.
Please, remember that it is required to use the Last comment body field in your Template for this to work. For more information, refer to https://atlasauthority.atlassian.net/l/cp/o19yxczm.
| Info |
|---|
Please note that this option is only available when editing an existing notification and not upon notification creation. |
Including Attachment
| Anchor | ||||
|---|---|---|---|---|
|
Mark the checkbox if you need your notification to include attachments in emails. Please readAttachment Restrictions for more info.
Exporting Issues as CSV
Mark the above checkbox if you want to export the issues that trigger the notification as a CSV file. Note: the CSV will be attached to email notifications regardless of the settings in Including Attachment.
Mark the above checkbox if you want the CSV to include all issue fields. If the checkbox is not checked, only issue fields that are used by the notification’s Template are exported.
Event Grouping
You can configure event grouping / batching of events into a single email. Please read Notification Grouping / Digests for more details.
Enable Workflow Approvals via Email
You can configure enable approvals via email. Please read Working with Approvals in Jira Service Management for more information.
Customer reply email
You can set the email to which a customer’s email will go when they hit reply on a notification. This setting is only enabled on Notifications being configured at the Project level.
Please, be aware to use only valid email addresses otherwise the notifications are going to fail.
Click Save and you’re done!