Communications
Messages affichés au dos des passes et notifiés aux porteurs.
Créer une communication
Crée une communication (offre) affichée sur la carte de fidélité de tous les porteurs du wallet : un visuel `strip` remplace la bannière de la carte et la `description` s'ajoute au verso. Elle est publiée tout de suite avec `instant: true`, sinon à `startDate`, et dure jusqu'à `endDate` ou sans fin avec `unlimited: true`. Renvoie la communication créée.
Lister les communications
Liste paginée des communications du wallet, filtrables par statut, par plage de dates de début et par recherche texte sur la description.
Mettre à jour une communication
Met à jour une communication : texte, visuel, dates ou statut (`EXPIRED` n'est pas accepté). Si la communication est en ligne, la carte est mise à jour et les porteurs sont notifiés. Renvoie la communication mise à jour.
Supprimer une communication
Supprime définitivement une communication. Si elle était en ligne (`ACTIVE`), la carte de fidélité retrouve son visuel d'origine et les porteurs sont notifiés de la fin de l'offre. Renvoie la communication supprimée.
Obtenir une communication
Renvoie une communication par son identifiant, avec son statut, ses dates et la clé de son visuel `strip`.
Activer ou désactiver une communication
Active (`ACTIF`) ou désactive (`INACTIF`) une communication sans modifier son contenu. L'activation la met en ligne sur la carte de fidélité ; la désactivation d'une communication en ligne rétablit le visuel d'origine de la carte.
Obtenir les statistiques d'envoi d'une communication
Statistiques de remise de la notification push d'une communication, par porteur de carte de fidélité active (avec son e-mail et son téléphone), paginées, avec un résumé du taux de réussite global et par plateforme (iOS, Android). Le résumé indique aussi le statut de la communication et sa prochaine échéance (début ou fin).