SocialHub.AI
Ressources · Centre de développement

Notifications Web Push

Contactez les membres directement dans leur navigateur grâce au protocole Web Push — sans application, sans prestataire tiers payant, sans frais par message. Flash génère automatiquement les clés VAPID de l'espace de travail lors de l'activation, les membres s'abonnent depuis le portail et chaque message est chiffré avec les clés propres à l'abonnement.

Fonctionnement

Norme ouverte, aucun fournisseur

Web Push s'exécute sur le propre protocole Web Push du navigateur via le service Push de chaque navigateur. Il n'y a pas de fournisseur push tiers payant ni de frais par message.

Clés VAPID générées automatiquement

Lors de la première activation, Flash génère pour vous les clés du serveur d'applications VAPID de l'espace de travail – rien à créer, coller ou faire pivoter à la main.

Inscription initiée par les membres

Les membres s'abonnent eux-mêmes depuis la page de confidentialité du portail. L'accès est conditionné par l'autorisation du navigateur : sans autorisation, pas d'abonnement.

Cryptage par abonnement

Chaque contenu push est chiffré avec les clés de l’abonnement (chiffrement des messages RFC 8291), de sorte que seul le navigateur de l’abonné peut le lire.

Activez-le (administrateur)

Un administrateur active les notifications push web pour l'espace de travail. Aucune clé n'est à générer : Flash crée la paire de clés VAPID pour le serveur d'application lors de la première activation.

// Admin enables web push for the workspace in Settings → Web Push.
// On first enable, Flash GENERATES the VAPID application-server keypair automatically —
// you don't create or paste keys. You set a contact email and can fire a test send.
//
//   Settings → Web Push:
//     • Enable web push            (OFF by default, per workspace)
//     • Contact email              (identifies the sender to the browser push services)
//     • Send test notification     (verify the end-to-end path)
//
// The public VAPID application server key is what the member's browser uses when it
// creates a push subscription (below).

Parcours d'abonnement des membres

Le navigateur du membre crée l'abonnement avec la clé VAPID publique de l'espace de travail ; le portail le publie sur Flash. Consultez le guide Intégrer le portail des membres pour connaître la session consommateur connectée sur laquelle cela repose.

// Members subscribe THEMSELVES from the member portal privacy page. The web-push card
// only renders when (a) the browser supports the Push API AND (b) the workspace enabled
// web push. Tapping it triggers the browser's native permission prompt.
//
//   1. Portal registers a service worker.
//   2. Browser creates a PushSubscription using the workspace's public VAPID key
//      (Notification.requestPermission() → pushManager.subscribe(...)).
//   3. The portal posts that subscription (endpoint + p256dh + auth keys) to Flash:
POST https://flash.socialhub.ai/api/member/web-push
Content-Type: application/json

{
  "endpoint": "<browser push service endpoint>",
  "keys": { "p256dh": "<client public key>", "auth": "<client auth secret>" }
}
// → 200  { data: { ok: true } }
//   GET  https://flash.socialhub.ai/api/member/web-push   → the workspace public key + whether web push is on
//   DELETE https://flash.socialhub.ai/api/member/web-push  { "endpoint": "..." }  → unsubscribe
//   The member identity comes from the signed-in member session — never the body.

Livraison : un canal, pas un appel API

// You do NOT call a "send web push" endpoint directly. Web push is a CHANNEL in the
// same send/automation stack as email and app push. When a campaign or journey targets
// a subscribed member:
//
//   • Flash encrypts the payload to that member's subscription keys (RFC 8291) and
//     hands it to the member's own browser push service for delivery.
//   • Subscriptions that the push service reports as gone/expired are pruned
//     automatically, so you don't keep sending into dead endpoints.

Bon à savoir

Fonctionne avec les navigateurs modernes compatibles avec les notifications push API et les service workers : le portail propose uniquement le formulaire d’inscription lorsque le navigateur le prend en charge, afin que les membres ne voient jamais un canal incompatible avec leur navigateur.

Désactivé par défaut et par espace de travail : aucune donnée n'est envoyée tant qu'un administrateur ne l'a pas activé et qu'un membre ne l'a pas accepté via son navigateur.

Les clés de l'abonnement sont fournies par le navigateur du membre ; Flash les stocke pour chiffrer chaque message et ne les partage jamais entre les espaces de travail.

Connexe : App Push · Intégration du portail des membres · Conformité et consentement API

Configuration des notifications push web ?

Parlez à un ingénieur du flux d'abonnement service-worker + VAPID, de la pile de canaux d'envoi ou du cryptage des messages par abonnement.

Parlez à l'ingénierie