SocialHub.AI
Ressources · Centre de développement

Notification push de l'application

Transformez votre application native en canal d'envoi SocialHub. Les membres enregistrent un jeton d'appareil depuis l'espace membre intégré à l'application ; la notification push est alors intégrée au même moteur d'automatisation et de campagne que celui utilisé pour l'envoi de vos e-mails, avec un mécanisme de cascade à tolérance de panne et une limite de fréquence partagée.

L'enregistrement du jeton et la jonction d'envoi sont opérationnels aujourd'hui . Le déploiement effectif se fait progressivement, avec une activation contrôlée par équipe. Demandez à votre équipe SocialHub de l'activer une fois vos identifiants FCM/APNs configurés.

Fonctionnement

Enregistrer un jeton d'appareilEn direct

L'application d'un membre connecté envoie son jeton FCM/APNs via POST. UPSERT idempotent : utilisable en toute sécurité à chaque lancement et lors de la rotation du jeton du système d'exploitation.

La commande Push rejoint la pile d'envoiEn direct

Push est un canal dans le même moteur d'automatisation/campagne que le courrier électronique — et non un API distinct. Un parcours, canal choisi par membre.

Affichage en cascade + une limiteEn direct

Analyse en cascade des notifications (push → email → …) avec une limite de fréquence unique et partagée afin qu'un membre ne reçoive jamais deux messages simultanément sur différents canaux.

Activation de la livraisonDéploiement

L'inscription et la couture d'envoi sont aujourd'hui codées ; La livraison push réelle se déroule derrière un drapeau contrôlé, par équipe. Demandez à votre équipe SocialHub de l'activer.

Enregistrer un jeton d'appareil En direct

Appelez cette fonction depuis l’interface WebView du membre connecté (le cookie de session du consommateur contient l’identité). Consultez le guide Intégration du portail membre pour le flux SSO WebView qui établit cette session.

// The member must be signed in (consumer session cookie, set by the WebView SSO
// flow). teamId + memberId are taken from the SESSION — never the request body —
// so there is no member-enumeration surface here.
POST https://flash.socialhub.ai/api/consumer/push/register
Content-Type: application/json

{
  "platform": "ios",             // "ios" | "android"
  "provider": "fcm",             // "fcm" (default) | "apns"  — optional
  "token": "<device push token>",
  "appBundleId": "com.yourbrand.app"   // optional
}
// → 200  { "ok": true }
//   Idempotent UPSERT keyed on (team, token): re-registering the same device
//   simply re-points it at the current member. Call it on every app launch and
//   whenever the OS rotates the token.

Envoi : la notification push est un canal, pas un appel API

// You do NOT call a "send push" endpoint. Push is a CHANNEL inside the existing
// automation + campaign send stack — the same engine that sends email. When a
// journey or campaign targets a member:
//
//   1. SocialHub resolves the member's channels in a waterfall (fail-open):
//        push (if a token + consent exist)  →  email  →  …
//   2. One SHARED frequency cap applies across channels, so a member is never
//      double-messaged on push AND email for the same step.
//   3. No token / no consent / push disabled  →  silently falls back to email.
//
// Net: you author one journey; SocialHub picks the best channel per member.

Les marketeurs créent la notification push sans coder : une étape Push dans l'interface visuelle de la campagne (à côté de l'e-mail), avec un texte généré par l'IA, les mêmes balises de fusion que pour les e-mails et des modèles de notification push réutilisables. Le contenu créé devient le contenu de la notification push de la campagne et le chemin d'envoi ci-dessus le diffuse ; votre application enregistre uniquement les jetons de l'appareil.

Avant la mise en service

FCM (Android + iOS via Firebase)

Fournissez les identifiants de votre compte de service Firebase à votre équipe SocialHub. L'envoi se fait via FCM HTTP v1 (OAuth via un compte de service) — le fournisseur par défaut.

APN (facultatif, direct)

Si vous envoyez vers iOS directement via des APN, fournissez la clé d'authentification de votre APN (.p8), l'ID de clé et l'ID d'équipe. Enregistrez ces appareils auprès du fournisseur : "apns".

Consentement

L'envoi de notifications push est conditionné par le consentement explicite du membre et le signal du Contrôle global de la confidentialité (fermeture automatique en cas d'échec). Un membre sans consentement push actif est ignoré ; le flux de communication bascule alors vers l'email.

Liste de contrôle d'acceptation

L'enregistrement du même appareil deux fois ne crée pas de doublon : l'UPSERT le redirige vers le membre actuel.

Un membre ayant donné son consentement et possédant un jeton valide reçoit une notification push ; un membre sans jeton ni consentement reçoit un e-mail de secours – jamais rien, jamais les deux.

La révocation du consentement aux notifications push (ou un signal du Contrôle global de la confidentialité) redirige immédiatement le membre vers le canal de communication par e-mail.

Configuration des notifications push ?

Contactez un ingénieur pour obtenir des informations sur les identifiants FCM/APNs, le flux de diffusion ou l'activation de la distribution pour votre équipe.

Parlez à l'ingénierie