{"versionId":"b82f98e8-817d-417d-19a9-08de27c14c99","articleId":"50604e97-56df-4e7e-4964-08de26fe9341","title":"Live chat notifications","tags":["live chat","All articles"],"content":"<html><head></head><body><p>Live chat notifications tell you when a new chat candidate appears, when a chat request has been accepted, or when you have new messages. Learn more about notifications -how they work, how to set them up, and how to troubleshoot if you run into issues.</p>\n<div class=\"mce-toc\">\n<h2>In this article</h2>\n<ul>\n<li><a href=\"#mcetoc_1jacsk40m6nm\">Prerequisites</a></li>\n<li><a href=\"#mcetoc_1jacsk40m6nn\">Types of notification &amp; how to enable them</a>\n<ul>\n<li><a href=\"#mcetoc_1jacsk40m6no\">Push notification</a></li>\n<li><a href=\"#mcetoc_1jacsk40m6nq\">Email notification</a></li>\n</ul>\n</li>\n<li><a href=\"#mcetoc_1jacsk40m6np\">Sound notification</a>\n<ul>\n<li><a href=\"#mcetoc_1jaf6rsjevd\">Enabling notification sounds</a></li>\n<li><a href=\"#mcetoc_1jaf6rsjeve\">Sound behaviour - multiple chats and notifications</a></li>\n</ul>\n</li>\n<li><a href=\"#mcetoc_1jacsk40m6nr\">Troubleshooting tips&nbsp;</a>\n<ul>\n<li><a href=\"#mcetoc_1jacsk40m6ns\">Can't hear any notification sounds</a></li>\n<li><a href=\"#mcetoc_1jacsk40m6nt\">Not receiving system notifications</a></li>\n<li><a href=\"#mcetoc_1jaf6rsjevf\">Receiving duplicate notifications</a></li>\n</ul>\n</li>\n</ul>\n</div>\n<h2 id=\"mcetoc_1jacsk40m6nm\">Prerequisites</h2>\n<ul>\n<li>Helpfruit standard or premium plan (live chat is not available on starter plans)</li>\n<li>Live chat enabled (you can do this <a href=\"https://portal.helpfruit.com/configuration/live-chat\">here</a>)</li>\n</ul>\n<h2 id=\"mcetoc_1jacsk40m6nn\">Types of notification &amp; how to enable them</h2>\n<h3 id=\"mcetoc_1jacsk40m6no\">Push notification</h3>\n<p>Push notifications are available in desktop only. They come in two variations -&nbsp;<br><br></p>\n<ol>\n<li role=\"presentation\"><strong>A notification in the portal</strong>&nbsp;–&nbsp;visible when you have the Helpfruit portal open, as long as you have interacted with the page on first open (eg at the beginning of the day). For example:<br>\n<p>&nbsp;</p>\n<div><img id=\"x_img-2026b688-f177-4c3e-853b-6142a1ab6e2b\" style=\"width: 451px; height: 42px;\" tabindex=\"0\" src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_live-chat-notifications_b4c07457-badc-4463-a6f6-884c4de7a6ef.png\" alt=\"Image\" width=\"451\" height=\"42\" data-outlook-trace=\"F:1|T:1\" data-origin-height=\"42\" data-origin-width=\"451\" data-origin-cid=\"BF99DD46-69A9-4AE9-9D59-B93477D47301\"></div>\n<p>&nbsp;</p>\n</li>\n<li role=\"presentation\"><strong>A system notification</strong> – this notification type is visible even if you don't have the portal open. It's browser specific - you need to have signed up on that browser for it to work. For example:<br>\n<div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_live-chat-notifications_d709cc0c-9f56-4b95-bade-05e18a8ab0a7.png\"></div>\n</li>\n</ol>\n<h4>Enabling push notifications</h4>\n<p>Enable push notifications from your live chat inbox screen -&nbsp;<br><img src=\"https://portal.helpfruit.com/api/images/079d861d72cc4aca80c65588df217079/files/live%20chat%20notifications.png?width=1000&amp;height=\"></p>\n<h3 id=\"mcetoc_1jacsk40m6nq\">Email notification</h3>\n<p>Email notifications, when enabled, are sent to the email address associated with your user account when there's a new live chat candidate.</p>\n<p>Register for e-mail notifications on the live chat inbox screen.</p>\n<p>When you register, you will also see the option to send a test notification.<br><img src=\"https://portal.helpfruit.com/api/images/079d861d72cc4aca80c65588df217079/files/LC%20email%20notification.png?width=1000&amp;height=\"></p>\n<p>&nbsp;</p>\n<h2 id=\"mcetoc_1jacsk40m6np\">Sound notification</h2>\n<p>Notification sounds can be enabled to play when a push notification is received for:</p>\n<ul>\n<li>New chat candidate</li>\n<li>New chat accepted - either by the agent (one step) or the user (two step)</li>\n</ul>\n<h3 id=\"mcetoc_1jaf6rsjevd\">Enabling notification sounds</h3>\n<p>Notification sounds are currently a system admin feature - contact us to enable.</p>\n<p>Once notification sounds are enabled, you can set the duration of each sound on the <a href=\"https://portal.helpfruit.com/configuration/live-chat\">live chat configuration page</a> - anywhere between zero seconds (does not play) and 30 seconds:</p>\n<div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_live-chat-notifications_02f04cb9-d97d-4287-a4c5-a26ce5236f37.png\"></div>\n<div>&nbsp;</div>\n<h3 id=\"mcetoc_1jaf6rsjeve\">Sound behaviour - multiple chats and notifications</h3>\n<p>We only ever play one sound at a time - to avoid clashing sounds and cacophony in the office! Here's what that means in practice:</p>\n<h4>New&nbsp;chat candidate</h4>\n<ul>\n<li>Sound will play for all agents/users with notifications enabled.</li>\n<li>It will continue to play for the duration you have specified in the portal - even after someone clicks on the notification or accepts the chat.</li>\n</ul>\n<h4>Another new chat candidate is received:</h4>\n<ul>\n<li>While another sound is playing? No new sound</li>\n<li>No sound currently playing? New sound plays</li>\n</ul>\n<h4>Agent accepts a chat (or user accepts, in the case of 2-step live chat)</h4>\n<ul>\n<li>While another sound is playing? No new sound</li>\n<li>No sound currently playing? New accept sound plays</li>\n<li>Accept sound may not be required/useful for 1-step live chat. In this case, you can set the duration to zero seconds.</li>\n</ul>\n<h3 id=\"mcetoc_1jacsk40m6nq\"></h3>\n<p>&nbsp;</p>\n<h2 id=\"mcetoc_1jacsk40m6nr\">Troubleshooting tips&nbsp;</h2>\n<h3 id=\"mcetoc_1jacsk40m6ns\">Can't hear any notification sounds</h3>\n<ul>\n<li>Make sure that you have the volume up and headphones unplugged (or on).</li>\n<li>Click anywhere on the portal (this gives the page permission to play audio), then retry.</li>\n<li>Ensure live chat audio is enabled (check with the Helpfruit team if you're not sure) and make sure that the sound duration is &gt; 0.</li>\n<li>Check to make sure that you haven't muted the relevant tab in your browser</li>\n<li>Check that the tab hasn't been put to sleep by the browser - you can adjust settings to keep specific sites active - eg in&nbsp;<a href=\"https://support.google.com/chrome/answer/12929150?hl=en&amp;sjid=7485314430692724002-NC\">Chrome</a></li>\n<li>Notification sounds may not work consistently on Safari - we recommend Chrome or Edge</li>\n</ul>\n<h3 id=\"mcetoc_1jacsk40m6nt\">Not receiving system notifications</h3>\n<ul>\n<li>Make sure that you registered for notifications on the browser you are using. If you are using Chrome, you need to have registered for notifications on Chrome.&nbsp;You can check this on the <a href=\"https://portal.helpfruit.com/agent/queue\">live chat inbox</a> screen, and send a test to make sure. If working correctly you should receive bot a portal and system notification,</li>\n<li>Make sure that portal.helpfruit.com is allowed to send notifications. Learn more: <a href=\"https://support.microsoft.com/en-us/microsoft-edge/manage-website-notifications-in-microsoft-edge-0c555609-5bf2-479d-a59d-fb30a0b80b2b\">Edge</a> | <a href=\"https://support.google.com/chrome/answer/3220216?hl=en&amp;co=GENIE.Platform%3DDesktop\">Chrome</a>&nbsp;</li>\n<li>If you have checked the steps above and are still experiencing delays or occasionally missing system&nbsp;notifications, this may be a limitation of the web push service used to send these notifications.</li>\n<li>Portal notifications are sent using a different service (SignalR) and provide an alternative form of push notification if you find that system notifications are not working reliably.</li>\n</ul>\n<h3 id=\"mcetoc_1jaf6rsjevf\">Receiving duplicate notifications</h3>\n<ul>\n<li>The portal shows the first notification that arrives; if both channels (SignalR and web push) arrive with a delay you may see two. This is expected in rare cases, but should only occur infrequently.</li>\n</ul>\n<p>&nbsp;</p>\n<p>&nbsp;</p></body></html>","description":"Setting up notifications for agents when new live chat requests come in","isMarkdown":false,"publishedOnUtc":"2026-03-21T05:04:54.7773103","modifiedOnUtc":"2025-11-18T23:59:55.9709886"}