---
sourceDocument: Zurich Conversational Interfaces
sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/conversational-interfaces

 Release :

    - zurich

ft:locale :

    - en-US

ft:publication_title :

    - Zurich Conversational Interfaces

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Define Virtual Agent notification contents

# Define Virtual Agent notification contents {#ariaid-title1}

* Release version: Zurich
* 
* Updated July 31, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes to read

Create the content for a Virtual Agent notification delivered in a
chat or messaging channel.

## Before you begin

* Images for image cards must be 400 pixels wide or larger and must be in .jpg, .png, .bmp, .gif, .ico, or .svg format.
* If you're upgrading from an earlier release and want ACLs observed for data displayed in record cards and parameter substitutions in chat notifications, set the com.glide.cs.notification_record_access_check system property to true. The default value for this system property is false, which means that data is delivered regardless of the user's access level.  
  Note:  
  This property does not apply to advanced notifications.
* Role required: virtual_agent_admin or admin
{#define-va-notif-contents__ul_qm3_dw3_lpb}

## About this task

You can personalize Virtual Agent notifications by using parameter substitution to add dynamic content to the message header and message. When adding dynamic content to your notifications, you specify the variables that identify the record values to be included in the content. You can add dynamic content to the following types of notifications:

* Record-based notifications - Use the <kbd class="ph userinput">${&lt;variable_name&gt;}</kbd> format in your content to specify a variable that represents a record value from the table used for the notification. For example, if you want to customize the message heading for a notification that uses the Incident table and you want to include the incident Priority in the message, use the Select variable column to select the variable for incident priority.
* Event-based notifications - Use the <kbd class="ph userinput">${event.parm1}</kbd> and <kbd class="ph userinput">${event.parm2}</kbd> format to specify event-specific parameters that pass record information in the notification content. To learn more about event parameters and how they work, see [Events](https://www.servicenow.com/docs/access?context=events&version=zurich&pubname=zurich-build-workflows&ft:locale=en-US).
* Advanced notifications - Modify a script provided for advanced notifications to specify dynamic content from different data sources and identify third-party services, such as URL shortening for streamlining links in the content.
{#define-va-notif-contents__ul_xt2_s2r_3sb}

## Procedure

1. Navigate to AllSystem NotificationProviderNotifications and select the notification for which you're defining or updating content.
2. Do one of the following:  
   * If you're defining new content, navigate to the Notification Contents related list, select New Provider Content, and go to step 3.
   * If you're updating content, navigate to the Notification Contents related list, select the content to be updated, and go to step 4.
   {#define-va-notif-contents__ul_omd_t43_b4b}
3. Select the Virtual Agent content type:  
   * Virtual Agent Content - Chat: The notification is for chat channels.
   * Virtual Agent Content - Messaging: The notification is for a messaging channel, such as SMS.

   {#define-va-notif-contents__ul_a4n_xmh_b4b} Figure 1. Notification content
4. Provide or update the notification content:
   1. On the form, fill in the fields for the chat or messaging notification:  
      {#define-va-notif-contents__table_chk_33w_znb__entry__2}

      | Field | Description |
      |-|-|
      | Name | Name of the notification content. |
      | Notification | Notification that is associated with the content. This field is populated automatically with the notification that you created. |
      | Type | Notification layout: * Simple: A message-only notification, that contains information for review. * Record card: A notification that contains information about a particular record in a table. * Image card: A notification that contains images. {#define-va-notif-contents__ul_dhk_33w_znb} |
      | Table | (For Record Cards) Table to receive notifications about. This field is populated automatically with the table defined in the notification. |
      | Fields | (For Record Cards) Fields to be displayed in the notification. For example, if you select Comments and Work notes, the notification includes the comments and work notes that users have added to the record. |
      | Application | Application scope of the notification content. |
      | Active | Option to activate the notification content. |
      | Enable link | (For Record Cards) Option to add a link to the record. |
      | Advanced | Option that opens the script editor for entering a script that returns dynamic content for notification heading and message content pulled from multiple data sources. |
      | Script | (For advanced notification content) Script that you can edit to specify dynamic content from various data sources, including third-party services (such as URL shortening), to be used in the message heading and message content. |
      | Message heading | Text that appears at the top of the message. The default message heading is: A notification has arrived. You can continue the conversation after viewing the notification. If you want to create a custom heading with dynamic content, enter the heading text and specify the variables used in the text: * For record-based notifications: Expand the Select variables column and choose the variables for the record values to be included in the heading. The variables map to records in the table used for the notification. For example: <kbd class="ph userinput">An incident has been assigned to you with Priority:${priority}</kbd> * For event-based notifications: Specify the <kbd class="ph userinput">${event.parm1}</kbd> and <kbd class="ph userinput">${event.parm2}</kbd> variables to identify event-specific parameters that pass record information in the notification content. {#define-va-notif-contents__ul_fmr_nct_3sb} |
      | Message | Content of the message with rich text format. If you want to create a custom message with dynamic content, enter the message text and specify the variables used in the text: * For record-based notifications: Expand the Select variables column and choose the variables for the record values to be included in the message. The variables map to records in the table used for the notification. For example: <kbd class="ph userinput">Here's a brief description of your assigned incident:${short_description}</kbd> * For event-based notifications: Specify the <kbd class="ph userinput">${event.parm1}</kbd> and <kbd class="ph userinput">${event.parm2}</kbd> variables to identify event-specific parameters that pass record information in the notification content. {#define-va-notif-contents__ul_knc_f15_3sb} A notification message defined with rich text format is displayed in bold, italics, link (url), and unordered list. When users click the URL in the message, they are redirected to the destination as per the portal configuration. |
      | Image Source | (For Image Cards) Option for selecting the image to be displayed in the notification: * Upload image: Add the image by uploading. * URL: Specify the URL for the image. {#define-va-notif-contents__ul_dkz_xvc_14b} |
      | Image | (For Image Cards) Image displayed in the card. * To add the image, select Click to add. From the file finder, choose your image file and select OK. * To change the image, select Update. From the file finder, select the new image file and select OK. * To remove the image, select Delete. The file is immediately deleted. {#define-va-notif-contents__ul_g4l_sgd_14b} |
      | Image alt text | (For Image Cards) Alternative text for the image to be displayed in the card. |
      [Table 1. Notification Content - Virtual Agent Chat or Virtual Agent Messaging]

      {#define-va-notif-contents__table_chk_33w_znb}  
      Note:  
      To create or update the messaging notification details, navigate to the Delivery Channel related list and complete the form. For more information, see [Configure a delivery channel for Virtual Agent notification](https://www.servicenow.com/docs/VzEiObxQ_4fzLfnDiHnZnw "Configure a delivery channel for Virtual Agent notifications by specifying the messaging channel information to send notifications to users.").
   2. Select Submit or Update.
   {#define-va-notif-contents__substeps_v4d_fbj_b4b}
{#define-va-notif-contents__steps_u4d_fbj_b4b}

## What to do next

* To configure a delivery channel, see [Configure a delivery channel for Virtual Agent notification](https://www.servicenow.com/docs/VzEiObxQ_4fzLfnDiHnZnw "Configure a delivery channel for Virtual Agent notifications by specifying the messaging channel information to send notifications to users.").
* If you're creating an actionable notification, see [Define the actions](https://www.servicenow.com/docs/HUgaYCHViS~VmZApGhwVwQ "Create the actions for a Virtual Agent chat or messaging channel to send actionable notifications.").
{#define-va-notif-contents__ul_imp_m4b_npb}

*[\>]: and then