Configuration des notifications push web

Pour commencer à envoyer des notifications push web avec Pushwoosh, vous devez configurer votre plateforme de push web et activer l’invite d’abonnement présentée aux utilisateurs.

Pour commencer la configuration, allez dans Paramètres > Configuration de la plateforme > Notifications push web et cliquez sur Configurer.

Cette configuration s’applique à tous les navigateurs modernes, y compris les dernières versions de Safari, qui prennent désormais en charge les notifications push web de manière native.

Remarque : Les anciennes versions de Safari (macOS 10.14–12) nécessitent une configuration distincte. Vous pouvez la configurer dans une section dédiée. En savoir plus

Pour commencer la configuration, cliquez sur Configurer sous Configuration pour tous les navigateurs.

Dans la fenêtre de configuration, choisissez l’une des options suivantes :

• Créer une nouvelle configuration de push
  Recommandé si vous n’avez jamais configuré de notifications push web via un autre service. Pushwoosh générera automatiquement une nouvelle paire de clés VAPID.

• Utiliser une configuration existante
  Choisissez cette option si vous disposez déjà de clés VAPID, par exemple de Firebase, et que vous souhaitez continuer à les utiliser sans demander aux utilisateurs de se réabonner.

Choisissez Créer une nouvelle configuration de push si vous n’avez jamais configuré de notifications push web avec un autre service. Pushwoosh générera automatiquement pour vous les clés VAPID (Voluntary Application Server Identification) requises.

Cliquez sur Configurer pour générer et appliquer les clés.

Une fois créées, Pushwoosh utilisera automatiquement ces clés dans la configuration du SDK. En savoir plus sur l’intégration du SDK Web Push

Si vous disposez déjà de clés VAPID (comme celles générées via Firebase), vous pouvez les réutiliser pour configurer les notifications push web dans Pushwoosh.

Pour ce faire :

1. Sélectionnez Utiliser une configuration existante.

2. Dans le champ Certificat Web Push, saisissez votre clé publique VAPID.

3. Dans le champ Clé privée Web Push, saisissez votre clé privée VAPID.

4. Cliquez sur Configurer pour enregistrer et appliquer les paramètres.

Si vous migrez depuis Firebase et avez besoin de réutiliser vos clés VAPID existantes, suivez ces étapes pour les trouver.

1. Dans Firebase, naviguez vers Paramètres du projet → Cloud Messaging.
2. Faites défiler jusqu’à la section Configuration Web et copiez la paire de clés existante.

3. Collez-la dans le champ Certificat Web Push du formulaire de configuration web de Pushwoosh.

1. Dans la console Firebase, allez dans Paramètres du projet → Cloud Messaging → Configuration Web.
2. Cliquez sur le menu à trois points sous Actions à côté de la paire de clés et sélectionnez Afficher la clé privée. Cette clé est essentielle pour garantir le bon fonctionnement des notifications push web.

3. Copiez la clé affichée dans votre presse-papiers.

4. Dans le formulaire de configuration Web de Pushwoosh, collez-la dans le champ Clé privée Web Push.

5. Cliquez sur Appliquer pour enregistrer vos modifications.

Si vous avez déjà configuré les notifications push web mais que vous devez mettre à jour vos identifiants (comme remplacer vos clés VAPID), voici comment procéder :

1. Cliquez sur Reconfigurer sous Configuration pour tous les navigateurs.

2. Dans la fenêtre contextuelle qui apparaît, saisissez vos nouvelles clés VAPID :

• Certificat Web Push : votre nouvelle clé publique VAPID
• Clé privée Web Push : votre nouvelle clé privée VAPID

3. Cliquez sur Configurer pour enregistrer les modifications.

Pour envoyer des notifications push, les utilisateurs doivent donner explicitement leur autorisation via l’invite système du navigateur. Sans cette autorisation, les notifications ne peuvent pas être distribuées.

En raison des récentes modifications des politiques de Chrome et de Firefox, la fenêtre contextuelle d’autorisation native ne peut apparaître qu’après que l’utilisateur a interagi avec la page (par exemple, en cliquant sur un bouton). Pour répondre à cette exigence, Pushwoosh affiche par défaut un widget d’invite d’abonnement. Ce widget encourage les utilisateurs à s’inscrire et, s’ils acceptent, déclenche l’invite native du navigateur.

Pour personnaliser le texte et l’apparence de l’invite, cliquez sur Paramètres.

Il existe deux types d’invites d’abonnement disponibles :

• Widget par défaut
  Fourni par Pushwoosh et affiché automatiquement. Apprenez à personnaliser le widget par défaut.

• Widget personnalisé.
  Utilisez votre propre design de widget. En savoir plus

Remarque : En raison des limitations de la plateforme, les modifications apportées au widget peuvent prendre jusqu’à 30 minutes pour apparaître. Si les modifications ne sont pas répercutées, contactez l’équipe de support de Pushwoosh.

Pour prendre en charge les notifications push sur les anciennes versions de Safari (macOS 10.14–12), vous devez effectuer un processus de configuration distinct en utilisant vos identifiants de développeur Apple. Cette étape n’est requise que pour ces anciennes versions, car les versions plus récentes de Safari (macOS Ventura et ultérieures) prennent en charge la configuration standard de push web incluse dans la Configuration pour tous les navigateurs.

1. Allez à la section Certificats, identifiants et profils du portail des développeurs Apple.

2. Ajoutez un nouveau certificat.

3. Choisissez le type Certificat d’ID de push de site web et cliquez sur Continuer.

4. Sélectionnez l’ID de push de site web - votre chaîne de domaine inversée unique, telle que web.com.example.domain (doit commencer par web.).

5. Téléversez une demande de signature de certificat. Pour en savoir plus sur la création de demandes de signature de certificat, veuillez vous référer à l’article d’aide du compte développeur.

6. Ensuite, téléchargez le certificat de notification push.

1. Cliquez sur Configurer sous Configuration Safari.

2. Remplissez les champs suivants dans le formulaire de configuration :

3. Cliquez sur Configurer pour enregistrer vos modifications.

Pushwoosh générera automatiquement le paquet push avec l’ensemble d’icônes, le dictionnaire JSON du site web et le fichier manifeste que Safari demande au serveur. Vous pouvez le télécharger quand vous en avez besoin.