Articles, Blogs, Videos, Podcasts, Share projects - Experiences from the field

Hi there,

When working with the Virtual Agent client, there are several parameters that you can add to Service Portal Agent Chat Configuration and a (legacy) Service Portal widget. Parameters like loading a specific topic, disabling sound notifications, activating live agent only, etcetera. In a few short articles I'll share a bit of background information on some of these parameters. This time: turning off sound notifications.

Sound notification

Users automatically receive audio alerts when they receive a message in the Virtual Agent client. The default sound notification uses the "sn_va_web_client_alert.mp3" audio file. It is possible to turn off the sound notification. Depending on how you implemented the Virtual Agent client on your instance, you would need to add a parameter to the applicable Service Portal Agent Chat Configuration record, or add it to the URL parameters of the (legacy) Service Portal widget. Both methods do work slightly differently.

Service Portal Agent Chat Configuration

If you are using Service Portal Agent Chat Configuration, open the applicable Service Portal Agent Chat Configuration record. Within the Server Script you would need to add "disable_audio_notifications: true" to turn off the sound notification.

For example:

(function($sp) {

    return = {
        disable_audio_notifications: true
    };

})($sp);

(legacy) Service Portal widget

If you are using a (legacy) Service Portal widget, verify if it concerns an embedded widget (for example to the header or footer of the portal) or that it concerns a widget instance that has been added to a specific page.

Widget instance

When having a widget instance in place, ctrl + right click on the Virtual Agent icon, and select "Instance Options".

Within the modal, add to the "Virtual Agent Client URL Parameters" field:

sysparm_disable_audio_notifcation=true

Embedded widget

A common seen method when working with the Virtual Agent client, is embedding the Service Portal widget to the header or footer of the portal. Adding URL parameters is also possible in this case, I've explained such in a previous article (Adding instance options to directly embedded Service Portal Widgets).

For example, your code for embedding the Service Portal widget might look like:

<widget id="sn-va-sp-widget"></widget>

To turn-off sound notifications you would need to expand this to:

<widget id="sn-va-sp-widget" options='{"va_url_params":"&sysparm_disable_audio_notifcation=true"}'></widget>

---

And that's it! A short explanation on how you can turn off sound notifications for the Virtual Agent client, for both Service Portal Agent Chat Configuration and a Service Portal widget.

If any questions, let me know!

Kind regards,

Mar k Roethof

ServiceNow Technical Platform Architect @ Eraneous

3x ServiceNow Developer MVP

3x ServiceNow Community MVP

---

LinkedIn

Labels: