Notificaciones push de la app
Convierta su app nativa en un canal de envío de SocialHub. Los miembros registran un token de dispositivo desde el centro de miembros de la app; la notificación push se integra con el mismo motor de automatización y campaña que envía sus correos electrónicos, con una cascada de canales de apertura automática y un límite de frecuencia compartido.
El registro de tokens y la integración de la pila de envío ya están disponibles en el código. La entrega real de notificaciones push se implementa tras una activación controlada por equipo. Solicita a tu equipo de SocialHub que la active una vez que hayas configurado tus credenciales de FCM/APNs.
Cómo funciona
Registrar un token de dispositivoEn vivo
La aplicación de un miembro que ha iniciado sesión envía su token FCM/APNs mediante POST. Se trata de una operación UPSERT idempotente: se puede realizar con seguridad en cada inicio y durante la rotación del token del sistema operativo.
Push se une a la pila de envíoEn vivo
Push es un canal en el mismo motor de automatización/campaña que el correo electrónico, no un API independiente. Un viaje, canal elegido por miembro.
Cascada de canal + una tapaEn vivo
Cascada de aperturas por fallo (notificación push → correo electrónico → …) con un límite de frecuencia compartido para que ningún miembro reciba mensajes duplicados en diferentes canales.
Gestión de la entregaImplementación
El registro y la costura de envío están hoy en código; La entrega de empuje real se realiza detrás de una bandera controlada, por equipo. Pídele a tu equipo de SocialHub que lo habilite.
Registrar un token de dispositivo En vivo
Llama a esta función desde la WebView del miembro que ha iniciado sesión (la cookie de sesión del consumidor contiene la identidad). Consulta la guía Inserción del portal de miembros para ver el flujo de SSO de la WebView que establece dicha sesión.
// 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.Envío: la notificación push es un canal, no una llamada 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.Los especialistas en marketing crean la notificación push sin código: un paso de Push en el lienzo visual de la campaña (junto a Correo electrónico), con texto generado por IA, las mismas etiquetas de combinación que el correo electrónico y plantillas de push reutilizables. El contenido que creen se convierte en el contenido de la notificación push de la campaña y la ruta de envío anterior lo entrega; su aplicación solo registra los tokens del dispositivo.
Antes de la puesta en marcha
FCM (Android + iOS a través de Firebase)
Proporcione las credenciales de su cuenta de servicio de Firebase a su equipo de SocialHub. El envío se realiza a través de FCM HTTP v1 (OAuth a través de una cuenta de servicio), el proveedor predeterminado.
APN (opcional, directo)
Si envía a iOS directamente a través de APN, proporcione su clave de autenticación de APN (.p8), ID de clave e ID de equipo. Registre esos dispositivos con el proveedor: "apns".
Consentimiento
Las notificaciones push están restringidas por el consentimiento explícito del miembro, además de la señal de Control de Privacidad Global (fallo: cerrado). Un miembro sin consentimiento activo para notificaciones push se omite; la cascada recurre al correo electrónico.
Lista de verificación de aceptación
Registrar el mismo dispositivo dos veces no crea un duplicado: UPSERT lo redirige al miembro actual.
Un miembro que ha dado su consentimiento y tiene un token válido recibe una notificación push; un miembro sin token/consentimiento recibe el correo electrónico de respaldo, nunca ninguno, nunca ambos.
Revocar el consentimiento para notificaciones push (o una señal de Control de Privacidad Global) redirige inmediatamente al miembro al canal de correo electrónico.
¿Configurando notificaciones push?
Hable con un ingeniero sobre las credenciales de FCM/APN, la cascada del canal de envío o cómo habilitar la entrega para su equipo.
hablar con ingenieria