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 de souscription présentée aux utilisateurs.

Important

Assurez-vous que le SDK Web Push est correctement intégré à votre site web. C’est une étape obligatoire pour permettre aux utilisateurs de s’abonner et de recevoir des notifications. En savoir plus

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

Configurer les notifications push web pour tous les navigateurs (sauf les anciennes versions de Safari)

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 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 avez déjà des clés VAPID, par exemple de Firebase, et que vous souhaitez continuer à les utiliser sans demander aux utilisateurs de se réabonner.

Créer une nouvelle configuration push

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

Que sont les clés VAPID ?

Les clés VAPID sont une paire de clés publique-privée utilisée dans le protocole Web Push pour authentifier le serveur d’application lors de l’envoi de notifications push aux navigateurs web. La clé publique est partagée avec le navigateur lorsqu’un utilisateur s’abonne aux notifications. La clé privée reste sur votre serveur et est utilisée pour signer de manière sécurisée chaque message que vous envoyez.

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

Utiliser une configuration existante

Si vous avez déjà des 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 cela :

1. Sélectionnez Utiliser une configuration existante.

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

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

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

Comment trouver les clés VAPID dans Firebase

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

Certificat Push Web

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 Push Web du formulaire de configuration web de Pushwoosh.

Clé privée Push Web

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 Push Web.

5. Cliquez sur Appliquer pour enregistrer vos modifications.

Reconfigurer la configuration push web

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, entrez vos nouvelles clés VAPID :

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

3. Cliquez sur Configurer pour enregistrer les modifications.

Important

Le remplacement de vos clés VAPID affecte l’ensemble de votre configuration push web et peut perturber la livraison des notifications s’il n’est pas géré correctement. Ne changez les clés que si c’est vraiment nécessaire, et assurez-vous de bien comprendre l’impact avant de faire des mises à jour.

Configurer l’invite de souscription

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

En raison des récents changements de politique de Chrome et 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 de souscription. Ce widget encourage les utilisateurs à s’inscrire et, en cas d’accord, déclenche l’invite native du navigateur.

Conseil

Une invite bien conçue expliquant la valeur des notifications (par exemple, « Recevez les dernières nouvelles et mises à jour ») peut améliorer considérablement les taux d’inscription.

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

Types d’invites

Il existe deux types d’invites de souscription 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.

Configuration de Safari (macOS 10.14–12)

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 Apple Developer. Cette étape n’est requise que pour ces anciennes versions, car les versions plus récentes de Safari (macOS Ventura et versions ultérieures) prennent en charge la configuration push web standard incluse dans la Configuration pour tous les navigateurs.

Obtenir les identifiants requis d’Apple

1. Allez à la section Certificats, Identifiants & Profils du portail des développeurs Apple.

2. Ajoutez un nouveau certificat.

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

4. Sélectionnez l’ID de notification 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échargez une demande de signature de certificat (CSR). Pour en savoir plus sur la création de demandes de signature de certificat, veuillez consulter l’article d’aide du compte développeur.

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

Note

Le certificat que vous téléchargez depuis Apple est un fichier .cer. Pour obtenir le fichier .p12 nécessaire à la configuration de Pushwoosh, vous devez exporter une clé privée. Voir les détails dans le guide de configuration iOS.

Configurer Safari dans Pushwoosh

1. Cliquez sur Configurer sous Configuration Safari.

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

Nom du site web	Le nom de votre site web qui apparaît dans l’invite de notification push.
Domaines autorisés	Liste des domaines autorisés à demander la permission de notification (un par ligne).
Modèle d’URL	URL ouverte lorsqu’un utilisateur clique sur la notification. Prend en charge des placeholders comme %@ pour insérer des valeurs dynamiques. Exemple : https://yourwebsite.com/%@
Icône du site web	Téléchargez une image PNG carrée (256×256 px). Pushwoosh la redimensionne automatiquement pour différentes interfaces.
Fichier de clé	Téléchargez le certificat .p12 exporté depuis votre compte développeur Apple.
Mot de passe de la clé privée	Mot de passe utilisé lors de l’exportation du fichier .p12.

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.

Important

Lorsqu’un utilisateur est invité à donner son autorisation pour recevoir des notifications push, Safari demande au serveur web de Pushwoosh un paquet push. Le paquet contient des données utilisées par l’interface utilisateur de la notification, telles que le nom et l’icône de votre site web, ainsi qu’une signature cryptographique qui vérifie que votre notification provient d’une source de confiance : vous.

Le paquet push avec tout son contenu est téléchargé UNE SEULE FOIS par chaque utilisateur abonné lors de l’inscription, et ne peut pas être mis à jour de force sur les appareils.

Tenez-en compte lors du lancement des notifications push Safari pour votre site web en production.