Configurer la boîte de réception des messages web

Prérequis

Assurez-vous d’avoir implémenté le SDK Web Pushwoosh sur votre site web. Pour ce faire, veuillez suivre notre guide.

La boîte de réception des messages pour sites web vous permet de stocker les notifications push web afin que les utilisateurs puissent les consulter plus tard, garantissant ainsi que les messages importants sont vus.

Comment ça marche

Voici un flux de travail typique avec InboxMessages :

Étape	Méthode
Chargement de la page
Synchronisation des messages avec le serveur	`InboxMessagesModel.updateMessages` Exécuté pendant l’initialisation du SDK
Suppression des messages obsolètes	`InboxMessagesModel.updateMessages` Exécuté pendant l’initialisation du SDK
Réception du nombre de messages non lus pour mettre à jour un badge	`Pushwoosh.pwinbox.unreadMessagesCount` Exécuté manuellement (après le déclenchement de l’événement `onUpdateInboxMessages`)
Chargement des messages à afficher dans la boîte de réception	`Pushwoosh.pwinbox.loadMessages` Exécuté manuellement (après le déclenchement de l’événement `onUpdateInboxMessages`)
Marquage des messages apparus dans la fenêtre d’affichage comme lus	`Pushwoosh.pwinbox.readMessagesWithCodes` Exécuté manuellement
Exécution d’une action assignée au message ouvert	`Pushwoosh.pwinbox.performActionForMessageWithCode` Exécuté manuellement
Suppression de messages par clic sur une icône de suppression ou par balayage du message vers la droite	`Pushwoosh.pwinbox.performActionForMessageWithCode` Exécuté manuellement

Écouteurs d’événements

// Exécuté après la mise à jour automatique de la boîte de réception pendant le chargement de la page.
Pushwoosh.push(['onUpdateInboxMessages', function(api, pwinbox) {
  pwinbox.loadMessages().then(function(messages) {
    console.log('EVENT: onUpdateInboxMessages', messages);
  });
}]);

// Exécuté par le ServiceWorker après la réception du message de la boîte de réception et son enregistrement dans indexedDB.
Pushwoosh.push(['onPutNewMessageToInboxStore', function(api, message) {
  console.log('EVENT: onPutNewMessageToInboxStore', message);
}]);

Module public

Le module public InboxMessages du WebSDK présente une interface publique pour implémenter la boîte de réception web.

type TInboxMessageTypePlain = 0;
type TInboxMessageTypeRichmedia = 1;
type TInboxMessageTypeURL = 2;
type TInboxMessageTypeDeeplink = 3;
type TInboxMessageType = TInboxMessageTypePlain  // dépend de action_params
  | TInboxMessageTypeRichmedia
  | TInboxMessageTypeURL
  | TInboxMessageTypeDeeplink;


interface IInboxMessagePublic {
  code: string;  // inbox_id
  title: string;  // titre
  message: string; // corps
  imageUrl: string;  // image
  sendDate: string;  // date_envoi
  type: TInboxMessageType;  // dépend de action_params
  isRead: boolean;  // vrai si le statut est "lu" ou "ouvert"
  link: string; // Deeplink | URL | "/"
  isActionPerformed: boolean;  // vrai si le statut est "ouvert"
}

Méthodes publiques

Consultez les descriptions des méthodes publiques dans le guide Web Push SDK 3.0.