{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":4870,"path":"conversational-interfaces/virtual-agent/configuring-va-notifications.md","title":"Configuring Virtual Agent notifications","bundle":null,"doc_type":null,"release":"australia","body":"\n# Configuring Virtual Agent notifications\n\nSend ServiceNow notifications directly to users via the Virtual Agent chatbot on supported messaging channels. Notifications can be simple informational messages for review, or actionable messages with buttons that users can select to perform certain actions.\n\nNotifications are sent to recipients via the Virtual Agent bot in the chat widget, pre-built messaging integrations \\(for example, SMS Twilio, Slack, Microsoft Teams, Workplace from Facebook services, and Facebook Messenger messaging platform\\), and custom chat integrations.\n\nNotification functionality is included with the Glide Virtual Agent \\(com.glide.cs.chatbot\\) plugin and also with Virtual Agent Lite, which is included with the ServiceNow AI Platform. However, Virtual Agent Lite users can receive only simple notifications, while Virtual Agent users can receive both actionable notifications and simple notifications. Users with no associated ServiceNow profiles in the \\[sys\\_user\\] table can receive non-actionable Virtual Agent notifications.\n\n## How Virtual Agent notifications work\n\nAs an admin, you can define different types of notifications that have specific layouts and content. You can also customize certain aspects of notification content, such as the message heading and message content.\n\n-   **Simple notifications**\n\n    The content can be a standard informational message, record card, or an image card. Simple notifications are delivered to users immediately, even when they're engaged in a conversation with a virtual or live agent.\n\n-   **Actionable notifications**\n\n    These notifications have buttons that enable the recipient to perform certain actions, such as adding a comment or requesting a live agent. When you create an actionable notification, you associate an action with a published Virtual Agent topic, a scriptable action, or a flow action that handles the action to be performed. To encourage users to act on a notification, admin users can choose to remove the **Skip** option. If the user still doesn’t act, the conversation will be completed as inactive.\n\n    **Note:** The notifications are actionable only when there is an associated link action to its content.\n\n    Actionable notifications are delivered to users when they're not in an active conversation with a virtual or live agent. A queue stores actionable notifications that are waiting to be delivered, for up to eight hours by default.\n\n    Actionable notifications are best suited for conversational purposes, such as:\n\n    -   Password reset\n    -   Incident update\n    -   Approval request\n    -   Course survey\n    -   Service follow-ups and surveys\n    -   Employee onboarding follow-ups\n    When a topic conversation completes, Virtual Agent automatically prompts the user to view pending notifications \\(if any\\). Admins can suppress this prompt by setting the **com.glide.cs.show\\_pending\\_notifications\\_prompt** property on the System Properties table to false.\n\n-   **Notifications with dynamic content**\n\n    You can personalize Virtual Agent notifications by adding dynamic content to message headers and messages. For record- and event-based notifications, you use parameter substitution to specify the variables that identify the record values \\(from the notification table\\) to be included in the content.\n\n-   **Advanced notifications with dynamic content**\n\n    You can create Virtual Agent notifications that use a script to add dynamic content in message headers and messages. The content can come from multiple data sources and include third-party services, such as URL shortening.\n\n-   **Variables in notifications**\n\n    You can pass information to a completed survey when the notification is triggered. Context is defined by the script found in the notification topic. This script cannot be modified.\n\n    ```\n    vaVars.global_notification_context = \n      JSON.stringify({\n        'tableName': table_name, \n            'tableSysId': sys_id, \n            'actionId': actionId, \n            'eventParm1': eventParm1, \n            'eventParm2': eventParm2});\n    ```\n\n    Notifications are triggered by records updates or by creating a platform event in the event queue. `actionId` is the ID number for the action. The platform event takes in the `eventParm1` and `eventParm2` parameters. If a notification is triggered, the parameters are passed to the topic. To capture the notification incident number in your topic, use the following script.\n\n    ```\n    var notificationContext = JSON.parse(vaVars.global_notification_context);\n    vaVars.sysId = notificationContext.tableSysId;\n    varVars.tableName = notificationContext.tableName;\n    ```\n\n\n## Notification processing\n\nVirtual Agent notifications have certain processing controls and limitations, such as the maximum number of recipients allowed per notification and the number of notifications that can be sent per day. The following table identifies these processing controls and the system properties that can be used to change their default values.\n\n<table id=\"table_ly5_b15_hsb\"><thead><tr><th>\n\nNotification processing control or limitation\n\n</th><th>\n\nDefault value\n\n</th><th>\n\nAssociated system property\n\n</th></tr></thead><tbody><tr><td>\n\nMaximum number of recipients per notification per channel\n\n</td><td>\n\n100,000 recipients\n\n</td><td>\n\n**com.glide.cs.per\\_notification\\_user\\_limit** Max limit: None\n\n**Note:**\n\n-   If there are more recipients than the configured number, warning messages are displayed to reduce the recipient list while you’re configuring the notification and when the notification is delivered. The warnings are displayed only when there is Virtual Agent content associated with the notification.\n-   Recipient limits may apply to third-party delivery channels based on the level of service or subscription.\n\n</td></tr><tr><td>\n\nMaximum number of notifications per day\n\n</td><td>\n\n100,000 notifications\n\n</td><td>\n\n**com.glide.cs.daily\\_notification\\_limit**Max limit: None\n\n**Note:** Rate limits may apply to third-party delivery channels based on the level of service or subscription.\n\n</td></tr><tr><td>\n\nLifespan of actionable notifications \\(a queue stores actionable notifications that are waiting to be delivered\\)\n\n</td><td>\n\n8 hours\n\n</td><td>\n\n**com.glide.cs.idle\\_actionable\\_notification\\_timer** **Note:** You can specify a maximum value of 72 hours.\n\n</td></tr><tr><td>\n\nAllow access to notification card content and parameter substitutions in notification headings and messages\n\n</td><td>\n\nFalse \\(not enabled\\)\n\n</td><td>\n\n**com.glide.cs.notification\\_record\\_access\\_check** **Note:** This property does not apply to advanced notifications.\n\n</td></tr></tbody>\n</table>## Notification experience for end users\n\nThe notification experience for end users depends on the type of notification that they're receiving. End users can also manage how their notifications are delivered by subscribing to or unsubscribing from notifications.\n\n-   Simple message notifications - These notifications are delivered immediately to the end user, even when the user is chatting with a bot or live agent. The user sees the incoming message but can continue with the current conversation.\n-   Actionable notifications - These notifications are delivered only when the user is not in an active conversation with a virtual or live agent. When users complete their conversation with a bot or live agent, they can use the **Show notification** command to view a list of pending notifications, which displays the heading of each notification. Users can select a pending notification to review, then perform the appropriate action for the notification, or skip the action.\n\n## User subscriptions for notifications\n\nEnd users can subscribe or unsubscribe to notifications on the channel that they're using. For example, the chat menu provides a toggle switch that users can use to subscribe or unsubscribe to notifications on the web channel.\n\nIn the conversational integrations for Slack, Microsoft Teams, Workplace from Facebook services, end users manage their notification subscriptions by using the **Subscribe** and **Unsubscribe** commands.\n\n## What to do next\n\n-   **[Create Virtual Agent notifications](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/create-va-notifications.md)**  \nCreate a notification that is sent directly to users via the Virtual Agent chatbot. The notification specifies when users receive the notification \\(triggers for the notification\\) and who receives it \\(recipients with and without accounts in the User \\[sys\\_user\\] table\\).\n-   **[Create additional recipients for Virtual Agent notifications](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/create-additional-recipients.md)**  \nCreate and define additional recipients for a Virtual Agent notification to be delivered on chat channels or messaging channels.\n-   **[Define Virtual Agent notification contents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/define-va-notif-contents.md)**  \nCreate the content for a Virtual Agent notification delivered in a chat or messaging channel.\n-   **[Configure a delivery channel for Virtual Agent notification](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/configure-delivery-channel.md)**  \nConfigure a delivery channel for Virtual Agent notifications by specifying the messaging channel information to send notifications to users.\n-   **[Define Virtual Agent notification actions](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/define-va-notif-actions.md)**  \nCreate the actions for a Virtual Agent chat or messaging channel to send actionable notifications.\n-   **[Define the Virtual Agent link actions to notification content](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/define-va-notif-link-actions.md)**  \nCreate the link actions for Virtual Agent notification content to be delivered in a chat or messaging channel as actionable notifications.\n-   **[Enable Virtual Agent notifications](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/enable-va-notifications.md)**  \nEnable Virtual Agent notifications so that your end users can receive notifications in supported Virtual Agent channels.\n\n**Parent Topic:**[Configuring Virtual Agent](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/configure-virtual-agent.md)\n\n"}}