Web Message Inbox einrichten

Voraussetzungen

Stellen Sie sicher, dass Sie das Pushwoosh Web SDK auf Ihrer Website implementiert haben. Befolgen Sie dazu bitte unsere Anleitung.

Die Message Inbox für Websites ermöglicht es Ihnen, Web-Push-Benachrichtigungen zu speichern, damit Benutzer sie später erneut aufrufen können, um sicherzustellen, dass wichtige Nachrichten gesehen werden.

Wie es funktioniert

Hier ist ein typischer Arbeitsablauf mit InboxMessages:

Schritt	Methode
Seitenaufbau
Synchronisieren von Nachrichten mit dem Server	`InboxMessagesModel.updateMessages` Wird ausgeführt, während das SDK initialisiert wird
Löschen veralteter Nachrichten	`InboxMessagesModel.updateMessages` Wird ausgeführt, während das SDK initialisiert wird
Empfangen der Anzahl ungelesener Nachrichten zur Aktualisierung eines Abzeichens	`Pushwoosh.pwinbox.unreadMessagesCount` Manuell ausgeführt (nachdem das `onUpdateInboxMessages`-Ereignis ausgelöst wird)
Laden von Nachrichten, die in der Inbox angezeigt werden sollen	`Pushwoosh.pwinbox.loadMessages` Manuell ausgeführt (nachdem das `onUpdateInboxMessages`-Ereignis ausgelöst wird)
Markieren von Nachrichten im Ansichtsbereich als gelesen	`Pushwoosh.pwinbox.readMessagesWithCodes` Manuell ausgeführt
Ausführen einer Aktion, die der geöffneten Nachricht zugewiesen ist	`Pushwoosh.pwinbox.performActionForMessageWithCode` Manuell ausgeführt
Löschen von Nachrichten durch Klicken auf ein Löschsymbol oder Wischen einer Nachricht nach rechts	`Pushwoosh.pwinbox.performActionForMessageWithCode` Manuell ausgeführt

Event-Listener

// Wird ausgeführt, nachdem die Inbox beim Laden der Seite automatisch aktualisiert wurde.
Pushwoosh.push(['onUpdateInboxMessages', function(api, pwinbox) {
  pwinbox.loadMessages().then(function(messages) {
    console.log('EVENT: onUpdateInboxMessages', messages);
  });
}]);

// Wird vom ServiceWorker ausgeführt, nachdem die Inbox-Nachricht empfangen und in indexedDB gespeichert wurde.
Pushwoosh.push(['onPutNewMessageToInboxStore', function(api, message) {
  console.log('EVENT: onPutNewMessageToInboxStore', message);
}]);

Öffentliches Modul

Das WebSDK InboxMessagesPublic-Modul stellt eine öffentliche Schnittstelle zur Implementierung der Web Inbox bereit.

type TInboxMessageTypePlain = 0;
type TInboxMessageTypeRichmedia = 1;
type TInboxMessageTypeURL = 2;
type TInboxMessageTypeDeeplink = 3;
type TInboxMessageType = TInboxMessageTypePlain  // hängt von action_params ab
  | TInboxMessageTypeRichmedia
  | TInboxMessageTypeURL
  | TInboxMessageTypeDeeplink;


interface IInboxMessagePublic {
  code: string;  // inbox_id
  title: string;  // title
  message: string; // body
  imageUrl: string;  // image
  sendDate: string;  // send_date
  type: TInboxMessageType;  // hängt von action_params ab
  isRead: boolean;  // true, wenn der Status "read" oder "open" ist
  link: string; // Deeplink | URL | "/"
  isActionPerformed: boolean;  // true, wenn der Status "open" ist
}

Öffentliche Methoden

Die Beschreibungen der öffentlichen Methoden finden Sie in der Anleitung zum Web Push SDK 3.0.