Web-Push-Nachrichten

Benutzern, die den Empfang von Web-Push-Nachrichten in den Schnelleinstellungen erlaubt haben, können Sie aus allen Skripten Nachrichten senden:

Dazu muss die Option "Nachrichten akzeptieren" aktiviert sein:

image-20250131133829-1.png

Senden Sie einem einzelnen Benutzer eine Push-Nachricht, indem Sie folgende Zeile in Ihr Skript kopieren und anpassen:

helper.notifyUser(231, "Neues Ticket", "Bitte prüfen", "User-231");

Die Methode helper.notifyUser(Long userId, String title, String message, String topic) nimmt dabei die folgenden Parameter entgegen:

  • userId: Die ID des Empfängers (siehe Benutzerliste)
  • title: Titel der Nachricht
  • message: Der Nachrichtenkörper (einfacher Text)
  • topic: Das Thema der Nachricht. Diese wird dem Empfänger nicht angezeigt, allerdings können Sie Nachrichten mit einem gleichen Thema durch erneutes Senden überschreiben und so vermeiden, dass dem Benutzer zu viele Nachrichten in einer Liste angezeigt werden.

Ähnlich funktioniert die Methode notifyWorkGroup(Long workgroupId, String title, String message, String topic), allerdings wird hier die Nachricht an alle aktiven Mitglieder eines Teams gesendet - sofern sie den Empfang erlaubt haben). Entsprechend wird hier die ID einer Gruppe als erster Parameter angegeben:

helper.notifyWorkGroup(110, "Neues Ticket an Team Messe", "Bitte bearbeiten, "Messe");

Nachricht zu einem Ticket

Wenn Sie einen Mitarbeiter oder alle Mitglieder eines Teams auf ein bestimmtes Ticket hinweisen möchten, benutzen Sie die folgenden Methoden. Mit der Übergabe der Ticket-ID als letzten Parameter erhalten die Benutzer die Möglichkeit, aus der Nachricht heraus mit einem Klick direkt das betreffende Ticket anzeigen zu lassen:

 In der Regel bezieht sich die Nachricht auf das Ticket, das aktuell im betreffenden Skript verarbeitet wird. Insofern wird folgende Zeile durch den Aufruf mit task.id den gewünschten Effekt haben:

helper.notifyUserTicket(231, "Neues Ticket", "Bitte prüfen", "Ticket", task.id);

Wenn Sie auf gleiche Weise alle Mitglieder eines Teams benachrichtigen möchten, benutzen Sie folgenden Code. Dabei wird als Team-ID direkt das adressierte Team des aktuellen Tickets genommen (falls das Ticket an eine Gruppe adressiert wurde). Hier wird auch direkt der Titel des Tickets in die Nachricht übernommen:

if(task.getAddressedWorkgroupId())
    helper.notifyWorkgroupTicket(task.getAddressedWorkgroupId(),
    ,"New Ticket", task.title, "Ticket", task.id);

Auf dem PC eines Nachrichtenempfängers könnte die Nachricht etwa so aussehen:

image-20250131140453-2.png

Mit einem Klick auf "Show Ticket" wird ein neues Browserfenster geöffnet und das betreffende Ticket sofort angezeigt.