New event `messageNotification`

dist/converse.js

@@ -55920,6 +55920,8 @@ _converse_headless_converse_core__WEBPACK_IMPORTED_MODULE_0__["default"].plugins
         return false;
       }
 
+      _converse.api.emit('messageNotification', message);
+
       _converse.playSoundNotification();
 
       _converse.showMessageNotification(message);

docs/source/events.rst

@@ -259,6 +259,22 @@ as a `message` attribute which refers to the Message model.
         // The original chatbox is at `data.chatbox`.
     });
 
+
+messageNotification
+~~~~~~~~~~~~~~~~~~~
+
+Emitted just before an HTML5 message notification will be sent out.
+
+.. code-block:: javascript
+
+    _converse.api.listen.on('messageNotification', stanza => {
+
+        const body = sizzle(`encrypted[xmlns="${Strophe.NS.OMEMO}"]`, message).length ?
+                        __('OMEMO Message received') :
+                        _.get(message.querySelector('body'), 'textContent');
+        alert(body);
+    });
+
 messageSend
 ~~~~~~~~~~~
 

src/converse-notification.js

@@ -261,6 +261,7 @@ converse.plugins.add('converse-notification', {
             if (!_converse.shouldNotifyOfMessage(message)) {
                 return false;
             }
+            _converse.api.emit('messageNotification', message);
             _converse.playSoundNotification();
             _converse.showMessageNotification(message);
         };